From nobody Sun Jul 14 05:38:09 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 4WMDdF4cYXz5QGSZ for ; Sun, 14 Jul 2024 05:38:09 +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 4WMDdF3yT2z49jW; Sun, 14 Jul 2024 05:38:09 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1720935489; 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=D0oZcvJgOCyN/m0CtVVj8oogvRhrhkOPgQ9yO7y/M+o=; b=mj+LcsRb8WTJAb4AaizzKTmdSkzUDYpMIMkcBHMBV5syacCQU7f0ZUg1o1bnoaB2agm0x3 wwlWzvL4d+qEqPTyzsPEz8MeIpiHZxtIzTgW+Hj+CMHsQZU9wmoVxWdisglMFQJ1QyRb6G bpHXZoZRftXWk5yGp+i9RHgqef8MbB9Hi+iMuBuTMsNEJxHqPJhXVrTPc+2mh2rlec+T6d KNrrkCUq99g+ce1eqCNCDjQM5Tm/Zeee+uHShaSpsZ5xLJ8bWhjyHmAB/YXkJJJN+NdGDn jjhWblEvXp0LQaXmFS80RsiIA0fHEhgpYeQthOS/gTIaTBMmD+6iQV4BMN1FuA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1720935489; a=rsa-sha256; cv=none; b=VXmD6u2xt8j/BcFW3Nb32Oi11W0IRrLbxCB7irYIvnRGh0xzR8TGVATKcfRdiqwt9JdrGu okkK0ScLUp6PM8hT43+KDCTM57HrQX6Y3rNcy9RWNa4TkXL8jTlwrwsq0jDt7J2eah6odB Bpk4VzTQq1C2UWtyIzridY5pLiSaH8DIFQU1csb2GPfsfFQN8GmJoZEabxxPIu125jI17h uxXTF/UcR6yA3Qb7jUwSIa+HBgW83UeQt6FpAmJEjj0lwQWBrlWY/6+0Rs2OZ/Zq0emT/u u313ocNWv/9PLZsqAcy6fLj73dhKi4YXdSUnLMHwdmFiSE0DamlQvVD4SsTUWQ== 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=1720935489; 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=D0oZcvJgOCyN/m0CtVVj8oogvRhrhkOPgQ9yO7y/M+o=; b=NJCqbUptqOAoYRbjP47YfrwKSeMD9gqZYE4GEyGSqJRC+jcZwt9ZTXADxWVhDO77v5+MxW QcoEPLltJpa1Rt/Qz72OTFFPrHPXQ86h7U7ycBMj1M45J7XAgZpXOtr/ZqQa204jTGCKlH 1AQ69rFq/fhXWWm6eUyy9jJv5KQoBWPH0v29Jx+0VCWB6mzPqCyJkDxeH5pNt5Hrc/2gAJ odBGI4WzsLI20OBeorpe67mwq/ys3h5LR/xkDWU6+s4bVYQxlyDfkoD8kIQZepzmWb8rZ2 VJYR3gGR0Air7mpqnGbgXv6NOQfhIfvuQVWrjJbCRaXriF6HdlAU89g/4trXyw== 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 4WMDdF3Ls2zxCt; Sun, 14 Jul 2024 05:38:09 +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 46E5c9LT003495; Sun, 14 Jul 2024 05:38:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 46E5c9ih003492; Sun, 14 Jul 2024 05:38:09 GMT (envelope-from git) Date: Sun, 14 Jul 2024 05:38:09 GMT Message-Id: <202407140538.46E5c9ih003492@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: ee5c2fd574 - main - 2024q2 report: fix github report markup 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: ee5c2fd574749dad24d558eaba37a9783e832003 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=ee5c2fd574749dad24d558eaba37a9783e832003 commit ee5c2fd574749dad24d558eaba37a9783e832003 Author: Warner Losh AuthorDate: 2024-07-14 05:26:23 +0000 Commit: Warner Losh CommitDate: 2024-07-14 05:37:26 +0000 2024q2 report: fix github report markup The bullet list wasn't rendering properly, so fix that. Also, although done in the first week of july, we can now do multiple pull requests in one staging branch for CI batch testing, so add that to what we've done, turning that into a bullet list as well. Tweak the lists a little to tighten them up. Add encouragement to join us after telling people where. Noticed by: graham perrin (bullet markup) Sponsored by: Netflix --- .../en/status/report-2024-04-2024-06/github.adoc | 29 ++++++++++++++-------- 1 file changed, 19 insertions(+), 10 deletions(-) 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 index 5ea8718009..f484bbbffe 100644 --- a/website/content/en/status/report-2024-04-2024-06/github.adoc +++ b/website/content/en/status/report-2024-04-2024-06/github.adoc @@ -11,20 +11,29 @@ We have learned a lot in the last year that we've been doing this. We have 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 are able to keep up with the pull requests doing everything by hand. -However, this has proven to be tedious and error-prone. -While the vast majority of the pull requests have been fine, we have introduced a few problems. -We have started working on scripting to automate staging and landing in the tree. +Current status: + +* We are able to keep up with the pull requests doing everything by hand, but only if do it at least weekly. +* We have discoverd the by-hand process is tedious and error-prone. +* We can stage multiple pull requests in a testing branch so we can batch-up testing. +* We can automatically land the result so merged pull requests show up as merged in github infrastructure. We need help with automating the process: -* Add the ability to batch multiple pull requests -* Add automated testing that's context specific (for example, 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. + +* Add automated testing that's context specific (for example, run igor over man pages). +* Add build/install tests that test boot the resulting image. +* Automate common tasks, like man page corrections, into staging process. +* Add simple smoke testing for the staging branch for tier 1 architectures. +* Investigate optionally integrating Jenkins testing to scale-up the size of changes we can accept. +* Integrate with Bugzilla problem reports and Phabricator reviews. +* Improve the submitter experience on github by automating common feedback to mistakes in the pull requests. +* Create checklists for submitters to reduce errors. +* Create better reporting about pull requests, especially the frequent contributors of good pull requests. We are coordinating on FreeBSD's Discord in the #github-hacking channel. +Join us there to pitch in, or just chat about the project. -Once we have things fine-tuned, we will be looking to expand this by doing publicity to steer contributors to at least the base system to GitHub. -We need more developers looking at the FreeBSD GitHub pull requests +Once things are fine-tuned, we want to publicity to steer contributors, at least the base system, to GitHub pull requests. +We need more developers looking at the FreeBSD GitHub pull requests. We will also need more developers to review and land pull requests once it is automated and 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.