7416b05b81
This PR: - reorganizes all documentation pages so they live in the right category - removes lots of legacy docs - contains many improvements to active documentation pages Geth user documentation is now spread across five major categories: - Install and Build: installation and compile instructions - Using Geth: this is for pages about general geth usage. - For dApp Developers: this is for programming guides and functionality specific to dapp development. All the dev guides for mobile framework and Go APIs live here. - JSON-RPC APIs: this has its own section because there is now a sub-page for every name space. I have also added an overview text that explains how to set up the API servers. - For Geth Developers: this is for geth contributors
58 lines
2.4 KiB
Markdown
58 lines
2.4 KiB
Markdown
---
|
|
title: Issue Handling Workflow
|
|
sort_key: B
|
|
---
|
|
|
|
### (Draft proposal)
|
|
|
|
Keep the number of open issues under 820
|
|
|
|
Keep the ratio of open issues per all issues under 13%
|
|
|
|
Have 50 issues labelled [help wanted](https://github.com/ethereum/go-ethereum/labels/help%20wanted) and 50 [good first issue](https://github.com/ethereum/go-ethereum/labels/good%20first%20issue).
|
|
|
|
Use structured labels of the form `<category>:<label>` or if need be `<category>:<main>/<sub>`, for example `area: plugins/foobuzzer`.
|
|
|
|
Use the following labels. Areas and statuses depend on the application and workflow.
|
|
- area
|
|
- `area: android`
|
|
- `area: clef`
|
|
- `area: network`
|
|
- `area: swarm`
|
|
- `area: whisper`
|
|
- type
|
|
- `type: bug`
|
|
- `type: feature`
|
|
- `type: documentation`
|
|
- `type: discussion`
|
|
- status
|
|
- `status: PR review`
|
|
- `status: community working on it`
|
|
- need
|
|
- `need: more info`
|
|
- `need: steps to reproduce`
|
|
- `need: investigation`
|
|
- `need: decision`
|
|
|
|
Use these milestones
|
|
- [Future](https://github.com/ethereum/go-ethereum/milestone/80) - Maybe implement one day
|
|
- [Coming soon](https://github.com/ethereum/go-ethereum/milestone/81) - Not assigned to a specific release, but to be delivered in one of the upcoming releases
|
|
- \<next version\> - Next release with a version number
|
|
- \<next-next version\> - The version after the next release with a version number
|
|
- \<next major release\> - Optional.
|
|
|
|
It's ok to not set a due date for a milestone, but once you release it, close it. If you have a few issues dangling, consider moving them to the next milestone, and close this one.
|
|
|
|
Optionally, use a project board to collect issues of a larger effort that has an end state and overarches multiple releases.
|
|
|
|
## Workflow
|
|
We have a weekly or bi-weekly triage meeting. Issues are preselected by [labelling them "status:triage" and sorted the oldest ones first](https://github.com/ethereum/go-ethereum/issues?q=is%3Aopen+is%3Aissue+label%3Astatus%3Atriage+sort%3Acreated-asc). This is when we go through the new issues and do one of the following
|
|
1. Close it.
|
|
1. Assign it to "Coming soon" milestone which doesn't have an end date.
|
|
1. Move it to the "Future" milestone.
|
|
1. Change its status to "Need:\<what-is-needed\>".
|
|
|
|
Optional further activities:
|
|
* Label the issue with the appropriate area/component.
|
|
* Add a section to the FAQ or add a wiki page. Link to it from the issue.
|