discuss: small demo page
Subject:
Re: small demo page
From:
Pradeep Padala ####@####.####
Date:
19 Aug 2005 17:56:58 -0000
Message-Id: <43061D49.2060905@eecs.umich.edu>
> http://dodin.org/mediawiki/index.php/Tldp_demo_page
> I setup a locked page and an unlocked one.
>
> I used my own HOWTO for an example.
The setup with stable and editable HOWTO seems good. Since your howto is
a simple one, it's pretty easy to edit. But, consider the bigger HOWTOs
with code and even images. For example, I generate the code in my
NCURSES HOWTO from the real c programs stored seprately. I don't want
anyone directly editing the code in the HOWTO. It's also possible for
someone to throw in some bad code (either style-wise or real malicious)
in the howto and it will be tough to check as I have more than 30 little
programs. Also, I have references to snippets of code, that are not
directly in the HOWTO.
In concept, having a Wiki sounds nice. But, until we get a good editing
mechanism, having a comment mechanism like postgresql documentation
(http://www.postgresql.org/docs/8.0/interactive/index.html) that allows
comments for each individual page is probably a better option.
Different howtos have different requirements. My HOWTO is more like a
guide, and is not going to change much. However, I want to correct small
errors in programs etc. I can do that simply by collecting all the
reader's comments (that's how I do it now). Some other howtos are
describing howto do a single thing, and may require constant update as
Linux changes.
My 2c.
--
Pradeep Padala
http://ppadala.blogspot.com