Re: [Netatalk-admins] Removing old documentation from website

[Andres V. <te...@sm...>]

Here's a suggestion.  In here,

https://netatalk.io/documentation

under Supplemental Documentation, a link that says something like 
"archived manuals for previous versions".

Also FYI the tarball has empty directories for 1.5 and 1.6 (other than 
.gitignore files).

On 4/6/25 1:36 AM, Daniel Markstedt wrote:
> Do you have a suggestion a good place to host this tarball, so that it can be discovered by anyone who needs it?
> 
> If it's a question of retention, we will always have the git history of the Netatalk/netatalk.io repo.
> You can go back to earlier commits and get any manual that you need.
> 
> https://github.com/Netatalk/netatalk.io/tree/main/public
> 
> On Saturday, April 5th, 2025 at 11:47 PM, Andres Valloud <te...@sm...> wrote:
> 
>>
> 
>>
> 
>> Did you consider a section of old docs tarballed in their current state?
>>
> 
>> On 4/5/25 2:11 PM, Daniel Markstedt wrote:
>>
> 
>>> The Netatalk website has been distributing every manual revision since
>>> 2.0.2 in 2005.
>>> 20 years later, this has now grown to a massive sprawl of html pages,
>>> since we're keeping copies of every minor feature release.
>>>
> 
>>> Apart from the massive sprawl, search engines tend to favor the oldest
>>> versions of these manual pages.
>>> You consistently get hits on decade-old docs when googling for specific
>>> netatalk options and components.
>>>
> 
>>> Therefore, I plan to start replacing very old docs with redirects to the
>>> latest docs.
>>> Old docs can still be recovered in git revision history, or regenerated
>>> from docbook sources if needed.
>>>
> 
>>> In phase one, I plan to remove docs for release versions that are
>>> already EOL: 2.0, 2.1, 2.2, 2.3, 3.0 and 4.0.
>>>
> 
>>> I'm open to suggestions about the ideal end state.
>>> My preference would be to host a single version of the manual for the
>>> latest stable version.
>>> But if people find older manuals useful then we can debate it.
>>>
> 
>>> Cheers,
>>>
> 
>>> Daniel
>>>
> 
>>> _______________________________________________
>>> Netatalk-admins mailing list
>>> Net...@li...
>>> https://lists.sourceforge.net/lists/listinfo/netatalk-admins