Documentation idea - was [mythtv-users] howIdidit: Debian+Mythfromscratch using mdz'spkgs

Edward Wildgoose Edward.Wildgoose at FRMHedge.com
Wed Apr 9 15:01:52 UTC 2003


I have put a really nasty basic Wiki up for testing at 

http://rs.wildgooses.com/twiki/bin/view/Mythtv/WebHome

It's nothing more than a shell, but it is something that anyone who wants to can experiment with.

At the moment you need to register to make changes (I think?).  This could be changed to allow anyone to edit things though...?  

I don't see any reason that the whole of the current documentation couldn't be done in a Wiki like this (subject to the main person doing the editing liking the idea...)

Photos can be uploaded and linked inline (ie so that you can see them).  Drop me a line if you have need and I will explain.

Remember this is *NOT* intended to replace the existing documentation site, nor the mailing list - it certainly isn't intended to fragment the documentation sources into multiple areas either.  This is a tool which fits somewhere between the two for writing up the conclusions of interesting threads.  For example I have collected together all the Gentoo CVS ebuild scripts, tweaked a few and packaged them up - It would be useful if there was a place I could lodge these along with instructions on setting up gentoo with them.  Or lists of useful sources of silent PC information, etc.

This is just something to kick around, please feel free to shoot it down.  To take off I think this needs some support/approval from Isaac and Robert Kulagowski though - we don't want a breakaway documentation link developing.

-----Original Message-----
From: John Kelley [mailto:john at kelley.ca]
Sent: 09 April 2003 13:24
To: 'Discussion about mythtv'
Subject: RE: Documentation idea - was [mythtv-users] howIdidit:
Debian+Mythfromscratch using mdz'spkgs


I've been using phpWiki for over a year in a couple of projects I'm a
part of and its great! Although you do need someone to go in and freshen
it up a little bit every couple of months to organise things.

	- John

-----Original Message-----
From: mythtv-users-bounces at snowman.net
[mailto:mythtv-users-bounces at snowman.net] On Behalf Of Edward Wildgoose
Sent: Wednesday, April 09, 2003 6:13 AM
To: Discussion about mythtv
Subject: Documentation idea - was [mythtv-users] howIdidit: Debian+Myth
fromscratch using mdz'spkgs


What do you guys think about adding a wiki to the mythtv site for more
informal documentation (have a look at,say, squirrelmail to see someone
else use this).

I can setup a demo wiki (twiki is my preferred choice because it allows
pictures to be added fairly easily) to show you why it is a feasible
method.

The idea is that it is slightly more structured than a forum (personally
I find these very useful, but you have to read and digest a lot to find
the answer).  But it is less structured than the professional docs that
get put on the main documentation website.

The idea of a wiki is that every page has an edit link and so it is easy
to update it and add to it.  For example if we have a "Success Stories"
page, then people could easily add to it, and because it is more like
documentation it should be slightly easier than say reading through the
forum thread on this mailing list about success stories.

However, we would still keep discussion here on the mailing list.  The
point is that the mailing list tends to contain huge nuggets of gold,
but it is quite well watered down by each preceding discussion before it
is solved.  Having something like the wiki would give people a place to
jot down the conclusions easily perhaps...

Any comments?



More information about the mythtv-users mailing list