[mythtv-users] Myth Documentation, was: Please shut up!
adeffs.mythtv at gmail.com
Mon Jan 29 16:01:56 UTC 2007
On 1/29/07, Brian Wood <beww at beww.org> wrote:
> On Jan 29, 2007, at 8:39 AM, Steven Adeff wrote:
> > What we need is a note on the front page, something along the lines of
> > "This is a wiki, not an official manual, as such, things tend to get
> > dated. As new versions of MythTV and the required linux system and
> > drivers advance information on these pages may become outdated. Unless
> > otherwise noted, it should be assumed that the information on these
> > pages pertains to the current version or has not been updated since it
> > became outdated. If you encounter such a page please contact the user
> > list."
> > Then, hopefully, the list will become aware of pages which need
> > updating.
> I still think just a single line indicating the version(s) the entry
> refers to would be helpful. We have something like that in the " date/
> time last edited" entry but I'm never sure if that was a total re-
> write or just somebody correcting a typo.
> Writing good documentation os often harder than writing the code for
> a major project, a problem a lot of open source software suffers
> from. MythTV is actually better than most in that regard but I'd like
> to see if we can make it better.
We would still have to go through all the pages when a new version is
released to update this indication for changes so it doesn't help
updating any and just adds to the screen clutter.
Before you ask, read the FAQ!
then search the Wiki, and this list,
Mailinglist etiquette -
More information about the mythtv-users