Clearly describe current project state and how to contribute about incubator-pekko HOT 2 OPEN

@sam-byng , this proposal looks good. I suggest creating a pull request with the changes and a [DISCUSS] tagged message on the dev mailing list pointing to it.

from incubator-pekko.

Responding to the above points in order with some more context and proposals:

1. There is already basic entry in the README contributing section which states "Contributions are very welcome" however yes, more encouragement and clarity on status for potential contributors doesn't feel like a bad thing.

Proposal: Add this

2. For long term, I propose add a comment describing the process:

Release tracking: The Pekko project spans multiple Github repositories. Work required for a whole Pekko project release (multiple repositories) is tracked in the Pekko Github project. Note that due to Apache Software Foundation regulations this cannot be made public and is viewable only by Apache project committers . Therefore non-committers check up on the Github Discussions and dev mailing list to confirm contents of the current in-development release.
On individual git repositories, the work required for releases will be tracked using a Github Milestone on that repository, e.g. the incubator-pekko 1.0.0 Milestone.
Therefore the work required for a Pekko release will be tracked in the Github project and this project will reference the milestones required for each of the repositories it will contain.

And a short term status:

Current status: For the initial Pekko release, we will be initially releasing incubator-pekko 1.0.0 Milestone and incubator-pekko-sbt-paradox.

3. Agreed, it doesn't look like we're using any of these labels on the incubator-pekko issues right now (Issues · apache/incubator-pekko (github.com)) so I would vote to remove this for now.

TODO: Start a discussion on this in mailing list to get some consensus.

4. Will go in mailing list discussion above

5. Propose: Add this.

6. From a newcomers perspective I've spend ~1d looking around the pekko documentation + mailing list and haven't yet got a clear picture of whether we've got a complete list for 1.0.0 requirements or not. # 2 should help this.

from incubator-pekko.