Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
doc: reorganize releases #20784
The links on this page currently lead to "404 - not found" errors: http://docs.ceph.com/ceph-prs/20784/releases/releases/
First, this is a big improvement over what we had, so I'm happy if no further changes are made!
That said, it would be nice if underneath Ceph Releases there was a section for each major release so that all the individual releases are grouped. Each section could include the dev releases, then the rcs, then the stable releases. The sections could be named like "Luminous 12.y.z" or "Bobtail 0.56.z" (tho for the old releases they'd include the 0.49..0.55 dev releases too, I guess... don't really care about the old ones to be honest!).
Separating "active" vs. "archived" will mean another place that needs manual updates to reflect the changes that a new release brings. We have several places already were we've tried this and it is fairly easy to fall behind.
The index that groups all releases is nice though. This looks almost good to go
Why is this renamed: doc/releases.rst → doc/releases/releases.rst ? It might make sense to just append the contents of that to doc/releases/index.rst since it isn't too large. If that is undesirable, then renaming the page to something else?
Mar 14, 2018
The nav is automatically generated with a small python script that is part of the template, adjusting just for this one section is going to be tricky. A way around this would be to not list every single version released, but rather group them in another file:
Mar 19, 2018
6 checks passed
The links at http://docs.ceph.com/docs/master/releases/schedule/ lead to 404 - a regression I suppose?