sm-discuss AT lists.ibiblio.org
Subject: Public SourceMage Discussion List
List archive
- From: flux <flux AT sourcemage.org>
- To: sm-discuss AT lists.ibiblio.org
- Subject: Re: [SM-Discuss] Tome vote results
- Date: Thu, 8 Oct 2009 17:25:07 -0400
Donald Johnson (ltdonny AT gmail.com) wrote [09.10.08 16:34]:
> First, line wrap? Or it might just be my mail client bugging me.
>
> Bor Kraljic wrote:
> > - it would be nice to have man pages also on wiki. Even better would
> > be if it would be the same source and then copied to wiki. so your
> > team has to write it only once.
>
> I disagree. I feel the wiki documentation and the man-page
> documentation should be worded differently, possibly by different
> authors so that users can cross-reference the documentation and have
> points clarified. However, regardless, both types of documentation
> should cover the same functions.
This functionality can (and should) be derived from having different
people *review* the same document, rather than by having the same
document rewritten by multiple people. Having it rewritten essentially
duplicates work. For an example of how simply reviewing a single
document can work, see the revision history of
http://www.sourcemage.org/Tome/DocumentGuidelines. ;)
--
Justin "flux_control" Boffemmyer
Cauldron wizard and general mage
Source Mage GNU/Linux
http://www.sourcemage.org
Attachment:
pgpWnfw9hMrFO.pgp
Description: PGP signature
-
Re: [SM-Discuss] Tome vote results
, (continued)
- Re: [SM-Discuss] Tome vote results, David Kowis, 10/08/2009
- Re: [SM-Discuss] Tome vote results, Andraž 'ruskie' Levstik, 10/08/2009
- Re: [SM-Discuss] Tome vote results, David Kowis, 10/08/2009
- Re: [SM-Discuss] Tome vote results, Andraž 'ruskie' Levstik, 10/08/2009
- Re: [SM-Discuss] Tome vote results, David Kowis, 10/08/2009
- Re: [SM-Discuss] Tome vote results, flux, 10/08/2009
- Re: [SM-Discuss] Tome vote results, Andraž 'ruskie' Levstik, 10/08/2009
- Re: [SM-Discuss] Tome vote results, Mark Bainter, 10/09/2009
- Re: [SM-Discuss] Tome vote results, Remko van der Vossen, 10/08/2009
-
Re: [SM-Discuss] Tome vote results,
flux, 10/08/2009
-
Re: [SM-Discuss] Tome vote results,
Eric Sandall, 10/08/2009
- Re: [SM-Discuss] Tome vote results, flux, 10/08/2009
-
Re: [SM-Discuss] Tome vote results,
Eric Sandall, 10/08/2009
Archive powered by MHonArc 2.6.24.