2:09 p.m.
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.
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.
That in itself will clean things up greatly. After that I would just do some minor tweaks
to the layout of the index page, etc and I think we will be better off. Thoughts?
I can go ahead and make the changes and send a PR for discussion if that would work better
for people as well.
Kris
2:50 p.m.
On May 23, 2013, at 3:09 PM, Kris Borchers wrote:
Completely agree - our docs sections really needs to be revisited!
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)?
That in itself will clean things up greatly. After that I would just do some minor tweaks
to the layout of the index page, etc and I think we will be better off. Thoughts?
Yes, please feel free to tweak this as needed! We'll need to revisit the whole thing
at some point here as well.
One other related item to discuss is to revamp the overall roadmap for the project -
perhaps break the page into columns with one side being a high level overview (like the
roadmap email from qmx), and the other be the links to the details for the tech?
I can go ahead and make the changes and send a PR for discussion if that would work
better for people as well.
+1
3:04 p.m.
On May 23, 2013, at 2:50 PM, Jay Balunas <jbalunas(a)redhat.com> wrote:
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?
4:17 p.m.
On May 23, 2013, at 5:10 PM, Douglas Campos wrote:
Yup, as I said it did not really "feel right" to me :-)
The roadmaps on the site have to be maintained, I think this is a standard for a project
to be successful and easy to digest.
Maintaining change logs on the other hand is not exactly the same thing. So I agree with
you that only makes sense if automated, just not sure of the priority to try to get that
setup.
7:31 a.m.
On May 23, 2013, at 4:04 PM, Kris Borchers <kris(a)redhat.com> wrote:
+1 to change logs.
that was my initial thought when i read the first email
maybe something like this
http://backbonejs.org/#changelog
but on a separate page.
4325
days inactive
4326
days old
8 comments
7 participants
participants (7)
-
Douglas Campos -
Jay Balunas -
Jay Balunas -
Kris Borchers -
Kris Borchers -
Kris Borchers -
Lucas Holmquist