Re: Fabric v1.1, v1.2, v1.3 documentation

Brian Behlendorf <bbehlendorf@...>

I do not think it is ever wise to remove old documentation, even with automated redirection. There are valid use cases for examining old docs, from understanding how a feature evolved or was first introduced, to helping that poor kid who was dropped into fixing a downtime issue on a production platform that the kid's predecessors didn't upgrade as they should. I often have to go find online user manuals for old hardware long out of warranty or support. I realize those docs are in Github so they're not disappeared entirely (nor of course from the Internet Archive), but for both those use cases, reading through the source trees or doing a local build of the docs is pretty cumbersome. I'd sooner recommend a big red banner across the top declaring them out of support and that the authors urgently recommend the reader upgrades to a supported release.


On 8/31/20 12:02 PM, Pam Andrejko wrote:

As Joe mentioned on the last Contributor's call,  we’ve noticed from Google Analytics of the Fabric documentation that there are still readers viewing older versions of the documentation and we'd like to propose a strategy for retiring old versions from ReadTheDocs. The strategy we are proposing here aligns with the overall Fabric LTS strategy, where two LTS releases overlap so that users can make plans to upgrade to the latest LTS release.

Following the same approach, the documentation proposal is to keep the documentation for the current LTS version, and for prior versions, back to the previous LTS version. Currently, that would include v2.2 (current LTS), v2.1, v2.0, and v1.4 (previous LTS). This approach would imply removing the v1.1, v1.2, and v1.3 documentation versions, since these versions are no longer supported, and adding redirects to the latest documentation in ReadTheDocs.

I should emphasize that there are no plans to remove the source code branches on Github for those previous Fabric versions. And because the documentation is included in the source code, the older documentation will remain available in Github for historical reference. The intent here is only to remove the unsupported versions from ReadTheDocs to encourage users to utilize one of the more recent versions.


Pam Andrejko

Brian Behlendorf
Executive Director, Hyperledger
Twitter: @brianbehlendorf

Join to automatically receive all group messages.