[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16806744#comment-16806744 ]
Bertrand Delacretaz commented on INCUBATOR-234: ----------------------------------------------- Once we're happy with the contents of the cookbook I think the following pages can be removed. They have lots more detail but I don't thinks those are useful, except for a few exceptions which are noted. * http://incubator.apache.org/policy/incubation.html * http://incubator.apache.org/policy/process.html * http://incubator.apache.org/policy/roles_and_responsibilities.html (except "mentors", simplified, under "guides") * http://incubator.apache.org/podling-story.html * http://incubator.apache.org/guides/proposal.html (I think the cookbook, a template + the existing examples will do) * http://incubator.apache.org/guides/entry.html The idea is that the Incubator website structure would be: * The homepage with all the basic info (the "What are the steps to becoming an Apache Software Foundation Top-Level project?" that's now at http://incubator.apache.org/cookbook, pointers to mailing lists etc) * The cookbook as the next step, to get the overview and lots of basic information, at least for the "happy case" of the vast majority of podlings. * The guides (simplified and cleaned up) for more details * Links to other ASF general info as we have now * A cleaned-up FAQ So the policies, proposals, PMC guides disappear (the latter replaced by links to general ASF info), leaning on existing ASF documentation instead and just outlining the differences with podlings as done at http://incubator.apache.org/cookbook/#podling_top_level_project_what_are_the_differences For now these are just my ideas, I'm just thinking outloud here. Will bring this to our general@list for discussion once we feel good about the cookbook. > Incubator Cookbook > ------------------ > > Key: INCUBATOR-234 > URL: https://issues.apache.org/jira/browse/INCUBATOR-234 > Project: Incubator > Issue Type: Task > Components: site > Reporter: Bertrand Delacretaz > Priority: Major > > As discussed at [1] the goal is to create a single page Incubator Cookbook, > with all the details of the incubation process, in chronological order of the > incubation journey. > This should be as concise as possible, with links to more information where > strictly needed, and adopt a friendly tone in the sense of clearly making the > Incubator a service to our podlings. > Draft page at [http://incubator.apache.org/cookbook/ , > |http://incubator.apache.org/cookbook/]source > [https://github.com/apache/incubator/blob/master/pages/cookbook/index.ad] > As a next step I'll focus on getting a mostly consistent set of topics and we > can then share the writing work. > [1] > [https://lists.apache.org/thread.html/51fe5d659778bed5b6385c7c39bbdf688d02f1b1dbe02d595d514cbb@%3Cgeneral.incubator.apache.org%3E] > h2. How to contribute to this effort > * Feedback and suggestions are welcome here. > * Pull requests at [https://github.com/apache/incubator] also work > * Discussions on the [general@incubator.a.o|mailto:general@incubator.a.o] > list, [https://lists.apache.org/list.html?general@incubator.apache.org] -- This message was sent by Atlassian JIRA (v7.6.3#76005) --------------------------------------------------------------------- To unsubscribe, e-mail: general-unsubscr...@incubator.apache.org For additional commands, e-mail: general-h...@incubator.apache.org