Page 4 of 7

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Sun Feb 08, 2015 20:14
by rubenwardy
A small announcement, the repo has been renamed to /minetest_modding_book/ (from /minetest_doc/). You should correct any links, however it doesn't matter, I've set up redirects. It is also being hosted on rubenwardy.com rather than rubenwardy.github.io, but that redirects too.

I have also fixed some typos and clarified things in node drawtypes. Not finished yet, though. I need nice renders of drawtypes. (see existing images)

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Thu Feb 12, 2015 07:36
by false_chicken
This played an essential role in teaching me to mod Minetest. Thanks rubenwardy! Great stuff here.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Thu Feb 19, 2015 15:34
by rubenwardy
The folder structure chapter has been partially rewritten. All the examples in the book can downloaded or browsed in the GitHub branch. A feedback form is now on the homepage, to allow easier reporting of issues. I will be going through all the chapters and correcting mistakes tonight. Expect more chapters this week. I'm open to suggestions.

I'd love more contributors to this book.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Sat Feb 21, 2015 01:50
by false_chicken
It would be awesome if this could be exported to EPUB. Probably not worth the work but I would enjoy it xD.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Sat Feb 21, 2015 15:17
by Amaz
One epub conversion here! https://www.dropbox.com/s/qv730im2vidmy ... .epub?dl=0

I'm not really sure what this is like on an e-reader (I presume that is why you wanted it!), but it should work alright.
It wasn't that hard to make, and I'm sure that there are easier ways than what I did...

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Fri Mar 20, 2015 23:08
by Don
This book is a great resource. Thanks again for your hard work.
Was wondering if you are planning on doing any chapters on methods and objects?

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Apr 13, 2015 04:58
by Don
Just noticed that you do not have a section on adding sound.
Any chance of you adding a chapter on it. The wiki has a bit but I know there is more to sound then what the wiki says.
I have come to rely on your book and appreciate it very much.
Thanks for everything you do.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Apr 13, 2015 05:10
by prestidigitator
MediaWiki also uses a form of markdown. Have you considered publishing the book to the developer wiki? That's already the modders' go-to reference, allows easy linking to API elements you are describing in the text, etc. I love the effort, but it'd be nice to have all of this type of thing in one place.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Apr 13, 2015 07:09
by rubenwardy
The rationale behind using a separate system:
  • Dictatorship. I can get to control what goes in. Spelling mistakes don't matter as much as lack of clarity and poor grammar. People on wikis seem to add irrelevant details which the reader doesn't need to know at that stage in learning.
  • Clean downloading as static HTML.
Typos do exist in the book, but nobody ever submits PRs to change this. It's probably because it's not worth git cloning, etc, just for a small change. A wiki would solve this. There has also been no help from others.

As for the argument about linking to dev wiki pages, I hadn't considered doing this. I'd like the book to link to more resources, and that's on the to do list.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Apr 13, 2015 08:45
by twoelk
rubenwardy wrote:...
There has also been no help from others.
...
and yet we are lurking with interest ;-P

good job so far

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Apr 13, 2015 12:36
by Don
The dev wiki is a great resource but I find that it is written for programmers. People like myself need a tutorial that we can understand. This book does exactly that.
I have seen the spelling mistakes and I ignore them. Maybe I should help with that.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Apr 13, 2015 21:26
by prestidigitator
Don wrote:The dev wiki is a great resource but I find that it is written for programmers. People like myself need a tutorial that we can understand. This book does exactly that.
Right. Well, that's why I think it would be good to add things to the wiki that aren't written just for programmers. To improve it, and make it more useful for all.

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Mon Jul 27, 2015 15:32
by wintermute
You are encouraged use to my MinetestIDE in your book, its cross platform and makes the whole experience smoother.
Forum link: viewtopic.php?f=14&t=12923

Re: Modding Tutorial Book - Creating Better Documentation

Posted: Fri Sep 25, 2015 19:41
by rubenwardy
New Chapters:
  • Creating Textures
  • Node Metadata
  • Chat and Commands
  • ItemStacks
  • Read More (list of resources)
Corrected multiple typos, grammatical and spelling mistakes.

Read Now | Download for offline use

Re: Modding Tutorial Book (new: ItemStacks, Metadata, more)

Posted: Fri Sep 25, 2015 19:50
by Don
You are awesome!

Re: Modding Tutorial Book (new: ItemStacks, Metadata, more)

Posted: Sat Nov 21, 2015 17:09
by rubenwardy
Added Inventories chapter.

Download

Re: Modding Tutorial Book (new: Inventories)

Posted: Sun Nov 22, 2015 16:50
by rubenwardy
Added loads more anchor links to lua_api.html

Commit 47880

Re: Modding Tutorial Book (new: Inventories)

Posted: Tue Jan 05, 2016 19:41
by Evergreen
The link to the online version of the book no longer works.

Re: Modding Tutorial Book (new: Inventories)

Posted: Tue Jan 05, 2016 20:42
by rubenwardy

Re: Modding Tutorial Book (new: Inventories)

Posted: Tue Jan 05, 2016 20:55
by rubenwardy
It may also be because I moved to www.rubenwardy.com from rubenwardy.com

Re: Modding Tutorial Book (new: Inventories)

Posted: Tue Jan 05, 2016 21:13
by rubenwardy
Fixed, I think.

RE: Modding Tutorial: THANK YOU!!!

Posted: Wed Feb 10, 2016 15:34
by Arcelmi
Thank you for this tutorial!

Re: Modding Tutorial Book (new: Inventories)

Posted: Thu Feb 11, 2016 12:43
by KCoombes
Typo:

Wear
ItemStacks also have wear on them. Wear is a number out of 65535, the higher is more warn.

worn, not warn

Re: Modding Tutorial Book (new: Inventories)

Posted: Fri Apr 08, 2016 18:58
by TheReaperKing
Thank so much for your tutorial! I plan to use at school with the kiddos!

Re: Modding Tutorial Book (new: Inventories)

Posted: Fri Apr 15, 2016 22:58
by TumeniNodes
It has definitely been a really big help for me as well. Thank you very much.