[mythtv-users] Help with documentation

[Hika van den Hoven]

Hoi Jay,

Monday, June 22, 2015, 12:21:01 AM, you wrote:

> ----- 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...

And I might add to that, that I possibly am willing to put effort in
this, but not alone. For the initial setup you need more people.
First of all while I know about data logic and handling, I have little
experience with wiki's or html/web.
Secondly you need at least three to bounce ideas around and to prevent
you from not seeing your own mistakes.
And then if the framework and its documentation is there, everybody
should be able to jump in, reviewing and moving the data of her or his
expertise.
Actually if the present wiki software can handle it, the moving is
mostly metaphorically. But then as said I have little experience with
wiki's


Tot mails,
  Hika                            mailto:hikavdh at gmail.com

"Zonder hoop kun je niet leven
Zonder leven is er geen hoop
Het eeuwige dilemma
Zeker als je hoop moet vernietigen om te kunnen overleven!"

De lerende Mens