[PR] Another one - proposal for "Community building" why description [comdev-working-groups]

2024-03-29 Thread via GitHub


potiuk opened a new pull request, #35:
URL: https://github.com/apache/comdev-working-groups/pull/35

   Continuuation from the previous whys - this one also inspired by some of the 
recent discussions on the authors/original authors and generally explaining the 
red-flags listed already.
   
   Looking forward to comments.


-- 
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: notifications-unsubscr...@community.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] Adds practical community building advice. [comdev-site]

2024-03-29 Thread via GitHub


jbonofre commented on code in PR #174:
URL: https://github.com/apache/comdev-site/pull/174#discussion_r1544702478


##
source/pmc/community-growth.md:
##
@@ -0,0 +1,82 @@
+---
+title: Community Growth
+tags: ["pmc","committers","community"]
+---
+
+Growing your project community takes work. This document makes practical
+suggestions of how to encourage people to get involved in your project.
+
+## Publish a road map
+
+Volunteers can work on whatever they want, and so we have a tendency to
+not want to tell them what to work on. However, publishing a roadmap, or
+even a wishlist of features or improvements that are desired, can give
+people an idea of where they might be able to get involved.
+
+This also gives a clear sense that the project has ambitions, and is
+going somewhere, rather than that it is stagnating.
+
+## Periodically publish the open issue list
+
+Your ticket tracker allows you to periodically summarize the open

Review Comment:
   I would also to propose:
   1. Tag some issues as "low hanging fruits" allowing new contributor to ramp 
up
   2. For PR and issue, I would propose to send reminder to PRs/issues not 
recently updated (to avoid stale ones)
   3. A good idea is also default assignee that can provide a first answer and 
add other people to help the contributor (mentoring process).



##
source/pmc/community-growth.md:
##
@@ -0,0 +1,82 @@
+---
+title: Community Growth
+tags: ["pmc","committers","community"]
+---
+
+Growing your project community takes work. This document makes practical
+suggestions of how to encourage people to get involved in your project.
+
+## Publish a road map
+
+Volunteers can work on whatever they want, and so we have a tendency to
+not want to tell them what to work on. However, publishing a roadmap, or
+even a wishlist of features or improvements that are desired, can give
+people an idea of where they might be able to get involved.
+
+This also gives a clear sense that the project has ambitions, and is
+going somewhere, rather than that it is stagnating.

Review Comment:
   Concretely, it's challenging to maintain a roadmap page on website.
   
   I would propose to "tag" issues with `proposal` or `roadmap` and 
extract/link this on website.
   That's probably the best approach to keep this up to date and accurate.



##
source/pmc/community-growth.md:
##
@@ -0,0 +1,82 @@
+---
+title: Community Growth
+tags: ["pmc","committers","community"]
+---
+
+Growing your project community takes work. This document makes practical
+suggestions of how to encourage people to get involved in your project.
+
+## Publish a road map
+
+Volunteers can work on whatever they want, and so we have a tendency to
+not want to tell them what to work on. However, publishing a roadmap, or
+even a wishlist of features or improvements that are desired, can give
+people an idea of where they might be able to get involved.
+
+This also gives a clear sense that the project has ambitions, and is
+going somewhere, rather than that it is stagnating.
+
+## Periodically publish the open issue list
+
+Your ticket tracker allows you to periodically summarize the open
+issues. Sending this to the dev@ list reminds people that there are
+things to work on, and gives them permission, and encouragement, to do
+so.
+
+## Clearly document contribution processes
+
+Double-check that your "how to contribute / build / test / submit PR"
+documentation is super clear and easy to follow.  Long-time committers
+on a project often forget all the institutional knowledge they just
+"know", so ensuring the "getting started" document actually works
+for newcomers is always worth looking at.
+
+Encourage newcomers to talk about, and document, their pain points

Review Comment:
   I would also mention the proposal process: how to submit new ideas ? how to 
be sure no proposal is lost or stale for too long ? how to track the proposals 
under discussion ?



##
source/pmc/community-growth.md:
##
@@ -0,0 +1,82 @@
+---
+title: Community Growth
+tags: ["pmc","committers","community"]
+---
+
+Growing your project community takes work. This document makes practical
+suggestions of how to encourage people to get involved in your project.
+
+## Publish a road map
+
+Volunteers can work on whatever they want, and so we have a tendency to
+not want to tell them what to work on. However, publishing a roadmap, or
+even a wishlist of features or improvements that are desired, can give
+people an idea of where they might be able to get involved.
+
+This also gives a clear sense that the project has ambitions, and is
+going somewhere, rather than that it is stagnating.
+
+## Periodically publish the open issue list
+
+Your ticket tracker allows you to periodically summarize the open
+issues. Sending this to the dev@ list reminds people that there are
+things to work on, and gives them permission, and encouragement, to do
+so.
+
+## Clearly document contribution 

Re: [PR] Propose "why" explanation on discussions and decision making [comdev-working-groups]

2024-03-29 Thread via GitHub


rbowen merged PR #29:
URL: https://github.com/apache/comdev-working-groups/pull/29


-- 
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: notifications-unsubscr...@community.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] Adding the “The Apache Way of Open Source” slides from re:publica 2018 [comdev-site]

2024-03-29 Thread via GitHub


rbowen merged PR #173:
URL: https://github.com/apache/comdev-site/pull/173


-- 
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: notifications-unsubscr...@community.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



[PR] Adds practical community building advice. [comdev-site]

2024-03-29 Thread via GitHub


rbowen opened a new pull request, #174:
URL: https://github.com/apache/comdev-site/pull/174

   Adds a new document, inspired by conversations with one of our projects in 
this situation, suggesting practical steps that a project can take to attract 
new contributors.


-- 
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: notifications-unsubscr...@community.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



[PR] Proposed template to answer an offer to contribute to a project [comdev-working-groups]

2024-03-29 Thread via GitHub


rbowen opened a new pull request, #34:
URL: https://github.com/apache/comdev-working-groups/pull/34

   This is taken from a response just sent to a dev list, and made more generic.


-- 
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: notifications-unsubscr...@community.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org



Re: [PR] Proposed template to answer an offer to contribute to a project [comdev-working-groups]

2024-03-29 Thread via GitHub


rbowen merged PR #34:
URL: https://github.com/apache/comdev-working-groups/pull/34


-- 
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: notifications-unsubscr...@community.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org