You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@community.apache.org by GitBox <gi...@apache.org> on 2020/12/01 13:47:48 UTC
[GitHub] [comdev-site] cottage14 opened a new pull request #25: Update apache-project-maturity-model.md
cottage14 opened a new pull request #25:
URL: https://github.com/apache/comdev-site/pull/25
Proposed edits to improve readability. Passive voice can obscure who does what, and people whose primary language is not English can find it hard to understand.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] bdelacretaz commented on pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
bdelacretaz commented on pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#issuecomment-864842936
I created #61 based on this PR as (I think) I couldn't update this one as it's based on a different repository.
I have committed the resulting changes, many thanks to @cottage14 and all who provided input here!
The resulting commit is https://github.com/apache/comdev-site/commit/bed7a048a23ced862b654804f2c50d7dba56e9a0
This PR can now be closed, if more changes are needed we can create more specific ones. I don't seem to be able to close it, @cottage14 can you do that if you agree?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] bdelacretaz commented on pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
bdelacretaz commented on pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#issuecomment-747488325
Thank you for this! Given that this is a somewhat normative document and not just prose, I suggest making the dev@community.a.o list aware of these changes before merging them. I could drive that but I probably won't have time before early January, so if you don't mind letting this sit for a while I would appreciate it.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] sebbASF commented on a change in pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
sebbASF commented on a change in pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#discussion_r654781250
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -216,23 +212,20 @@ those contributors.
<dt id="CS20">CS20</dt>
<dd>
-Decisions are made by consensus among PMC members
+Decisions reqyuire a consensus among PMC members
Review comment:
reqyuire?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] clr-apache commented on a change in pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
clr-apache commented on a change in pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#discussion_r654693728
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -216,23 +212,20 @@ those contributors.
<dt id="CS20">CS20</dt>
<dd>
-Decisions are made by consensus among PMC members
+Decisions reqyuire a consensus among PMC members
Review comment:
Decisions require consensus among PMC members
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -103,22 +102,21 @@ formats that are expected to stay readable in the long term.
<dt id="RE20">RE20</dt>
<dd>
-Releases are approved by the project's PMC (see CS10), in order to make them an act of the Foundation.
+The project's Project Management Committee (PMC) (see CS10) approves each software release in order to make the release an act of the Foundation.
</dd>
<dt id="RE30">RE30</dt>
<dd>
-Releases are signed and/or distributed along with digests that can be reliably used to validate the downloaded archives.
+Releases are signed and/or distributed along with digests that anyone can be reliably use to validate the downloaded archives.
Review comment:
Releases are signed, and distributed along with digests and signatures that anyone can reliably use to validate the downloaded archives.
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -6,54 +6,53 @@ The **Apache Project Maturity Model** provides a suggested framework for evaluat
# Overview
-The goal of this maturity model is to describe how Apache projects operate, in a concise and high-level way, and to provide a basic framework that projects may choose to use to evaluate themselves.
+The goals of this maturity model are to describe how Apache projects operate in a concise and high-level way, and to provide a basic framework that projects may choose to use to evaluate themselves.
-It is meant to be usable outside of Apache as well, for projects that might want to adopt some or all of these principles. Projects that envision moving to Apache at some point might start working towards this to prepare for their move.
+It is usable outside of Apache as well, for projects that might want to adopt some or all of these principles. Projects that envision moving to Apache at some point might start working towards this to prepare for their move.
-It does not describe all the details of how our projects operate, but aims to capture the invariants of Apache projects and point to additional information where needed. To keep the main model as concise as possible we use footnotes for anything that's not part of the core model.
+It does not describe all the details of how our projects operate, but aims to capture the invariants of Apache projects and point to additional information where needed. To be as concise as possible we use footnotes for anything that's not part of the core model.
-Contrary to other maturity models, we do not define staged partial compliance levels. A mature Apache project complies with all the elements of this model, and other projects are welcome to pick and choose the elements that suit their goals.
+Contrary to other maturity models, we do not define staged partial compliance levels. A mature Apache project complies with all the elements of this model, and other projects are welcome to adopt the elements that suit their goals.
Note that we try to avoid using the word "must" below. The model describes the state of a mature project, as opposed to a set of rules.
-Projects which incubate at Apache might not fit into all the parts of this model, however a major goal of incubation is to bring the project's community closer to it.
+Projects which incubate at Apache might not fit into all the parts of this model; however a major goal of incubation is to bring the project's community closer to it.
-Questions and feedback about this model are welcome on the <a href="https://lists.apache.org/list.html?dev@community.apache.org">comdev mailing list</a>.
+We welcome qQuestions and feedback about this model on the <a href="https://lists.apache.org/list.html?dev@community.apache.org" target="_blank">comdev mailing list</a>.
# The Apache Project Maturity Model
-Each item in the model has a unique ID to allow them to be easily referenced elsewhere.
+Each item in the model has a unique ID to allow it to be easily referenced elsewhere.
## Code
<dl>
<dt id="CD10">CD10</dt>
<dd>
-The project produces Open Source software, for distribution to the public at no charge.
+The project produces Open Source software for distribution to the public, at no charge.
<sup><a href="#fnref-a2e0cd066fd8f45af4e87bcdbf8d9abd3ad40872" id="fndef-a2e0cd066fd8f45af4e87bcdbf8d9abd3ad40872-0">1</a></sup>
</dd>
<dt id="CD20">CD20</dt>
<dd>
-The project's code is easily discoverable and publicly accessible.
+Anyone can easily discover and access the project's code.
</dd>
<dt id="CD30">CD30</dt>
<dd>
-The code can be built in a reproducible way using widely available standard tools.
+Anyone using standard, widely-available tools, can built the code can be built in a reproducible way.
</dd>
<dt id="CD40">CD40</dt>
<dd>
The full history of the project's code is available via a source code
-control system, in a way that allows any released version to be
-recreated.
+control system, in a way that allows anyone to recreate any released version.
</dd>
<dt id="CD50">CD50</dt>
<dd>
-The provenance of each line of code is established via the source code control system, in a reliable way based on strong authentication of the
-committer. When third-party contributions are committed, commit messages provide reliable information about the code provenance.
+The source code control system establishes the provenance of each line of code in a reliable way, based on strong authentication of the
+committer. When thirdparties contribute code, commit messages provide reliable information about the code provenance.
Review comment:
When third parties contribute code,
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -373,17 +366,17 @@ contributions but grant the ASF a perpetual copyright license for them.
<li>
<a id="fnref-9b0cf71f04bcd81dddbf6199f1c771e27566611e"></a>
- For Apache projects, <a class="http" href="https://www.apache.org/foundation/voting.html">https://www.apache.org/foundation/voting.html</a> defines the voting rules.
+ For Apache projects, <a class="http" href="https://www.apache.org/foundation/voting.html" target="_blank">https://www.apache.org/foundation/voting.html</a> defines the voting rules.
(<a href="#fndef-9b0cf71f04bcd81dddbf6199f1c771e27566611e-9">10</a>)
</li>
<li>
<a id="fnref-d9e7a517f046358463f038f3830fef171e69f78b"></a>
-Apache projects have a private mailing list that their PMC is expected to use
+Each Apache project has a private mailing list that its PMC is expected to use
only when really needed. The private list is typically used for
discussions about people, for example to discuss and to vote on PMC
Review comment:
for example to discuss and to vote on PMC and committer candidates.
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -63,7 +62,7 @@ committer. When third-party contributions are committed, commit messages provide
<dl>
<dt id="LC10">LC10</dt>
-<dd>The code is released under the Apache License, version 2.0.
+<dd>The Apache License, verison 2.0, covers the released code.
Review comment:
The Apache License, version 2.0
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -6,54 +6,53 @@ The **Apache Project Maturity Model** provides a suggested framework for evaluat
# Overview
-The goal of this maturity model is to describe how Apache projects operate, in a concise and high-level way, and to provide a basic framework that projects may choose to use to evaluate themselves.
+The goals of this maturity model are to describe how Apache projects operate in a concise and high-level way, and to provide a basic framework that projects may choose to use to evaluate themselves.
-It is meant to be usable outside of Apache as well, for projects that might want to adopt some or all of these principles. Projects that envision moving to Apache at some point might start working towards this to prepare for their move.
+It is usable outside of Apache as well, for projects that might want to adopt some or all of these principles. Projects that envision moving to Apache at some point might start working towards this to prepare for their move.
-It does not describe all the details of how our projects operate, but aims to capture the invariants of Apache projects and point to additional information where needed. To keep the main model as concise as possible we use footnotes for anything that's not part of the core model.
+It does not describe all the details of how our projects operate, but aims to capture the invariants of Apache projects and point to additional information where needed. To be as concise as possible we use footnotes for anything that's not part of the core model.
-Contrary to other maturity models, we do not define staged partial compliance levels. A mature Apache project complies with all the elements of this model, and other projects are welcome to pick and choose the elements that suit their goals.
+Contrary to other maturity models, we do not define staged partial compliance levels. A mature Apache project complies with all the elements of this model, and other projects are welcome to adopt the elements that suit their goals.
Note that we try to avoid using the word "must" below. The model describes the state of a mature project, as opposed to a set of rules.
-Projects which incubate at Apache might not fit into all the parts of this model, however a major goal of incubation is to bring the project's community closer to it.
+Projects which incubate at Apache might not fit into all the parts of this model; however a major goal of incubation is to bring the project's community closer to it.
-Questions and feedback about this model are welcome on the <a href="https://lists.apache.org/list.html?dev@community.apache.org">comdev mailing list</a>.
+We welcome qQuestions and feedback about this model on the <a href="https://lists.apache.org/list.html?dev@community.apache.org" target="_blank">comdev mailing list</a>.
# The Apache Project Maturity Model
-Each item in the model has a unique ID to allow them to be easily referenced elsewhere.
+Each item in the model has a unique ID to allow it to be easily referenced elsewhere.
## Code
<dl>
<dt id="CD10">CD10</dt>
<dd>
-The project produces Open Source software, for distribution to the public at no charge.
+The project produces Open Source software for distribution to the public, at no charge.
<sup><a href="#fnref-a2e0cd066fd8f45af4e87bcdbf8d9abd3ad40872" id="fndef-a2e0cd066fd8f45af4e87bcdbf8d9abd3ad40872-0">1</a></sup>
</dd>
<dt id="CD20">CD20</dt>
<dd>
-The project's code is easily discoverable and publicly accessible.
+Anyone can easily discover and access the project's code.
</dd>
<dt id="CD30">CD30</dt>
<dd>
-The code can be built in a reproducible way using widely available standard tools.
+Anyone using standard, widely-available tools, can built the code can be built in a reproducible way.
Review comment:
Anyone using standard, widely-available tools can build the code in a reproducible way.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] adityasharma7 commented on a change in pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
adityasharma7 commented on a change in pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#discussion_r539170026
##########
File path: source/apache-way/apache-project-maturity-model.md
##########
@@ -6,54 +6,53 @@ The **Apache Project Maturity Model** provides a suggested framework for evaluat
# Overview
-The goal of this maturity model is to describe how Apache projects operate, in a concise and high-level way, and to provide a basic framework that projects may choose to use to evaluate themselves.
+The goals of this maturity model are to describe how Apache projects operate in a concise and high-level way, and to provide a basic framework that projects may choose to use to evaluate themselves.
-It is meant to be usable outside of Apache as well, for projects that might want to adopt some or all of these principles. Projects that envision moving to Apache at some point might start working towards this to prepare for their move.
+It is usable outside of Apache as well, for projects that might want to adopt some or all of these principles. Projects that envision moving to Apache at some point might start working towards this to prepare for their move.
-It does not describe all the details of how our projects operate, but aims to capture the invariants of Apache projects and point to additional information where needed. To keep the main model as concise as possible we use footnotes for anything that's not part of the core model.
+It does not describe all the details of how our projects operate, but aims to capture the invariants of Apache projects and point to additional information where needed. To be as concise as possible we use footnotes for anything that's not part of the core model.
-Contrary to other maturity models, we do not define staged partial compliance levels. A mature Apache project complies with all the elements of this model, and other projects are welcome to pick and choose the elements that suit their goals.
+Contrary to other maturity models, we do not define staged partial compliance levels. A mature Apache project complies with all the elements of this model, and other projects are welcome to adopt the elements that suit their goals.
Note that we try to avoid using the word "must" below. The model describes the state of a mature project, as opposed to a set of rules.
-Projects which incubate at Apache might not fit into all the parts of this model, however a major goal of incubation is to bring the project's community closer to it.
+Projects which incubate at Apache might not fit into all the parts of this model; however a major goal of incubation is to bring the project's community closer to it.
-Questions and feedback about this model are welcome on the <a href="https://lists.apache.org/list.html?dev@community.apache.org">comdev mailing list</a>.
+We welcome qQuestions and feedback about this model on the <a href="https://lists.apache.org/list.html?dev@community.apache.org" target="_blank">comdev mailing list</a>.
Review comment:
```suggestion
We welcome Questions and feedback about this model on the <a href="https://lists.apache.org/list.html?dev@community.apache.org" target="_blank">comdev mailing list</a>.
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] swapnilmmane commented on pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
swapnilmmane commented on pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#issuecomment-874112299
Thank you @bdelacretaz!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] bdelacretaz merged pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
bdelacretaz merged pull request #25:
URL: https://github.com/apache/comdev-site/pull/25
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] swapnilmmane commented on pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
swapnilmmane commented on pull request #25:
URL: https://github.com/apache/comdev-site/pull/25#issuecomment-874112299
Thank you @bdelacretaz!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org
[GitHub] [comdev-site] bdelacretaz merged pull request #25: Update apache-project-maturity-model.md
Posted by GitBox <gi...@apache.org>.
bdelacretaz merged pull request #25:
URL: https://github.com/apache/comdev-site/pull/25
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org