[Koha-devel] Lets improve the Koha installation documentation

[Mason James]

On 2012-09-13, at 2:30 PM, Mark Tompsett wrote:

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

nope, there is no way to do that

so, your following suggestion are a no-go


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