Skip to Content.
Sympa Menu

sm-discuss - Re: [SM-Discuss] Tome vote results

sm-discuss AT lists.ibiblio.org

Subject: Public SourceMage Discussion List

List archive

Chronological Thread  
  • 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




Archive powered by MHonArc 2.6.24.

Top of Page