[Users] Request for Wiki - dates

[Bob Doolittle]

On 03/16/2014 04:35 AM, Yedidyah Bar David wrote:
> ----- Original Message -----
>> From: "Bob Doolittle" <bob at doolittle.us.com>
>> To: "Doron Fediuck" <dfediuck at redhat.com>
>> Cc: "users" <users at ovirt.org>
>> Sent: Thursday, March 13, 2014 10:17:22 PM
>> Subject: Re: [Users] Request for Wiki - dates
>>
>>
>> On 03/13/2014 03:28 PM, Doron Fediuck wrote:
>>> ----- Original Message -----
>>>> From: "Bob Doolittle" <bob at doolittle.us.com>
>>>> To: "users" <users at ovirt.org>
>>>> Sent: Thursday, March 13, 2014 6:53:13 PM
>>>> Subject: [Users] Request for Wiki - dates
>>>>
>>>> Hi,
>>>>
>>>> As most are aware, there's a lot of information on the Ovirt Wiki that's
>>>> out of date. In spite of our best efforts, that will probably always be
>>>> true - it's the nature of Wikis.
>>>>
>>>> When I look for information on our Wiki, I never know where the most
>>>> current information is.
>>>>
>>>> I think it would be really helpful if someplace on each Wiki page was a
>>>> useful date to let us know the currency of the info. Probably the most
>>>> useful date is last-modified, although creation date might also be
>>>> useful. Maybe we could even map/display the date to the version number
>>>> of whatever the current stable release was at the time for context
>>>> (sometimes the content of a page calls out a particular version it's
>>>> addressing, but a lot of the time it does not).
>>>>
>>>> Just as an example, I want to find out about migrating my existing
>>>> configuration to self-hosted, using 3.4 RC2. A google search shows the
>>>> following links (in order shown):
>>>>
>>>> http://www.ovirt.org/Features/Self_Hosted_Engine
>>>> http://www.ovirt.org/Migrate_to_Hosted_Engine
>>>> http://www.ovirt.org/Hosted_Engine_Howto
>>>> ...
>>>>
>>>> I'm sure the Features page is ancient at this point. It's hard to tell
>>>> about the 2nd page.
>>>>
>>>> Of course the date a page was last modified doesn't directly indicate
>>>> how correct/current the information is, but there's a correlation.
>>>> Knowing the date would be useful in making a judgment. It might even
>>>> help the task of identifying and cleaning up obsolete pages.
>>>>
>>>> Easy to do?
>>>>
>>>> -Bob
>>>>
>>> Hi Bob,
>>> I'm not against it and I'm aware of the fact that pages tend to become out
>>> of date.
>>> Since every page has a history as you can see in the attached, adding
>>> another date
>>> seems needles.
>>>
>>> What do you think?
>> Hi Doron,
>>
>> I was thinking of something very simple - a clear text date on ever page
>> on the Wiki.
>>
>> I can't see anything that looks like your attached picture of menus on
>> this page, for example:
>> http://www.ovirt.org/Features/Self_Hosted_Engine
>>
>> Do you have to log in to see that menu? If so, that's not very helpful
>> to those without accounts...
> 1. So create an account, it's free :-)
>
> 2. It's indeed *shown* only to logged in users, but the links are accessible
> to everyone. You can "guess" them by looking at any other mediawiki site.
> E.g. for this page, the history one is:
>
> http://www.ovirt.org/index.php?title=Features/Self_Hosted_Engine&action=history

I trust we can both agree we could do better, without too much trouble.

We want to make our Wiki pages as easy to use and as helpful as possible 
to everyone, not just people with accounts who have logged in before 
searching for information, or who know how to do magical transformations 
on Wiki URLs to determine the date ;)

I'm not trying to be critical of where we are now - just trying to 
establish a baseline of what we should hope to achieve.

Regards,
    Bob