From nobody Wed Nov 27 08:41:08 2024 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 234C31A08A4; Fri, 11 Oct 2024 17:02:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1728666121; cv=none; b=T57p9z9bz46t/Ok8ieTP/hPcYAQC/q/bDm7mx//HexDb0xTcn/rMjkBcARYwzqrEF5b3f/y1remjdHf5836CGTQhHHSQv3Rggm6eE1HK1LqSPTgo6kNTEHHajy3Z7hdJ+tQFlkgokz4Wsl9mrfefO1eduHk8yMyYdsZQMUVQ5ds= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1728666121; c=relaxed/simple; bh=FjXH2IdgssaC1VgXM6fx4nfSiv/SdPLDBW6J9dj7vPc=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=d5WOw1ADWvwabDOb66Jvt2YjiiLFkhKvxDJZWi4hEMD/5oXoArnSUODN3sELIWe/qoJRoG9uSC8ArjmaxGPtHn8MnItEwcIRaU38vO2rVWDuRhgboYNadfbTZnDCfwVdAo4XTPmbxPMqgT6tIe6BahQflfQDkdwknkzBynOkuAk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=pz7ElFMX; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="pz7ElFMX" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7FD6EC4CEC7; Fri, 11 Oct 2024 17:02:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1728666120; bh=FjXH2IdgssaC1VgXM6fx4nfSiv/SdPLDBW6J9dj7vPc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=pz7ElFMXs98kV5oWdTgn2kWOqsnZsHnS8lRDD9ta6E7iwKvPk0jmqUZ9agQ3561Fc xwu53EFSDBxBnq4KaD4NRW46/8wTqDaq5E/bPmqRv+zgnYqpCHJ/ha5YjZClCZR28X apORACKmS50zeNRZyi9t2A8QDbGUr8tEVuq2kJBm0TChSTo6hjxOtNQ0W3YdlIfSCB Jnmlju5wccl0h3Inx0gfNM3Ce6e17XHTutvyX5HAjgowpcydb6TxvcAlxfr2aUmWB+ kfEOA4t5ndanGTFpbus32wwIE1RXzhmV7pZH0vJXSY+MQDkC7hHnEQK4eaackgtzoh 06h/bRaa2vz+A== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/2] Docs/damon/maintainer-profile: add missing '_' suffixes for external web links Date: Fri, 11 Oct 2024 10:01:53 -0700 Message-Id: <20241011170154.70651-2-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20241011170154.70651-1-sj@kernel.org> References: <20241011170154.70651-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Links to external web pages on DAMON's maintainer-profile.rst are missing '_' suffixes. As a result, rendered document is having only verbose URLs that cannot be clicked. Fix those. Also, update the link texts for git trees to contain the names of the trees, for better readability and avoiding below Sphinx warning. maintainer-profile.rst:4: WARNING: Duplicate explicit target name: "tre= e". Fixes: 2e9b3d6e2e59 ("Docs/damon/maintainer-profile: add links in place") Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/= mm/damon/maintainer-profile.rst index 2365c9a3c1f0..7b966480c79e 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -7,26 +7,26 @@ The DAMON subsystem covers the files that are listed in '= DATA ACCESS MONITOR' section of 'MAINTAINERS' file. =20 The mailing lists for the subsystem are damon@lists.linux.dev and -linux-mm@kvack.org. Patches should be made against the mm-unstable `tree -` whenever possible and post= ed to -the mailing lists. +linux-mm@kvack.org. Patches should be made against the `mm-unstable tree +`_ whenever possible and pos= ted +to the mailing lists. =20 SCM Trees --------- =20 There are multiple Linux trees for DAMON development. Patches under development or testing are queued in `damon/next -` by the DAMON maintainer. +`_ by the DAMON maintainer. Sufficiently reviewed patches will be queued in `mm-unstable -` by the memory management +`_ by the memory management subsystem maintainer. After more sufficient tests, the patches will be qu= eued -in `mm-stable ` , and finally +in `mm-stable `_, and finally pull-requested to the mainline by the memory management subsystem maintain= er. =20 -Note again the patches for mm-unstable `tree -` are queued by the memory +Note again the patches for `mm-unstable tree +`_ are queued by the memory management subsystem maintainer. If the patches requires some patches in -damon/next `tree ` which not yet m= erged +`damon/next tree `_ which not yet = merged in mm-unstable, please make sure the requirement is clearly specified. =20 Submit checklist addendum @@ -37,25 +37,25 @@ When making DAMON changes, you should do below. - Build changes related outputs including kernel and documents. - Ensure the builds introduce no new errors or warnings. - Run and ensure no new failures for DAMON `selftests - ` and + `_ a= nd `kunittests - = `. + = `_. =20 Further doing below and putting the results will be helpful. =20 - Run `damon-tests/corr - ` for normal + `_ for normal changes. - Run `damon-tests/perf - ` for performan= ce + `_ for performa= nce changes. =20 Key cycle dates --------------- =20 Patches can be sent anytime. Key cycle dates of the `mm-unstable -` and `mm-stable -` trees depend on the memory +`_ and `mm-stable +`_ trees depend on the memory management subsystem maintainer. =20 Review cadence @@ -72,13 +72,13 @@ Mailing tool Like many other Linux kernel subsystems, DAMON uses the mailing lists (damon@lists.linux.dev and linux-mm@kvack.org) as the major communication channel. There is a simple tool called `HacKerMaiL -` (``hkml``), which is for people= who +`_ (``hkml``), which is for peopl= e who are not very familiar with the mailing lists based communication. The tool could be particularly helpful for DAMON community members since it is deve= loped and maintained by DAMON maintainer. The tool is also officially announced= to support DAMON and general Linux kernel development workflow. =20 -In other words, `hkml ` is a mail= ing +In other words, `hkml `_ is a mai= ling tool for DAMON community, which DAMON maintainer is committed to support. Please feel free to try and report issues or feature requests for the tool= to the maintainer. @@ -98,8 +98,8 @@ slots, and attendees should reserve one of those at least= 24 hours before the time slot, by reaching out to the maintainer. =20 Schedules and available reservation time slots are available at the Google= `doc -`. +`_. There is also a public Google `calendar -` +`_ that has the events. Anyone can subscribe it. DAMON maintainer will also provide periodic reminder to the mailing list (damon@lists.linux.dev). --=20 2.39.5