Perhaps a javascript hide and "page flip"? So just show one section then have a next. A TOC is a good idea. ----- Original Message ----- > From: "Jonathan Fuerth" <jfuerth(a)redhat.com&gt; > To: "Pete Muir" <pmuir(a)redhat.com&gt; > Cc: jdf-dev(a)lists.jboss.org > Sent: Tuesday, June 26, 2012 10:03:03 AM > Subject: Re: [jdf-dev] Review needed: Contributor guide > > Hi Pete, > > It's a lot of information, but it's easy to follow. I think the level > of information and the writing style are just right. > > I'm not sure about the accordion device for revealing the content. I > do understand it would look daunting and invoke the tl;dr effect if > all the content was sitting there when the page loads. However, when > trying to read the whole thing in sequence, I had to scroll back up > to get to read the top of each section after clicking to reveal it. > Not sure what's better. A TOC page with multiple subpages and > next/previous links? Just one big page after all? > > Finally, a few corrections: > > * The text: We suggest updating the commit message to "Merge <Other > Project Name> '<Tag>'" > Comes out as: We suggest updating the commit message to "Merge ''" > (the angle brackets are being treated as HTML tags) > > * Change "Each example lives in it's own repository" -> "Each example > lives in its own repository" > > * Change "An example of it's usage" -> "An example of its usage" > > * Change "Release Proceedures" -> "Release Procedures" > > * Change "./dist/release-utils.sh -r" to "dist/release-utils.sh -r" > > -Jonathan > > ----- Original Message ----- > From: "Pete Muir" <pmuir(a)redhat.com&gt; > To: jdf-dev(a)lists.jboss.org > Sent: Monday, June 25, 2012 4:59:29 PM > Subject: [jdf-dev] Review needed: Contributor guide > > All, > > I've put http://www.jboss.org/jdf/stage/about/contributing/ up. It's > a first draft of a unified contributor guide for jdf. > > I've included: > > * setting up ruby etc. for building stuff > * contributing guidelines > * release process > > The things I'm not sure of: > > * is the location right (about/contributing, appearing in the About > menu)? > * should we embed the relevant bits in examples/get-involved etc.? > * is the level of the info right (conveying relevant info, but not > very hand holding)? > * is there content missing that we need. > > Thanks! > > > _______________________________________________ > jdf-dev mailing list > jdf-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/jdf-dev > _______________________________________________ > jdf-dev mailing list > jdf-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/jdf-dev >

Sorry for the late answer. In "Setting up your environment" Shouldn't We split Required and Recommended Accounts ? I think that some accounts like Gravatar, Digo and Ohloh are "recommended" . Am I wrong ? 2012/7/2 Pete Muir <pmuir(a)redhat.com&gt; Staged to http://www.jboss.org/jdf/stage/about/contributing/ I'll push live later unless I get negative feedback. Jonathan, if you still feel strongly about the presentation in the accordion, then can you file an issue in JDF, as I'm out of ideas about how to improve it right now, and want to get the content live at least... On 26 Jun 2012, at 23:20, Jason Porter wrote: > Perhaps a javascript hide and "page flip"? So just show one section then have a next. A TOC is a good idea. > > ----- Original Message ----- >> From: "Jonathan Fuerth" <jfuerth(a)redhat.com&gt; >> To: "Pete Muir" <pmuir(a)redhat.com&gt; >> Cc: jdf-dev(a)lists.jboss.org >> Sent: Tuesday, June 26, 2012 10:03:03 AM >> Subject: Re: [jdf-dev] Review needed: Contributor guide >> >> Hi Pete, >> >> It's a lot of information, but it's easy to follow. I think the level >> of information and the writing style are just right. >> >> I'm not sure about the accordion device for revealing the content. I >> do understand it would look daunting and invoke the tl;dr effect if >> all the content was sitting there when the page loads. However, when >> trying to read the whole thing in sequence, I had to scroll back up >> to get to read the top of each section after clicking to reveal it. >> Not sure what's better. A TOC page with multiple subpages and >> next/previous links? Just one big page after all? >> >> Finally, a few corrections: >> >> * The text: We suggest updating the commit message to "Merge <Other >> Project Name> '<Tag>'" >> Comes out as: We suggest updating the commit message to "Merge ''" >> (the angle brackets are being treated as HTML tags) >> >> * Change "Each example lives in it's own repository" -> "Each example >> lives in its own repository" >> >> * Change "An example of it's usage" -> "An example of its usage" >> >> * Change "Release Proceedures" -> "Release Procedures" >> >> * Change "./dist/release-utils.sh -r" to "dist/release-utils.sh -r" >> >> -Jonathan >> >> ----- Original Message ----- >> From: "Pete Muir" <pmuir(a)redhat.com&gt; >> To: jdf-dev(a)lists.jboss.org >> Sent: Monday, June 25, 2012 4:59:29 PM >> Subject: [jdf-dev] Review needed: Contributor guide >> >> All, >> >> I've put http://www.jboss.org/jdf/stage/about/contributing/ up. It's >> a first draft of a unified contributor guide for jdf. >> >> I've included: >> >> * setting up ruby etc. for building stuff >> * contributing guidelines >> * release process >> >> The things I'm not sure of: >> >> * is the location right (about/contributing, appearing in the About >> menu)? >> * should we embed the relevant bits in examples/get-involved etc.? >> * is the level of the info right (conveying relevant info, but not >> very hand holding)? >> * is there content missing that we need. >> >> Thanks! >> >> >> _______________________________________________ >> jdf-dev mailing list >> jdf-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/jdf-dev >> _______________________________________________ >> jdf-dev mailing list >> jdf-dev(a)lists.jboss.org >> https://lists.jboss.org/mailman/listinfo/jdf-dev >> _______________________________________________ jdf-dev mailing list jdf-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jdf-dev _______________________________________________ jdf-dev mailing list jdf-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/jdf-dev