Hi - This is a really cool idea and there are a few JIRAs that hint at this.
Your idea is a lot like: INCUBATOR-203 - Rename Proposals to something else, add more how to get in information INCUBATOR-204 - Create a Creating Releases section I started an improvement plan page to help classify JIRAs that I triaged yesterday. I plan to upload this later today. Would you create a JIRA to track the Cookbook? I would like to resolve and defer INCUBATOR-203 to your plan. > On Mar 26, 2019, at 9:57 AM, Bertrand Delacretaz <bdelacre...@apache.org> > wrote: > > Hi, > > Recent discussions make me think that the Incubator should be > presented more as a service to incubating projects, rather than as the > Stern Gatekeeper to Apache Heaven, as we sometimes (unvoluntarily I > think) make it appear - mostly due to outdated and policy-heavy > content at http://incubator.apache.org/ > > To help with that I've set myself a goal to try and recreate the > Incubator website with just two pages (*): > > -A homepage that describes our services and gives a quick overview of > the incubation process > -A cookbook with all the details, in chronological order of the > incubation journey, as concise as possible, with links to more > information where strictly needed I think that the journey should be described, but certain implementation details like all the ways to update podlings.xml and the status page should be separate so that as those implementations are improved the new ways are easier to update. For example, there are little details about graduation or retirement and <resolution> xml that are only found by examining the XSL transforms. > > I've started a prototype of the cookbook at > http://incubator.apache.org/cookbook/ - each item is defined in its > own content file under > https://github.com/apache/incubator/tree/master/pages/cookbook to make > it easy to manage and organize. FYI - Asciidoctor likes links like this: link:https://wiki.apache.org/incubator/ProjectProposals[Incubator wiki] Or https://wiki.apache.org/incubator/ProjectProposals[Incubator wiki] Or link:#proposal[See below] > > If people like the idea, I'll continue fleshing it out to a point > where we it hopefully demonstrates that it's better than our current > website. > > WDYT? Yes! Regards, Dave > > -Bertrand > > (*) ok, ok we might need some appendices but those two pages should > get 99.456% of our traffic. > > --------------------------------------------------------------------- > To unsubscribe, e-mail: general-unsubscr...@incubator.apache.org > For additional commands, e-mail: general-h...@incubator.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: general-unsubscr...@incubator.apache.org For additional commands, e-mail: general-h...@incubator.apache.org