[mythtv-users] Help with documentation

[Jay Ashworth]

----- Original Message -----
> From: "Hika van den Hoven" <hikavdh at gmail.com>

> Sunday, June 21, 2015, 11:05:01 PM, you wrote:

> >> A first thought is to create an extensive tree of keywords, whereby
> >> assigning every page the appropriate keywords. So much more extensive
> >> then the present search tree. Also several lines of entry, like to
> >> start with: initial configuration, maintenance, upgrading,
> >> api-usage
> >> etc.
> 
> > "tree of keywords". MW has a UI for that data structure?
> 
> > If you just mean a tree of links on a page, by all means, that might
> > be useful.
> 
> I mean that a bit more then that. Where by adding keywords to pages
> the automatically appear on those lists. And if you select multiple
> keywords you get a sub selection of the pages containing those.

You *almost* mean Mediawiki's Category Tagging facility.  I don't think 
you can do boolean searches for multiple tags, but it will certainly
automatically build the index pages.

> > But anything that starts with "let's throw out tens of thousands of man-hours
> > of work people have already put in" is probably not the best approach.
> 
> I did not say that in any word! I'm saying that searching the data is
> not as easy or logical as possible. And exactly because I do not want
> what you say, I suggest to keep everything and then on a fresh slate
> first think and create a framework and document that in an easy and
> accessible way and then move data there in the mean time looking at
> the data and update where needed! Just upgrading the data is undoable
> and 5 or 6 years without such a reorganization is extremely long!
> Which says a lot about how good it was done!

Well, it's questionable whether *all* of the data that came over from Moin 
actually got a complete edit in that time; I fell off after about a year or 
two, myself, so I'm not sure.

The hard part is handling versioning; users often don't upgrade until they
have no choice, and MW doesn't make it as easy as you'd like to maintain
multiple versions.

But yeah, more category tagging is probably called for...
-- 
Jay R. Ashworth                  Baylink                       jra at baylink.com
Designer                     The Things I Think                       RFC 2100
Ashworth & Associates       http://www.bcp38.info          2000 Land Rover DII
St Petersburg FL USA      BCP38: Ask For It By Name!           +1 727 647 1274