From nobody Tue Jul 09 02:38:15 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 4WJ4sz4jShz5Mm7V for ; Tue, 09 Jul 2024 02:38:15 +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 4WJ4sz4Bkwz4H8s; Tue, 9 Jul 2024 02:38:15 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1720492695; 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=jwJcxICFxwT0ixXbgFmjSDurVk4+Y3eLj1GeArrtyN8=; b=iIsGJfRK8+ozyEPNW8Wz7oGBMDkZ3F397xuR7ybUwfHRV8KnzLM1Y9qvpbrmNksMXHpbq5 mZGiZ2XSWMZWS0CzJcCDffza7i1rgsZtBA1Wkuq0qIKXMfrPuBIkoes40dvxsUZnsUcuqm MLyEaWi4ag2fMZwiGv4P2TR+r9YWfeFF9aM7Q6br7+T9xbGNnLVrvDNs9sTi4vxuEUSUMq GM2eu+zLR9eW0EgDL1fNMm1xEe5za55rDu1h6ayurAIevqLHD+xEEX2AUETNLuYmpVQjMG w7ZTjLhbXbpdcPo6PvNOpqu9c0uDh88MfNAREYARhUzQqNoSH1WEiwiq/kOEyA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1720492695; a=rsa-sha256; cv=none; b=SHZi+/0J6H2H0B8PZnubDJRYgVyVIuMsWNRMvuXOryMUGSakBMCbxiVrjazWtlm4Avse58 eqpzhhkdKZKRVpo/ug+/GGxHG7ZBYQVJYVG69P5CVKiK+DPaK6WgcU3VWcJbuSmNBHvcx0 kjVSl6k5Y9ewhMqxTlYYDvifjqoUZJhC42kXIi/+a2AVuNo6TK5TvXPKwUajJTkYWCyDqa 6xKki5IB9FzRREdltAS7XNoLDGrnuH0AyZMCA0TG8vtzmajp35/bGuT/HuoQ7hbZKQ7L/f KsByg14WTjhQxMDycT3nnxZ8MSI3tdYfCB7hdRVfLATxmwQAbxPQrMWdoZ8KfA== 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=1720492695; 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=jwJcxICFxwT0ixXbgFmjSDurVk4+Y3eLj1GeArrtyN8=; b=VBkUqZ/RuKboxML5Cl9s/fTiBeU2uOqyG9FAXKHCg7Odl+3z6SazxfOMEdKft/uh3kHXuf bTGfPGRjufdu1iwKBednx9rLXAK3RM90WQWCKz3XWu28Dxa2V2TwzKn7uv7l3nF0YkCRLz VobzKIryueJ9HVslstUn65RujMO6D9+kC3GvYV7+Jab7bQ/1SIjyGj2hYS6OOAw1I89XNp qZ8iFyC19hfGYMCMrowJJA01zwhUR5Cg+mpIO75aojzv2BJrSue/F5oDhupiDQ7JONLlsQ 6hLp7tbxxur7eSlknLxD0hScr1EpcueM5DeEPge0d1VndObkBAk8z/4qnPRaXg== 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 4WJ4sz3gT4zGTc; Tue, 9 Jul 2024 02:38:15 +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 4692cFqY039418; Tue, 9 Jul 2024 02:38:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4692cF28039415; Tue, 9 Jul 2024 02:38:15 GMT (envelope-from git) Date: Tue, 9 Jul 2024 02:38:15 GMT Message-Id: <202407090238.4692cF28039415@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: 588168db0e - main - 2024q2 report: Copyedit github.adoc 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: 588168db0ea3e262e4a2cc3ccbe2d85cf880c783 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=588168db0ea3e262e4a2cc3ccbe2d85cf880c783 commit 588168db0ea3e262e4a2cc3ccbe2d85cf880c783 Author: Warner Losh AuthorDate: 2024-07-09 02:37:20 +0000 Commit: Warner Losh CommitDate: 2024-07-09 02:37:20 +0000 2024q2 report: Copyedit github.adoc Apply the edits Pau submitted, and fix a few problems that I noticed while doing so. Submitted by: Pau Amma Sponsored by: Netflix --- .../en/status/report-2024-04-2024-06/github.adoc | 30 ++++++++++++---------- 1 file changed, 16 insertions(+), 14 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 38314811ca..5ea8718009 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 @@ -1,28 +1,30 @@ -=== FreeBSD Github Pull Request Report +=== 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[] +link:https://wiki.freebsd.org/WorkingGroup/Github[GitHub Working Group wiki page] URL: link:https://wiki.freebsd.org/WorkingGroup/GitHub[] + +link:https://github.com/freebsd/freebsd-src/pulls[FreeBSD Base System Pull Requests] URL: link:https://github.com/freebsd/freebsd-src/pulls[] 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. +The FreeBSD Project has been trying an experiment to accept contributions via GitHub pull requests. +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'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. +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. 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 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. -We are coordinating on FreeBSD's Discord in the #githib-hacking channel. +We are coordinating on FreeBSD's Discord in the #github-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. +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 +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.