or perhaps better
I wanted to make contributing to this documentation as easy as possible.
That's why I use Markdown. Developers use it, but is just writing in plane English so everybody can write documentation!
And this documentation hosted on Github, developers favorite place to store code.
Even if you are not a developer. Don't want to clone everything, you still can change the files on the website (you need account to login in and change the
And as a final resort, you can leave your comments/suggestions/etc at the bottom of the page via Disqus.
Visit https://github.com/MatthijsKamstra/haxejs to change the "source" aka markdown files.
Found any "bug" or have a great idea? Please create a new issue.
There are a couple places you can go for "how to start with ...":
- Different blog posts from individual developers
And they are good.... but:
- Basic, one example, or too in-depth
- Difficult to contribute (ownership)
- All over the place
How to improve on this:
- Add more simple, easy to start with examples
- Simple how to start with Haxe
- Simple and basic code examples
- Move to more difficult examples
- I don't mind copy/paste examples (see point 3, but with permission of the writer if its done in a post)
- Make contributing as-easy-as-possible
- I hope Markdown will help with the writing
- I hope Github will help with contributing/easy access
- And exporting to static html is not necessary if you are not up for that (I guess that I will do that)
- One place for code and website hosting
- I hope the
gh-pageswill be THE place to go to for more info
- I hope the
Every new tutorial should have:
+ foldername (use common sense) + code (folder with code examples) | + bin | + src | | - Main.hx | - build.hxml - about.md (short description what it will do) - install.md (is there something you need to install) - example.md (javscript.hxml, Main.hx, how to build, etc)
I thought I was the first to try to write documentation and open-sourcing it this way, but other beat me. Although I was already writing everything with markdown, it looked like a good idea to use Gitbook to "publish" it. Writing documentation is like writing a book.
Other clever developers who had this idea before me:
If you got to this part of the contribute file, GREAT! Although I hope this project will run on contributions of other, the internet is kinda negative about it...
It seems that I am on of the 1%!