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

[Daniel M. <da...@mi...>]

Thanks for the suggestion. I did this now.

The tarball on SourceForge has been cleaned up!


On Sunday, April 6th, 2025 at 7:18 PM, Andres Valloud <te...@sm...> wrote:

> 

> 

> 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