Skip to content

Improve Contributing docs and set a release schedule#37109

Open
bircni wants to merge 7 commits intogo-gitea:mainfrom
bircni:improve_contrib
Open

Improve Contributing docs and set a release schedule#37109
bircni wants to merge 7 commits intogo-gitea:mainfrom
bircni:improve_contrib

Conversation

@bircni
Copy link
Copy Markdown
Member

@bircni bircni commented Apr 4, 2026

This PR updates CONTRIBUTING.md for clarity (code review, maintainers, PR workflow)

Suggestion

  • majors about every three months, with a more predictable cadence from v1.26 onward.
  • target dates such as v1.26.0 (April 2026), v1.27.0 (June 2026), v1.28.0 (September 2026), v1.29.0 (December 2026).
  • announce feature freeze two weeks before each release.

Other doc changes

  • Reviewing PRs: separate guidance for reviewers vs authors; small edits to maintaining PRs, merge queue, commit messages, co-authors.
  • Maintainers: clearer subsections; links to GitHub Docs for 2FA / GPG.

@GiteaBot GiteaBot added the lgtm/need 2 This PR needs two approvals by maintainers to be considered for merging. label Apr 4, 2026
@bircni bircni changed the title Improve contrib Improve Contributing docs and set a release schedule Apr 4, 2026
@bircni
Copy link
Copy Markdown
Member Author

bircni commented Apr 4, 2026

Replaces #36686

@wxiaoguang
Copy link
Copy Markdown
Contributor


By the way, I was thinking about splitting the CONTRIBUTING.md into different files.

There are too many contents mixed together in CONTRIBUTING.md, many of them are for maintainers only, not needed by contributors.

In my mind, some files:

  1. CONTRIBUTING.md: only contains the useful information for new contributors, and link to other files
  2. docs/guideline-frontend.md
  3. docs/guideline-backend.md
  4. docs/community-governance.md
  5. docs/release-management.md

Otherwise, the all-in-one file which has more than thousand of lines (wrapping....) is difficult to read, and the useful information can be easily ignored (for example: don't rebase+force-push)

@bircni
Copy link
Copy Markdown
Member Author

bircni commented Apr 5, 2026

By the way, I was thinking about splitting the CONTRIBUTING.md into different files.
There are too many contents mixed together in CONTRIBUTING.md, many of them are for maintainers only, not needed by contributors.
In my mind, some files:

  1. CONTRIBUTING.md: only contains the useful information for new contributors, and link to other files
  2. docs/guideline-frontend.md
  3. docs/guideline-backend.md
  4. docs/community-governance.md
  5. docs/release-management.md

Otherwise, the all-in-one file which has more than thousand of lines (wrapping....) is difficult to read, and the useful information can be easily ignored (for example: don't rebase+force-push)

Done

@GiteaBot GiteaBot added lgtm/need 1 This PR needs approval from one additional maintainer to be merged. and removed lgtm/need 2 This PR needs two approvals by maintainers to be considered for merging. labels Apr 5, 2026
@bircni bircni requested review from lafriks and wxiaoguang April 5, 2026 17:30
@silverwind
Copy link
Copy Markdown
Member

We can do a slightly less-than-perfect 1.26.0 now, bug fixes will happen regardless and the more often we release, the easier they are to backport because branches diverge over time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lgtm/need 1 This PR needs approval from one additional maintainer to be merged. modifies/docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants