From nobody Mon Jul 8 03:20:57 2024 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4WHTsk13brz5QlST for ; Mon, 08 Jul 2024 03:20:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4WHTsk0bl4z4wk1; Mon, 8 Jul 2024 03:20:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1720408858; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=WIu2F5u0ri3Q9C+LAXd1ZlTZk1bJng3eLSCtJcLPj7s=; b=ZyTTDwKhv970uVndkGRNVvsWh4ORJ/1mhc6/KXRoPpoLKBaffcGpn1cCGkFb4xtyx1VL3x 2Zjp1IVdYu891289StUW/EqhELAmnckHIKnRFk/lCOSRe93B7n/SB7L6y5zRPp8BjNnWC/ cw5yJHc0v0+bJMBnKFXhmph/y31lDzJ3BAN3Ftfbq0RUFSTonspYqgiVkHtCybhchRfawp TvUgvTUgt+pfh34rU+ATW44K3YuvKwaL2eR11wvPpPUnLZ+qn5eDjwVXKjJrttaFEZCOMJ jUqE9uJpPun+fe6TkoZF+X/gfOg9ICc3RUPcFxNFkL3/ngRXhZHh6CDQyoYHSw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1720408858; a=rsa-sha256; cv=none; b=nnZUzPoPYN+xSa8zgXgoPAsG1B5DnORTc5Gn15/X+cnRyX+kvmUrTdLUTlUSXvFx0bE7fx RfR/4+KWP0+TzFKzbZNA4T/QW9JIWCOwa++rbggyQ8gkziaNcC1O5bieWjyF767hayFovl LSEM7fqcwfN1kfnG+1a851/sMmj5wxEA1sGhXVNLNOdLcNmDHcypPdLRRdq0YFo0S0EV6B P2osn2W7qpbqzbIddAJhNXg07SyzTnp2q4U486+SbP7GhkwOL/0uqlHN4Yrcc7E8Nsrrm6 IKH0JQiZEzNZjI7SLZ2fgHssrX0Jhe7eODpNwsD5XKYxAjxe1FkoJ60WpIaILA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1720408858; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=WIu2F5u0ri3Q9C+LAXd1ZlTZk1bJng3eLSCtJcLPj7s=; b=kw4ZFFtz23KrtGbemrR6KVQpWWf2dDVB9hNMGH/yAw09E4tDAUrLQVBxZnMOfRq03/fjlI hoicPxiN0ihkQN3z2jTkVl7+wv3JQHT84fX6mFQkJsn1SGP9oXTmaaTiJ+dwK8sifNOJYi CQ5Yy+fVFIVSv7kku+aeDDQiyDAsCumpOyy0qHg5SIigW7BcIO1yH281i7dbJEEP2SuW6/ /a+BvxQsrhxkznPKSqvkN4CmqhbYKAUqcylJmvFr7OaftU0WGiafV+JLEZc3oEcsj3dFGh m8voZ+F6SrQyZgSDl7ImjUeJBA5RxAfRE+MjCFYvjb+V4GH7VvB1mD4yFrpoaA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4WHTsk0B0tzbDx; Mon, 8 Jul 2024 03:20:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4683Kv4o072977; Mon, 8 Jul 2024 03:20:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4683Kvgi072974; Mon, 8 Jul 2024 03:20:57 GMT (envelope-from git) Date: Mon, 8 Jul 2024 03:20:57 GMT Message-Id: <202407080320.4683Kvgi072974@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 84b6b11b34 - main - Status/2024Q2/Github.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 84b6b11b348102cadbda2f5e6525acc726d55b4a Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=84b6b11b348102cadbda2f5e6525acc726d55b4a commit 84b6b11b348102cadbda2f5e6525acc726d55b4a Author: Warner Losh AuthorDate: 2024-07-08 03:12:42 +0000 Commit: Warner Losh 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 + +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.