From nobody Thu Jan 1 22:29:00 2026 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 4dj1hF629fz6LqCn for ; Thu, 01 Jan 2026 22:29:01 +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 "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dj1hD4jDZz3JVK for ; Thu, 01 Jan 2026 22:29:00 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767306541; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=gWA23R8r5Hrpmrm1DMT0MWvOq2fO+nVTJbPBYJR0sPE=; b=mUUEJs2/VvUh7pOm7Sxbt12bza/ADbKCEK/yofh2qmoHP9PSTqTcNPEfaqqvVGs/yqWVcw 8vGIuv1yLoYn0duyhyhQ4THODRelxAXV/SL64PFXwVp8lr8juFTSG18bCNLKYihGb8firj 4nZbFHJm0B2bEQSqU1j/vQeT3mc6h8vPBBWRrkkYJt2b2sR4Bwu2YTESDFYmEMNtrpI4CE 7EUX9n3Bh1N9S1Ed7uxv5T6gT8QSLUh5ktv3uyELrclSlp7GU9f2sSEQuL0LAcUVc+gfwV qovmwzNvobmpukPEbvHHx2ON6Jgo5VgxLiU0WuZ6w28eSihswkTnGCd/ceRtzg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767306540; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=gWA23R8r5Hrpmrm1DMT0MWvOq2fO+nVTJbPBYJR0sPE=; b=kYxRmKTtyMiCA+21ldBy989uqvRnguxoQJwNStjr/372bQcL+Wd5LZhrdoyKGEpSK5POX2 zs10Xjz4LUmnn3QYGtvpiPQHcDLl02Mlwp2Bc1DaW8U5iVDVXDbXVfAf2gk9KvfAilHPSK UNdmBxMKf1nPRGfdeSgtmo8S20MSgulmiUPvyK2GGIsQ0DETmRysUVu1IS9PzjGrEAxB/j /RdoJML+Po9kpq8Ai6wIYGhay03vRm+l6z3Onlstnn1dSFBxZuUNH1AgTCH850nW66Xitw TV/0Y+v97ObmkVKSzYDiwRgNTlVKZ/uUDz9e9THjVew6UE968uxXAg6JUe5eQw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1767306540; a=rsa-sha256; cv=none; b=qfS1hLJmuVa3W/nSdaz5TVeYNuIISYBRnPPBE7wRpuusbxS66nHDzObpsoQBC/zKyyrMT6 yYfH5ozpRkDlbDIa/I0aDIfqHEs7HfziU2nEFHXgLB4GLBHgBbLZ0+Tl11WdnRalpf4d6M rvcNH6H/pIJXlf+6hxz/y5ptI299Oi8VQ4zaA7/a8Ncr1zto5sf4KF3mOs3coghwLWnZ4B qgKTpux6CqKnm7BWjHrPG/+InVqkOJolrXSccCmS1+vBxzMY0eWNrrqIB5DUqp1/9XVFLQ ia4kQ6jlDP7V/hAe1wQ3VBWxzJUeHcnMZUI+AOU4u9lUjSPa13oL+3xfNL0nxA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dj1hD41d6zrLm for ; Thu, 01 Jan 2026 22:29:00 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id e721 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 01 Jan 2026 22:29:00 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Cc: Mark Linimon From: Alexander Ziaee Subject: git: fc65ed9d5e - main - Pr-Guidelines article: Note stale content 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: ziaee X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fc65ed9d5ea960ddcbf55570dd073cce19fcca13 Auto-Submitted: auto-generated Date: Thu, 01 Jan 2026 22:29:00 +0000 Message-Id: <6956f52c.e721.61363872@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/doc/commit/?id=fc65ed9d5ea960ddcbf55570dd073cce19fcca13 commit fc65ed9d5ea960ddcbf55570dd073cce19fcca13 Author: Mark Linimon AuthorDate: 2026-01-01 22:23:32 +0000 Commit: Alexander Ziaee CommitDate: 2026-01-01 22:24:16 +0000 Pr-Guidelines article: Note stale content While this Article is being rewritten, warn about stale content. Reviewed by: imp, lwhsu, pauamma (previous), ziaee Differential Revision: https://reviews.freebsd.org/D53779 --- documentation/content/en/articles/pr-guidelines/_index.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/documentation/content/en/articles/pr-guidelines/_index.adoc b/documentation/content/en/articles/pr-guidelines/_index.adoc index dcd8579923..43e8e7f307 100644 --- a/documentation/content/en/articles/pr-guidelines/_index.adoc +++ b/documentation/content/en/articles/pr-guidelines/_index.adoc @@ -64,6 +64,10 @@ Note: in this Article, the term "PR" means "Bugzilla Problem Report". [[pr-lifecycle]] == Problem Report Life-cycle +[NOTE] +==== +This section is obsolete and being rewritten as of January 2026. +==== * The Reporter submits a bug report on the website. The bug is in the `Needs Triage` state. * Jane Random BugBuster confirms that the bug report has sufficient information to be reproducible. If not, she goes back and forth with the reporter to obtain the needed information. At this point the bug is set to the `Open` state. * Joe Random Committer takes interest in the report and assigns it to himself, or Jane Random BugBuster decides that Joe is best suited to handle it and assigns it to him. The bug should be set to the `In Discussion` state. @@ -81,6 +85,10 @@ If the problem contained within cannot be solved, or has occurred again, it is n [[pr-states]] == Problem Report State +[NOTE] +==== +This section is obsolete and being rewritten as of January 2026. +==== It is important to update the state of a Problem Report when certain actions are taken. The state should accurately reflect the current state of work on the issue.