Vladimir Zhbanov wrote: > On Wed, Sep 07, 2011 at 10:51:31PM +0200, Kai-Martin Knaak wrote: >> I am close to start off a gEDA wikibook (http://en.wikibooks.org). >> Would you join the effort?
> How about updating the existing wiki documentation? Reasons to go for wikibooks: a) IMHO, it is good practice to have a user manual completely separate from documentation of features, formats and APIs. While the latter has to be complete, comprehensive and super correct, the former should focus on ease of use. These are conflicting goals. Think automatic extraction from the source versus a) wikibooks provides a full fledged environment geared toward cooperative work on text documents. It comes with all the communication features you need (discussion page associated with each content page, user discussion, email). b) mediawiki syntax is rich in features and proven to work for large groups of authors. c) There is a host of howtos and help pages for each and every feature that mediawiki delivers. d) There are versions in many languages. This is good for translation. e) The entry barrier is as low as it can get. If general readers spot a glitch, they can press the edit button correct the error and are done. This provides a opportunity to foster participation of more users. Compare this to the circumstances inside the geda project. You need to send an email to an admin to even see the edit buttons in the gpleda-wiki. Changes to the pcb manual require git patches and an approval by core devs like changes to the code in git-head. Given the consistent tendency toward more wall-in over the years, I don't expect this attitude to change anytime soon. f) The geda devs have no more say in what goes in a wiki book, than any other user. g) There is a kicad wikibook. http://en.wikibooks.org/wiki/Kicad ---<)kaimartin(>--- -- Kai-Martin Knaak, Email: k...@familieknaak.de http://pool.sks-keyservers.net:11371/pks/lookup?search=0x6C0B9F53 Moderation of geda-user seems to be lifted somewhat, lately. I am still unhappy with it. Why? Because it is completely nontransparent. _______________________________________________ geda-user mailing list geda-user@moria.seul.org http://www.seul.org/cgi-bin/mailman/listinfo/geda-user
