Short answers inline after a very quick review. Sent from my iPhone
> On Aug 28, 2018, at 5:35 PM, Matteo Merli <matteo.me...@gmail.com> wrote: > >> On Tue, Aug 28, 2018 at 5:04 PM Dave Fisher <dave2w...@comcast.net> wrote: >> >> Hi - >> >> The contributing guide is a 404 on the website and I don’t see it on the >> menus. (Is it translated? I thought I saw an initial commit for it >> yesterday. > > > The PR is still not merged. Waiting for some flaky tests on CI to let it go > through: > PR - https://github.com/apache/incubator-pulsar/pull/2459 > Preview of contributing page: > https://github.com/apache/incubator-pulsar/blob/d27d387ab3fe9a2aef997bad1b474fa92b466a05/site2/website/contributing.md This is very detailed and looks good with one important omission. How does one go on from being a contributor to committer / PMC status? There should be a description about that. Please discuss! > > >> The descriptions on the team page are a little off - Members are both >> Committers and PPMC members. Please make that distinct. (In the ASF there >> is a difference between an Apache Member and a PMC Member.) >> > > This description was actually coming from BookKeeper team page :) and I can > see it's being used in multiple projects (eg: HiveMail > https://hivemall.incubator.apache.org/team-list.html, or Maven > https://maven.apache.org/team.html ). They are some variations within Apache and the details are always evolving. Very much like how the indigenous Apache are a variety of cultures. https://en.m.wikipedia.org/wiki/Apache > > I am perfectly fine to change the description, because I agree that usage > of "members" is not very clear to whom it refers to. > > What about changing the description into : > > ------ > > A successful project requires many people to play many roles. Some write > code or documentation, while others are valuable as testers, submitting > patches and suggestions. > > The team is comprised of PMC members, Committers and Contributors. > Committers have direct access to the source of a project and actively > evolve the codebase. Contributors improve the project through submission of > patches and suggestions to be reviewed by the Committers. The number of > Committers and Contributors to the project is unbounded. Get involved > today. All contributions to the project are greatly appreciated. > ------ This is better and ties in with my main question above. > > > Matteo > -- > Matteo Merli > <mme...@apache.org>