[OpenStack-docs] [openstack-docs] Archiving documentation
Alexandra Settle
a.settle at outlook.com
Mon Jan 23 16:46:04 UTC 2017
I apologise for top-posting, Outlook 2016 doesn’t allow inline posting.
I completely agree that you cannot reach Utopia. Having archived versions with perfect linkage and no issues is hard. Theoretically speaking, this is a lot of heavy lifting.
Tom – you seem to know and understand a solution that you would like to see implemented. Do you have the bandwidth to research architecting and implementing a solution and eventually writing up a spec? As Anne suggested, Brian Moss or Graham Hayes might be able to help you implement this and Andreas is happy to answer any questions from the infra side of things.
At the moment, the docs team is flat out with the release and upcoming planning for the PTG. Our team is currently too small to take on another such huge task.
On 1/23/17, 4:24 PM, "Jonathan Proulx" <jon at csail.mit.edu> wrote:
On Mon, Jan 23, 2017 at 11:54:24PM +0800, Tom Fifield wrote:
:Every page on the django docs has a hover-over listing the version of the
:documentation being read. You mouse over it, and you can choose to navigate
:back to that specific page for the release you need - even the
:old/insecure/unsupported version from 2014. The URLs are all standard too.
:
:So, that's best practice. How close can we get?
just wanted to quickly second that as an ideal, especially the
standard URL. Every time you break a published URL Tim Berners-Lee
sheds a tear (and it's starting to leak though the floor above me
now...)
As somone who's been trying to not break URLs, never delete anything,
and keep evolving content fresh for far too long now I also recognize
one can't always reach Utopia.
-Jon
_______________________________________________
OpenStack-docs mailing list
OpenStack-docs at lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
More information about the OpenStack-docs
mailing list