[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16818324#comment-16818324 ] Pierre Smits commented on INCUBATOR-234: Hi [~bdelacretaz], You may consider adding something under the bootstrapping section regarding # Continuous Integration (for testing, etc) via [https://builds.apache.org|https://builds.apache.org/] # Code analysis (via build jobs to [https://sonarcloud.io|https://sonarcloud.io/] ), with following rationale: more code issues seen by more contributors can lead to more contributions leading to better code # Code browsing (e.g. via [https://fisheye.apache.org|https://fisheye.apache.org/] ), with following rationale: showing latest changes committed and by whom. But also, when more people (adopters, influencers, etc) see that stuff is being done, the more the may be compelled to contribute . As with anything above, the more transparent a(n) incubating project works (with as much automated toos as possible) the more chance it has to get favourable feedback from the outside. Which always helps to further the project and grow the community. Best regards, Pierre Smits > 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16814129#comment-16814129 ] Bertrand Delacretaz commented on INCUBATOR-234: --- I like these but now we have to decide whether everything belongs in the cookbook, or if we should rather keep it a the overview / principles level and have the details in the guides. I think I prefer the latter (though the guides need cleaning up as well): it allows people to read the cookbook in one sitting and get lots of useful information without too many details. Or maybe go back to building the cookbook out of multiple smaller files (like before [https://github.com/apache/incubator/commit/20c6621b], and have two sections, main and appendix, in those files. Display the main sections only in the cookbook, with a link to the full info including appendix - that might be provide the most consistent view. > 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16813536#comment-16813536 ] Dave Fisher commented on INCUBATOR-234: --- Add these checklists to the Cookbook? 1. Bootstrap These tasks are done to setup infrastructure for the podling and prepare the team to develop in The Apache Way. - LDAP - DNS - Mailing lists created - Mailing list signups - Roster complete -- ICLA for initial committers w/o apache accounts -- Accounts requested for new apache committers -- All initial committers added to the PPMC - Code repository ready - Website - Wiki - Issue Tracker 2. IP / Copyright / Distribution Rights Checklist - SGA / Code transfer documents. - Apache copyright added to donated code. - Apache license added to code as appropriate. - Licenses of dependencies are reviewed. - Podling Suitable Name Search -- PodlingNameSearch created -- Research Completed by podling -- Brand Approval 3. Incubation Watch List - Collaborative Development -- Are long term volunteers including non-coders being identified and elected to be committers? -- Are the committers independent and from at least three entities? -- Are decisions being made in public on the dev@ mailing list? - Licensing Awareness -- As code is developed are new dependency's licenses properly handled? -- Are all licensing issues being acknowledged? -- Are any trademark issues being acknowledged? -- Are credit issues being acknowledged? - Releases -- Are mentors providing enough Guidance and Votes on dev@? -- Are source releases fully license and notice compliant? -- Are any binary convenience releases fully license and notice compliant? -- Are all releases distributed through required channels? 4. Graduation Checklist - Has the podling discussed graduation on dev@? - Do the Mentors agree that the podling is ready? - If graduating into an existing TLP that PMC. -- Has Graduation been discussed and the VOTE passed dev@podling? -- Has Graduation been discussed and the VOTE passed dev@pmc? - If graduating to a new TLP the IPMC on general@ -- Has the PMC been properly identified? -- Has a PMC Chair been selected? -- Has the Graduation Resolution passed the podling on dev@? -- Has Graduation been discussed and the VOTE passed general@incubator? - If to a new TLP is the resolution on the Board's agenda? -- Did the resolution pass? > 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[
https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16807665#comment-16807665
]
Bertrand Delacretaz commented on INCUBATOR-234:
---
I agree with a page specific to Incubator PMC members, maybe use a different
name ("PMC page") to avoid confusion with "the cookbook". This should also
allow for simplifying the guides.
Also agree about the menu changes, once we get there.
> 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16807412#comment-16807412 ] Dave Fisher commented on INCUBATOR-234: --- In general I like the idea. Some thoughts: * We should rearrange the menus and change the templates to the old pages first until we tease out all of the cross-links. * We need to find a clear space for ip-clearance, projects, clutch (or do we move these all to whimsy?) * Maybe we should parallel the cookbook with an IPMC member cookbook. ** Mentor ** Champion ** Shepherd ** Chair ** Resources ** Improvement Plans > 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16806609#comment-16806609 ] Bertrand Delacretaz commented on INCUBATOR-234: --- [~isa...@apache.org] I have reworked the "does my project fit" section in [https://github.com/apache/incubator/commit/87f25f9,] WDYT? > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16806538#comment-16806538 ] Bertrand Delacretaz commented on INCUBATOR-234: --- In [https://github.com/apache/incubator/commit/20c6621] I have moved back to a single page for the cookbook, [https://github.com/apache/incubator/blob/master/pages/cookbook/index.ad] This gives us a table of contents + section links for free. bq. Release Distribution Policy is an important part to discuss within releases. The "Incubator Releases" section links to http://www.apache.org/legal/release-policy.html, do we need more than that? bq. How should exceptions to the normal course be handled in the cookbook? If we really really have to I'd say small notes at the end of each section? But in general I'd prefer the cookbook to describe the happy case, with details in the (simplified) http://incubator.apache.org/guides/ . So maybe the notes can just hints at possible differences and point to the guides for details? > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16802912#comment-16802912 ] Dave Fisher commented on INCUBATOR-234: --- Some of the now outdated ideas in INCUBATOR-70 could be incorporated in 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16802900#comment-16802900 ] Dave Fisher commented on INCUBATOR-234: --- A few suggestions / questions. # technical - add a hash link so that it is easy to link to specific sections of the cookbook. I have an idea of how to do that. # Release Distribution Policy is an important part to discuss within releases. Not only does a podling need to follow Legal Policy for an Apache Release, but there must be a Release on Apache Distribution. This needs to be clear. # How should exceptions to the normal course be handled in the cookbook? Should we use a footnote, glossary, or "info box" > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16802834#comment-16802834 ] Sebb commented on INCUBATOR-234: Also podlings may become part of an existing TLP rather than a new TLP > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16802756#comment-16802756 ] Bertrand Delacretaz commented on INCUBATOR-234: --- Another suggestion by Nick Kwiatkowski on Twitter ( https://twitter.com/quetwo/status/1110863303465684999 ) is to add a "differences between podlings and top-level projects" section about this: bq. Maybe better define PMC / PPMC? Maybe a section on "Who should be on the PPMC / what values should a PPMC have" and "What is the difference between a PPMC member and a committer?" > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16802754#comment-16802754 ] Bertrand Delacretaz commented on INCUBATOR-234: --- Suggestion from [~isa...@apache.org] on Twitter: bq. What I would have found helpful in the "does your project fit the Apache Incubator" would have been a link of Apache's values so potential podlings can check if they match with what they want to aspire to. Maybe a link to https://blogs.apache.org/foundation/entry/the-apache-way-to-sustainable ? > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
[jira] [Commented] (INCUBATOR-234) Incubator Cookbook
[ https://issues.apache.org/jira/browse/INCUBATOR-234?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=16802642#comment-16802642 ] Bertrand Delacretaz commented on INCUBATOR-234: --- I have created an initial version at [http://incubator.apache.org/cookbook/] , covering (hopefully) all phases of incubation. There's a number of TODO, mostly about adding links to reference docs. I'm not sure if building this page out of multiple small documents is really useful but that's a detail, I suggest that for now we focus on the content and try to make this a central place for podling community members to find information and get an overview on how things work. Looking at the other incubator.a.o pages, a lot of information is presented as being specific to podlings - I'd rather point to the same docs as for top-level projects and just outline the small differences that apply to podlings, which works well in the context of that cookbook page. This should allow us to greatly simplify the rest of the website. > 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/] , built from small > pieces of content found under > [https://github.com/apache/incubator/tree/master/pages/cookbook] > 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 -- 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
