On 03/16/2014 04:35 AM, Yedidyah Bar David wrote:
----- Original Message -----
From: "Bob Doolittle" <b...@doolittle.us.com>
To: "Doron Fediuck" <dfedi...@redhat.com>
Cc: "users" <users@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" <b...@doolittle.us.com>
To: "users" <users@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
_______________________________________________
Users mailing list
Users@ovirt.org
http://lists.ovirt.org/mailman/listinfo/users
