[Koha-devel] Lets improve the Koha installation documentation

[Mark Tompsett]

Greetings,

[snip]
Re: proposal for use of a standard for documentation (RST)
-- Don't care about the format. But I like standards. Standards clarify and 
guide. Standards are good.

[snip]
> 2/ mark old/obsolete doco as *WARNING - DEPRECIATED*, and redirect to new 
> doco location
>  (...or just delete the old doco)++

I think this would depend on how popular the page is.
Is there a way of knowing if the page has even been viewed in the last X 
months?

Do we really need pages that are... 2 years old without access?
I think a deletion in those cases is reasonable.

However, if it was accessed in the last few months, then a redirect is 
preferred over a warning, because people ignore warnings all the time.

However, in the case of historically accurate and useful pages, a warning is 
a good idea. I like the sample warning you gave, but it is too small. People 
need to be told in full screen boldness it is outdated, otherwise they will 
in advertently miss it. If people wish to ignore full screen warnings, then 
there's not much we can do short of a delete.

Not to mention. If the information is still in RST format on the repo, no 
data is really lost, and it is available for the advanced user.

GPML,
Mark Tompsett