| Both sides previous revision Previous revision Next revision | Previous revision |
| github [2023/10/17 19:00] – Reduce scatter. Logically, the lone paragraph about pull requests should be in the pull requests section. GrahamPerrin | github [2023/10/18 07:13] (current) – Refer to 'How to Become a FreeBSD Translator' for pull requests that are translation submissions. GrahamPerrin |
|---|
| ===== GitHub ===== | ===== GitHub ===== |
| |
| %%FreeBSD%% maintains a GitHub presence, with the [[https://github.com/freebsd|FreeBSD GitHub Organisation]], its repositories, svn2git integration and mirroring managed by [[GitAdmin]]. | https://github.com/freebsd — the %%FreeBSD%% organisation on GitHub. |
| |
| ===== Repositories ===== | ===== Repositories ===== |
| * [[https://github.com/freebsd/freebsd-doc|freebsd-doc]] — %%FreeBSD%% Documentation Project (FDP) | * [[https://github.com/freebsd/freebsd-doc|freebsd-doc]] — %%FreeBSD%% Documentation Project (FDP) |
| * pull requests are accepted | * pull requests are accepted |
| * [[https://docs.freebsd.org/en/articles/contributing/#contrib-general|no guidelines/policy for PRs]] | * translation submissions are mentioned under [[https://docs.freebsd.org/en/books/fdp-primer/weblate/#weblate-become-translator|How to Become a FreeBSD Translator]] in the %%FreeBSD%% Documentation Project Primer for New Contributors |
| | * [[https://docs.freebsd.org/en/articles/contributing/#contrib-general|no guidelines/policy for other types of PR]] |
| * [[https://github.com/freebsd/freebsd-ports|freebsd-ports]] — the ports collection | * [[https://github.com/freebsd/freebsd-ports|freebsd-ports]] — the ports collection |
| * pull requests are [[https://docs.freebsd.org/en/articles/contributing/#contrib-general|subject to the whims of developers]] | * pull requests are [[https://docs.freebsd.org/en/articles/contributing/#contrib-general|subject to the whims of developers]] |
| * [[https://github.com/freebsd/portmaster|portmaster]] — port management script without external databases or languages | * [[https://github.com/freebsd/portmaster|portmaster]] — port management script without external databases or languages |
| * [[https://github.com/freebsd/poudriere|poudriere]] — port/package build and test system. | * [[https://github.com/freebsd/poudriere|poudriere]] — port/package build and test system. |
| |
| ===== Joining ===== | |
| |
| Requests to be added to the [[https://github.com/freebsd|FreeBSD GitHub Organisation]] can be made via [[https://bugs.freebsd.org/bugzilla/buglist.cgi?product=Services&component=Git%20Integration&resolution=---|Bugzilla]] (Product: Services, Component: Git Integration). Please include details of any teams you are a member of or hats you wear so that this can be reflected in GitHub. | |
| |
| Currently, in almost all cases, only those with @%%FreeBSD%%.org accounts are approved. External users //may// apply to be a part of the organisation if a compelling case can be made. Examples may be external contributors that require write (commit) access to a %%FreeBSD%% repository other than src, ports, and doc that is hosted within the organisation account. | |
| |
| ===== Pull Requests (PRs) ===== | ===== Pull Requests (PRs) ===== |
| * some Project members may process requests | * some Project members may process requests |
| * the recommended approach to code changes is [[Bugzilla]]. | * the recommended approach to code changes is [[Bugzilla]]. |
| | |
| | ===== Joining the Organisation ===== |
| | |
| | Requests to be added to the [[https://github.com/freebsd|FreeBSD GitHub Organisation]] can be made via [[https://bugs.freebsd.org/bugzilla/buglist.cgi?product=Services&component=Git%20Integration&resolution=---|Bugzilla]] (Product: Services, Component: Git Integration). Please include details of any teams you are a member of or hats you wear so that this can be reflected in GitHub. |
| | |
| | Currently, in almost all cases, only those with @%%FreeBSD%%.org accounts are approved. External users //may// apply to be a part of the organisation if a compelling case can be made. Examples may be external contributors that require write (commit) access to a %%FreeBSD%% repository other than src, ports, and doc that is hosted within the organisation account. |
| |
| ===== Webhooks ===== | ===== Webhooks ===== |
| ===== Contact ===== | ===== Contact ===== |
| |
| * For general questions, email [[GitAdmin#Contact|Git Admin]] | The [[https://github.com/freebsd|organisation]], its repositories, and mirroring, are managed by the [[GitAdmin|Git Admin]] team. |
| * For change requests (new repositories, permissions, etc), please create an issue in [[https://bugs.freebsd.org/bugzilla/buglist.cgi?product=Services&component=Git%20Integration&resolution=---|Bugzilla -- Services:Git Integration]] | |
| | For general questions, email [[GitAdmin#Contact|Git Admin]]. |
| | |
| | For change requests (new repositories, permissions, etc), please create an issue in [[https://bugs.freebsd.org/bugzilla/buglist.cgi?product=Services&component=Git%20Integration&resolution=---|Bugzilla -- Services:Git Integration]] |
| |
| ---- | ---- |