[SM-Discuss] Tome nominations
David Kowis
dkowis at shlrm.org
Fri Aug 29 08:54:52 EDT 2008
Quoting Mark Bainter <mbainter-smgl at trampledstones.com>:
> Elisamuel Resto [samuel at dragonboricua.net] wrote:
>> Now, in regards to the Git-based backend for the wiki, if it is possible
>> to have it and still keep up with the upstream versions without needing
>> to rewrite it for each bump then by all means it's a good idea. We don't
>> want to do a horrid amount of work for the complexity it might bring, if
>> it's not used much. I personally prefer some other method, as discussed
>> with Justin and Juan Carlos on IRC... like DocBook or LaTeX. However,
>> for now I want to focus on the above-mentioned tasks.
>
> I haven't seen the IRC discussion, but I would raise a note of caution
> on the point of DocBook and LaTeX. I like LaTeX and I would still be
> hesitant to use it in this type of situation. Anyone can throw together
> some docs in MoinMoin with a few minutes work. Even someone familiar
> with LaTeX is going to have to invest considerably more time in putting
> together documentation.
>
> The more work you require to create and update the documentation, the
> less documentation you're going to get. :-)
>
Yeah. I agree with this. Keep the bar to entry low. Where's our
Spellwriter's handbook? Oh it's in LaTeX supoosedly still under
development by sandalle. How long has it been there? Years...
I don't think doing docs in anything other than simple plain text is a
good idea. (wikisyntax is okay)
--
David Kowis
Source Mage Linux - www.sourcemage.org
Liberty! - www.campaignforliberty.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 664 bytes
Desc: PGP Digital Signature
Url : http://lists.ibiblio.org/pipermail/sm-discuss/attachments/20080829/57dba266/attachment.bin
More information about the SM-Discuss
mailing list