Ask HN: Continues documentation for Github?
1 comments
Which languages do you use?
There's a wide variety of options: Doxygen for C, PHPDocumentor for PHP, literate tools for Ruby and Coffee, etc.
If you describe your software using email, why can't you write the same docs on github using Markdown?
Usually I use JavaScript and Python. I don't have problem with software, I know the correct tools for generating the doc from my code as well.
But the problem is that HOW can I integrate it with Github so after each sync/push on the Github repository, document generated automatically from code also?
What about generating a wiki from the code documentation, and then uploading that to the Wiki section of your Git repository?
It would be useful also. Do you know any method for doing that?
well a quick "goog" brings up this: http://code.google.com/p/doxygen2gwiki/
My main problem is with contributors and the projects is that when a new contributor come and ask me about the project, I have to describe whole project, methods, functions and... to him/her. That just waste my time.
I need a system that read my code from repository and build my code documentation (using document generating tools, Doxygen etc.) after each commit, so I have my updated document always and I can refer all new contributors to this document...
Does anyone know a system/solution like that?