On Jun 8, 2010, at 5:39 PM, Igor Filippov [Contr] wrote:

> the question put to a vote I would vote "No" without reservations.
> It's not a democracy though, is it? :)

Well, like politicians, a successful open source project needs to be responsive 
to its users. :-)

I think there are two classes of documentation:
1) Developer-level docs (e.g., tutorials, API, etc.). I think doxygen or a 
similar generator works OK here, particularly for code documentation. Consider, 
for example, Qt or even Apple or Microsoft's developer documentation. These are 
generated automatically. We should be doing much better, and I agree with 
Noel's comments that we should be generating nightly updates.

2) User-level tutorials. 

> have already been implemented. This is very frustrating as well.
> If it's not in the latest stable release it shouldn't be described as
> available.

For me, the take-home message is that we need to get 2.3 released ASAP or 
sooner.

-Geoff
------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate 
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the 
lucky parental unit.  See the prize list and enter to win: 
http://p.sf.net/sfu/thinkgeek-promo
_______________________________________________
OpenBabel-Devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/openbabel-devel

Reply via email to