On May 23, 2013, at 4:04 PM, Kris Borchers <kris(a)redhat.com> wrote:
On May 23, 2013, at 2:50 PM, Jay Balunas <jbalunas(a)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
http://backbonejs.org/#changelog
but on a separate page.
>
>>
>> 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
>
>>
>> Kris
>> _______________________________________________
>> aerogear-dev mailing list
>> aerogear-dev(a)lists.jboss.org
>>
https://lists.jboss.org/mailman/listinfo/aerogear-dev
>
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev(a)lists.jboss.org
>
https://lists.jboss.org/mailman/listinfo/aerogear-dev
_______________________________________________
aerogear-dev mailing list
aerogear-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/aerogear-dev