Differences

This shows you the differences between two versions of the page.

--- github [2023/10/17 18:51] – For pull requests: where previously there was one long paragraph, now four short paragraphs with content that should be easier to comprehend. GrahamPerrin
+++ github [2023/10/18 07:13] (current) – Refer to 'How to Become a FreeBSD Translator' for pull requests that are translation submissions. GrahamPerrin
@@ Line 1: / Line 1: @@
 ===== 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.
-For repositories where pull requests (PRs) are not officially accepted:
-  * some Project members may process requests
-  * the recommended method for submitting changes is via [[Bugzilla]].
 ===== Repositories =====
@@ Line 14: / Line 9: @@
   * [[https://github.com/freebsd/freebsd-doc|freebsd-doc]] — %%FreeBSD%% Documentation Project (FDP)
     * 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
     * pull requests are [[https://docs.freebsd.org/en/articles/contributing/#contrib-general|subject to the whims of developers]]
@@ Line 33: / Line 29: @@
   * [[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.
-===== 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) =====
@@ Line 49: / Line 39: @@
 A PR may require maintainer approval, which we'll try to facilitate. If approval is not timely: consider [[https://www.freebsd.org/community/mailinglists/|mailing lists]], [[Bugzilla]], [[Phabricator]], or direct contact with maintainers.
+For repositories where PRs are not officially accepted:
+  * some Project members may process requests
+  * 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 =====
-There are webhooks configured on some %%FreeBSD%% Organisation repositories. This section details who configured them and what they're in use for. All external configurations or integrations should be listed here.
+Webhooks are configured on some repositories. This section details the purpose of each hook, and who configured it.
+All external configurations or integrations should be listed here.
   * IRC Messages for commit events:
     * Endpoint: n.tkte.ch Purpose: IRC (freenode) commit events
-    * Repositories: freebsd-src, freebsd-ports, freebsd-doc
+    * Repositories: freebsd-doc, freebsd-ports, freebsd-src
     * Contact: KubilayKocak
   * Discord Messages for commit events:
     * Endpoint: dev.wired.sh Purpose: [[Discord]] commit events
-    * Repositories: freebsd-src, freebsd-ports, freebsd-doc
+    * Repositories: freebsd-doc, freebsd-ports, freebsd-src
     * Contact: KubilayKocak LewisCook
 ===== 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]]
 ----