Back to Codeberg

WIP: docs: CONTRIBUTING.md #517

forgejo-contrib-forgejo-cli-pulls-517.md

latest11.6 KB
Original Source

forgejo-contrib/forgejo-cli

Watch20

Star402

Fork

You've already forked forgejo-cli

51

CodeIssues 44Pull requests 8Releases 11Packages 2WikiActivity

WIP: docs: CONTRIBUTING.md #517

Draft

Cyborus wants to merge 5 commits from docs/contributing into main

pull from: docs/contributing

merge into: forgejo-contrib:main

forgejo-contrib:main

forgejo-contrib:renovate/lock-file-maintenance

forgejo-contrib:renovate/serde-saphyr-0.x

forgejo-contrib:no-port-in-refspec

forgejo-contrib:login/v16.next.forgejo.org

forgejo-contrib:crates-io-publish

forgejo-contrib:0.5.x

forgejo-contrib:compile-time-fluent

forgejo-contrib:0.4.x

forgejo-contrib:localization-alias-demo

forgejo-contrib:api_url_field

Conversation 0Commits 5Files changed 1 +39

Cyborus commented 2026-06-24 02:35:47 +02:00

Member

Copy link

Changes Made

Adds documentation on how to contribute to the project.

Code of Conduct

  • I agree to act in accordance with the CoC & AI Agreement.
  • This contribution was not generated by an LLM, even in part.

Changes Made Adds documentation on how to contribute to the project. ### Code of Conduct - [x] I agree to act in accordance with the CoC & AI Agreement. - [x] This contribution was not generated by an LLM, even in part.

Cyborus added 5 commits 2026-06-24 02:35:47 +02:00

docs: outline of CONTRIBUTING.md adcd583f36

docs(contributing): add greeting 2f2a7823f0

docs(contributing): add CoC section 8b85c56a3f

docs(contributing): add code style section 0f8c02991f

docs(contributing): add localization section

All checks were successful

ci/woodpecker/pr/check-typos Pipeline was successful

Details

ci/woodpecker/pr/check Pipeline was successful

Details

ci/woodpecker/pr/check-clippy Pipeline was successful

Details

8b8b8dabb4

Fluffinity reviewed 2026-06-24 11:26:42 +02:00

CONTRIBUTING.md

| | | | @ -0,0 +20,4 @@ | | | | | | | | | | | | Commit messages should follow the [Conventional Commit standard](https://www.conventionalcommits.org/en/v1.0.0/). There's no expectation for pull request titles to follow this though. | | | | | | | | | | | | ### Adding commands |

Fluffinity commented 2026-06-24 11:26:42 +02:00

Contributor

Copy link

How about the following content for that section:

md
If you want to add new functionality to `forgejo-cli`, try to add it at the lowest scope possible. So if that functionality merely augments an existing subcommand it should be implemented as an argument, i.e `fj <command> <subcommand> --my-new-flag`. New subcommands can be created if that functionality instead represents a new operation in an existing category. For example, if you intent to add a new operation interacting with repos, adding a `fj repo <my-new-subcommand>` subcommand would be appropriate. There should not be any need for new top-level commands. If you believe a new one to be necessary for your functionality you should discuss this with a maintainer first.

How about the following content for that section: md If you want to add new functionality to `forgejo-cli`, try to add it at the lowest scope possible. So if that functionality merely augments an existing subcommand it should be implemented as an argument, i.e `fj \<command\> \<subcommand\> --my-new-flag`. New subcommands can be created if that functionality instead represents a new operation in an existing category. For example, if you intent to add a new operation interacting with repos, adding a `fj repo \<my-new-subcommand\>` subcommand would be appropriate. There should not be any need for new top-level commands. If you believe a new one to be necessary for your functionality you should discuss this with a maintainer first.

All checks were successful Hide all checks

ci/woodpecker/pr/check-typos Pipeline was successful

Details

ci/woodpecker/pr/check Pipeline was successful

Required Details

ci/woodpecker/pr/check-clippy Pipeline was successful

Details

This pull request is marked as a work in progress.

This branch is out-of-date with the base branch

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin docs/contributing:docs/contributing

git switch docs/contributing

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels[ Kind/Breaking Breaking change that won't be backward compatible

](#)[ Kind/Bug Something is not working

](#)[ Kind/Design Discussion about UI/UX design

](#)[ Kind/Documentation Documentation changes

](#)[ Kind/Enhancement Improve existing functionality

](#)[ Kind/Feature New functionality

](#)[ Kind/Security This is security issue

](#)[ Kind/Testing Issue or pull request related to testing

](#)[ Kind/Upstream This is an issue with upstream software (Forgejo) that is probably not our fault

](#)

[ Priority

Critical The priority is critical

](#)[ Priority

High The priority is high

](#)[ Priority

Low The priority is low

](#)[ Priority

Medium The priority is medium

](#)

[ Reviewed

Confirmed Issue has been confirmed

](#)[ Reviewed

Duplicate This issue or pull request already exists

](#)[ Reviewed

Invalid Invalid issue

](#)[ Reviewed

Won't Fix This issue won't be fixed

](#)

[ Status

Abandoned Somebody has started to work on this but abandoned work

](#)[ Status

Blocked Something is blocking this issue or pull request

](#)[ Status

Need More Info Feedback is required to reproduce issue or to continue work

](#)

[ Suspicious

](#)

No labels Kind/Breaking Kind/Bug Kind/Design Kind/Documentation Kind/Enhancement Kind/Feature Kind/Security Kind/Testing Kind/Upstream [ Priority

Critical ](/forgejo-contrib/forgejo-cli/pulls?labels=173012) [ Priority

High ](/forgejo-contrib/forgejo-cli/pulls?labels=173013) [ Priority

Low ](/forgejo-contrib/forgejo-cli/pulls?labels=173015) [ Priority

Medium ](/forgejo-contrib/forgejo-cli/pulls?labels=173014) [ Reviewed

Confirmed ](/forgejo-contrib/forgejo-cli/pulls?labels=173007) [ Reviewed

Duplicate ](/forgejo-contrib/forgejo-cli/pulls?labels=173005) [ Reviewed

Invalid ](/forgejo-contrib/forgejo-cli/pulls?labels=173006) [ Reviewed

Won't Fix ](/forgejo-contrib/forgejo-cli/pulls?labels=173008) [ Status

Abandoned ](/forgejo-contrib/forgejo-cli/pulls?labels=173011) [ Status

Blocked ](/forgejo-contrib/forgejo-cli/pulls?labels=173010) [ Status

Need More Info ](/forgejo-contrib/forgejo-cli/pulls?labels=173009) Suspicious

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

forgejo-contrib/forgejo-cli!517

WritePreview

Loading…

Add table

| Rows | | | Columns | |

CancelOK

Add a link

Url Description Hint: With a URL in your clipboard, you can paste directly into the editor to create a link.

CancelOK

CancelSave

Reference in a new issue

Repository

forgejo-contrib/forgejo-cli

Title

Body

Create issue

No description provided.

Delete branch "docs/contributing"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

No Yes