Em Qui, 2013-10-31 às 00:48 +0900, Carsten Haitzler escreveu:
> this is simply a matter of time. spend 1hr adding a feature someone
> wants, or 1
> hr writing docs.
Documentation is a feature too.
> i personally use docs as reference only - i ALWAYS use example
> codee. nothing to do with java - it simply is faster, easier and more
> practical.
Documentation can include snippets.
> i read unix man pages to begin with and frankly they told me very
> little at all. a whole tonne of words for very little use. examples
> taught me
> 100x more in the same amount of effort with docs backing it up as
> reference.
Comparing manpages with HTML rich (or even PDFs) docs.
* Manpages cannot have images (maybe with Terminology this is no
longer true) and for a GUI toolkit this is kind of a must.
* Manpages don't have an easily browsable content (like HTML) have
* Summary
* Detailed description and extra sections
* Extra pages (not directly related to one class only)
* A small text for each function
> as such most of efl does have docs. they are not voluminous essays.
> again - a
> matter of time. if you wish to contribute by writing voluminous docs..
> go for
> it. :)
The magic of open source. :)
--
Vinícius dos Santos Oliveira
https://about.me/vinipsmaker
------------------------------------------------------------------------------
Android is increasing in popularity, but the open development platform that
developers love is also attractive to malware creators. Download this white
paper to learn more about secure code signing practices that can help keep
Android apps secure.
http://pubads.g.doubleclick.net/gampad/clk?id=65839951&iu=/4140/ostg.clktrk
_______________________________________________
enlightenment-users mailing list
enlightenment-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-users
