git: 84b6b11b34 - main - Status/2024Q2/Github.adoc: Add report

From: Warner Losh <imp_at_FreeBSD.org>
Date: Mon, 08 Jul 2024 03:20:57 UTC
The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/doc/commit/?id=84b6b11b348102cadbda2f5e6525acc726d55b4a

commit 84b6b11b348102cadbda2f5e6525acc726d55b4a
Author:     Warner Losh <imp@FreeBSD.org>
AuthorDate: 2024-07-08 03:12:42 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-07-08 03:16:26 +0000

    Status/2024Q2/Github.adoc: Add report
    
    Add quick report on the github pull request experiment and the efforts
    to automate it to help with recruiting.
---
 .../en/status/report-2024-04-2024-06/github.adoc   | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/website/content/en/status/report-2024-04-2024-06/github.adoc b/website/content/en/status/report-2024-04-2024-06/github.adoc
new file mode 100644
index 0000000000..38314811ca
--- /dev/null
+++ b/website/content/en/status/report-2024-04-2024-06/github.adoc
@@ -0,0 +1,28 @@
+=== FreeBSD Github Pull Request Report
+
+Links: +
+link:https://wiki.freebsd.org/WorkingGroup/Github[Github Working Group wiki page] URL: link:https://wiki.freebsd.org/WorkingGroup/Github[]
+
+Contact: Warner Losh <imp@FreeBSD.org>
+
+The FreeBSD Project has been trying an experiment to accpet contributions via github pull requests.
+We've leared a lot in the last year that we've been doing this.
+We've created a number of rules relating to the pull requests.
+In general, pull requests should only be for things that are user-visible, add value to the project and are ready to go, modulo final review.
+
+At this point, we're able to keep up with the pull requests doing everything by hand.
+This has proven to be tedious and error prone.
+While the vast majority of the pull requests have been fine, but we have introduced a few problems.
+We've started working on scripting to automate staging and landing in the tree.
+
+We need help with automating the process:
+* Adding the ability to batch multiple pull requests
+* Add automated testing that's context specific (eg, run igor over man pages)
+* Add build/install tests that test boot the resulting image
+* Integrate CI we currently do post-commit so we can do it before for these changes.
+
+We are coordinating on FreeBSD's Discord in the #githib-hacking channel.
+
+Once we have things finded tuned, we'll be looking to expand this by doing publicity to steer contributors to at least the base system to github.
+We'll also need more developers to review and land pull requests once it's automated that the automation has matured.
+We sincerely hope that we can improve the FreeBSD contribution experience with this, as well as gain useful fixes from the community.