On May 23, 2013, at 2:50 PM, Jay Balunas <jbalunas@redhat.com> wrote:
On May 23, 2013, at 3:09 PM, Kris Borchers wrote:
Today I went to move the JS roadmap from a gist to the website. I have determined that I hate our roadmap section. It's messy and will not be maintainable going forward. I would like to make a proposal for some updates before I dive in.
Completely agree - our docs sections really needs to be revisited!
First, there is no need for versioning on the index page. It is a roadmap so it should just represent the road ahead and be updated as things change. Once we have passed a milestone, it can be removed since it is no longer on the roadmap or has been moved to a new milestone.
I completely agree with the versioning on the index page itself.
For the specific roadmap pages, perhaps a suggestion here, for major/minor releases like we have planned on the way to 2.0 would it make sense to mark releases as completed? Or perhaps move to the bottom of the specific page (not sure that feels right to me though)?
I would rather just remove anything that isn't "the future" from a roadmap. What I would suggest is maybe we could add a section to the site for change logs. That way we can post complete lists of features implemented in a version release. That way we get the best of both worlds, a clean path forward and a pretty picture of where we've been. Thoughts?
+1 to change logs.
that was my initial thought when i read the first email
maybe something like this
but on a separate page.