Re: gEDA-user: gEDA Wikibook ? (was: Toporouter crashing in GIThead on seemingly simple circuits)

["Bert Timmerman" <bert.timmerman@xxxxxxxxx>]

Hi KMK, 

> -----Original Message-----
> From: geda-user-bounces@xxxxxxxxxxxxxx 
> [mailto:geda-user-bounces@xxxxxxxxxxxxxx] On Behalf Of 
> kai-martin knaak
> Sent: Thursday, December 23, 2010 1:08 PM
> To: geda-user@xxxxxxxx
> Subject: Re: gEDA-user: gEDA Wikibook ? (was: Toporouter 
> crashing in GIThead on seemingly simple circuits)
> 
> Bert Timmerman wrote:
> 
> > Why not create a wikibook ?
> 
> Great idea!
> I am in for starting such a book.
> Also count me in for tips and tricks of wikipedia formating.
> My "other" computer activity is the physics department in 
> German wikipedia... 
> 
> Of course, a wikibook can't replace the pcb manual. Important 
> parts of the manual are automatically derived from source comments. 
> 
>  
> ---<)kaimartin(>---
> --
> Kai-Martin Knaak
> Öffentlicher PGP-Schlüssel:
> http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x6C0B9F53
> 
> 

<Just MHO>

I don't think it's a Good Thing (TM) that a User Manual is derived from
source code files, for this would require a person with gEDA-dev priviliges
to push changes into the git repository.

This workflow raises the threshold to contribute to user documentation and
adds to the burden of the gEDA-devs (they have ample time for reviewing
patches).

In the past we have __had__ an experiment with noweb for gaf (past tense for
good reasons), I'd rather keep things simple.

If documentation needs to be generated from source code files let it just be
(API reference) docs for (future/newbie) gEDA-devs and use Doxygen in pcb
too (for obvious reasons).

</MHO>

Kind regards,

Bert Timmerman.




_______________________________________________
geda-user mailing list
geda-user@xxxxxxxxxxxxxx
http://www.seul.org/cgi-bin/mailman/listinfo/geda-user