From patchwork Mon Aug 26 01:57:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13776957 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 65797C5320E for ; Mon, 26 Aug 2024 01:57:51 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4EB7E6B02D6; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4971F6B02D7; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3ACAA6B02D8; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 1AB2E6B02D6 for ; Sun, 25 Aug 2024 21:57:50 -0400 (EDT) Received: from smtpin25.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id C3B43A86E8 for ; Mon, 26 Aug 2024 01:57:49 +0000 (UTC) X-FDA: 82492735458.25.FD3D152 Received: from nyc.source.kernel.org (nyc.source.kernel.org [147.75.193.91]) by imf08.hostedemail.com (Postfix) with ESMTP id 26903160014 for ; Mon, 26 Aug 2024 01:57:47 +0000 (UTC) Authentication-Results: imf08.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=OfNyueGh; spf=pass (imf08.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1724637384; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=vaFF2WzE4QK0KQ5Ku/TFqwT9Hosh4qJRrlJ/34etDtQ=; b=6Su6gVlgAUDIsJD4C400LNcHcdyLr2sq2lYAHGIxaaB7AtSI9Esw4tEO4rlN5riuyErZJh dB+jBO8i7nLMIlnscw77gFqGb6G87NbjhIhwY/HJVJ84/pzyLZX+8AInUSJ5QL49LE4jjY +ftJU3KjFkvzYDwWKaL2Kq9yjVqDf5o= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1724637384; a=rsa-sha256; cv=none; b=3KhX2eHrDctxh9ncihueBm9+hTsBn/NHEVCMeMz2TZNB7kgzCAr0FAQ1PBnIeVnziTNmOo gQIdEpGm9M+iECvpH54URfE5UKXlWjL/0DixOQ/D4COMTc0zHBB0cIHa1yrfWjSrwQEytX uQEpGuM0frN1doQIvgJO36VdR2acnYw= ARC-Authentication-Results: i=1; imf08.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=OfNyueGh; spf=pass (imf08.hostedemail.com: domain of sj@kernel.org designates 147.75.193.91 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by nyc.source.kernel.org (Postfix) with ESMTP id A8FC5A40E13; Mon, 26 Aug 2024 01:57:40 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 95BDAC4DDE7; Mon, 26 Aug 2024 01:57:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1724637467; bh=JVZ1e15QPo3CgnpjsPGBbluDVYbC60RWJ4aEogp07ss=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=OfNyueGhx4LJPERlgBY/8ljixzNlYaP6x+v7mrQF3pEFh1vH2BH1uzIniEs9BONBa +vRBGyd5q5EpPpmXk+HQry3XWD5rQM5gduU/chYoHMeAWKyS9/JdZfUW6BELZIwz8L z01sJRGzJO61umKvrHWW9vuszhrsP/rDu1tcmxGM9rRFD4KIOgis54rqupDibMfbu4 73jczuSe17BeoPEh3O4dKZagTFD2PBOOvVZTGdmFf6etQgLmvSGHsTq9jfIe785d22 G1gnWWPVvFbSopKyYnKwLZrZfn1WNWNlkGwQbDb/YIcgT8QAE2gVCIT8F6cA5G395K YM91Psts9QqJA== 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 2/3] Docs/damon/maintainer-profile: add links in place Date: Sun, 25 Aug 2024 18:57:40 -0700 Message-Id: <20240826015741.80707-3-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240826015741.80707-1-sj@kernel.org> References: <20240826015741.80707-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 26903160014 X-Stat-Signature: kd53x8w1btbfbyby768myf3enotoofms X-Rspamd-Server: rspam09 X-Rspam-User: X-HE-Tag: 1724637467-140101 X-HE-Meta: U2FsdGVkX1/JuBYZzqnV+RScgx8Q4Ovy8Ut90nJaiDWdrYBW9nVhVMFpMV+ibZ22WGgpzrCMh68JBtltJ8+ypNiWTW0cH3d75G/hOqNKNve7ydSnp/1ed4X3i5n9NqQ28skeQN2+LXpsNyrmw4srG5TASRglUnVwgHUrlplPa1OvoBTJZJf/NfmwaceGwXv/ilo5nmYGzXhpq6sz4nod9YPsT8fTrcMrvY4OcgCIA8lbU2vHKiJaV8Xd4gfora+qxLFjwdHCo7hHKzfp0Sil+AD4doplcYIvi5ELwCdjxEVy1aBVcAGWjYC2c70fLlcrNl+0RAcPPmzI5mHMBL1OhpMod6A2psLBcYCTZdSCLt3jfhR1hBuDT545b2BGqf30eyrwlYnWrZ92r0XPJBYFbsepwFSvLQFurvxIKU4MbIWnH4nyc+W6f4Daa3DFc5TIvGk1dvkSNizRMNdNcz5NczUmuY3oy38xLYKSbqrrEpi9si4US105gxD2I3/99K1dEamvrp9ehP1nK48DxFkAE+yz7qwQf6inJh6mJNE6hiDq+aRWvVyKs1W23aixssX6WRS5cAEKbsjk0aTQj5veSyzTx6ap7GkPGVQCbHjVlyPoTavYFB/MkioiXnYvkKEhfxRzSs3l4tDUlDgF82NTabGqBA25bI4Dfu0AAhRBV+e1x777L4rxhjStTZktsI+dAJFQXSPZL79XqoCicnpJYg867scYjP9XbH+EyayIDOPPVBAIbNoKnVrgybkfa4QZZ9oBu8ODpyOXDIImrquESvVJgr8/sZ02oNAEsCfTOEtAMhtMGjhMtBALPN2jzauqkDREGDUHm0BRG5O0pJb+Iny0TAhhF89/Yu3Psyo5WQ/kd0u8xCQSJ+aIuFD73MMhS/UGdPYCl8CC9r8G0NdikJ4b+tOOT2wKdhlnmlc9Lx3OmcehkQn5zjDnEu9XfCVVVzYTAVy21Dy0EQ8hyrt ir7ld/wM 0MdmnvT1KM1owknNsBlPwXYV78Q1OSHNVH5IkpjUqI0avyvWT9CKm6Jzcbw6mrX3UGm2hXynly29uI3ljuZjtA0BZGffKbT2a67DrZJzSnZ5r9isv42fIQcx9SeTA2FoKg/xoUzbdO9mqKnZo0uvdFhH16h30ZBKSpR+CYcOLJAqQhrEvxM/uhIz1z0OGMf39eIyXzXC2b+kmh1Q+kyBjoMfrvItu3FE0GuHEAhmCDmmj85KXTtDxSo/2Xaa4aQUBpVJjgwi5rZ//QiLCAb54/o7GT11OX4g6O+37aa5Jjkb2Z2x29vJB2mwxujJcSZ4c7F/8lPRXeLAxlsEXj9zJ2quuDmJTEbzx/mQD X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: maintainer-profile.rst for DAMON separates the links and target definitions. It is not really necessary, and only makes the readability worse. At least the definitions need the section title (say, "References"). Just add the links in place on the doc. Signed-off-by: SeongJae Park --- Documentation/mm/damon/maintainer-profile.rst | 84 ++++++++++--------- 1 file changed, 44 insertions(+), 40 deletions(-) diff --git a/Documentation/mm/damon/maintainer-profile.rst b/Documentation/mm/damon/maintainer-profile.rst index 048b78e6d989..3c1b42b062ea 100644 --- a/Documentation/mm/damon/maintainer-profile.rst +++ b/Documentation/mm/damon/maintainer-profile.rst @@ -7,23 +7,27 @@ The DAMON subsystem covers the files that are listed in 'DATA ACCESS MONITOR' section of 'MAINTAINERS' file. 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 [1]_ -whenever possible and posted to the mailing lists. +linux-mm@kvack.org. Patches should be made against the mm-unstable `tree +` whenever possible and posted to +the mailing lists. SCM Trees --------- There are multiple Linux trees for DAMON development. Patches under -development or testing are queued in damon/next [2]_ by the DAMON maintainer. -Sufficiently reviewed patches will be queued in mm-unstable [1]_ by the memory -management subsystem maintainer. After more sufficient tests, the patches will -be queued in mm-stable [3]_ , and finally pull-requested to the mainline by the -memory management subsystem maintainer. - -Note again the patches for mm-unstable tree [1]_ are queued by the memory +development or testing are queued in `damon/next +` by the DAMON maintainer. +Sufficiently reviewed patches will be queued in `mm-unstable +` by the memory management +subsystem maintainer. After more sufficient tests, the patches will be queued +in `mm-stable ` , and finally +pull-requested to the mainline by the memory management subsystem maintainer. + +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 [2]_ which not yet merged in mm-unstable, please make sure the -requirement is clearly specified. +damon/next `tree ` which not yet merged +in mm-unstable, please make sure the requirement is clearly specified. Submit checklist addendum ------------------------- @@ -32,18 +36,27 @@ 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 [4]_ and kunittests [5]_ . +- Run and ensure no new failures for DAMON `selftests + ` and + `kunittests + `. Further doing below and putting the results will be helpful. -- Run damon-tests/corr [6]_ for normal changes. -- Run damon-tests/perf [7]_ for performance changes. +- Run `damon-tests/corr + ` for normal + changes. +- Run `damon-tests/perf + ` for performance + changes. Key cycle dates --------------- -Patches can be sent anytime. Key cycle dates of the mm-unstable [1]_ and -mm-stable [3]_ trees depend on the memory management subsystem maintainer. +Patches can be sent anytime. Key cycle dates of the `mm-unstable +` and `mm-stable +` trees depend on the memory +management subsystem maintainer. Review cadence -------------- @@ -58,16 +71,17 @@ 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``) [8]_ , which is -for people who are not very familiar with the mailing lists based -communication. The tool could be particularly helpful for DAMON community -members since it is developed and maintained by DAMON maintainer. The tool is -also officially announced to support DAMON and general Linux kernel development -workflow. - -In other words, ``hkml`` [8]_ is a mailing 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. +channel. There is a simple tool called `HacKerMaiL +` (``hkml``), which is for people who +are not very familiar with the mailing lists based communication. The tool +could be particularly helpful for DAMON community members since it is developed +and maintained by DAMON maintainer. The tool is also officially announced to +support DAMON and general Linux kernel development workflow. + +In other words, `hkml ` is a mailing +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. Community meetup ---------------- @@ -83,17 +97,7 @@ members including the maintainer. The maintainer shares the available time slots, and attendees should reserve one of those at least 24 hours before the time slot, by reaching out to the maintainer. -Schedules and available reservation time slots are available at the Google doc -[9]_ . DAMON maintainer will also provide periodic reminder to the mailing -list (damon@lists.linux.dev). - - -.. [1] https://git.kernel.org/akpm/mm/h/mm-unstable -.. [2] https://git.kernel.org/sj/h/damon/next -.. [3] https://git.kernel.org/akpm/mm/h/mm-stable -.. [4] https://github.com/damonitor/damon-tests/blob/master/corr/run.sh#L49 -.. [5] https://github.com/damonitor/damon-tests/blob/master/corr/tests/kunit.sh -.. [6] https://github.com/damonitor/damon-tests/tree/master/corr -.. [7] https://github.com/damonitor/damon-tests/tree/master/perf -.. [8] https://github.com/damonitor/hackermail -.. [9] https://docs.google.com/document/d/1v43Kcj3ly4CYqmAkMaZzLiM2GEnWfgdGbZAH3mi2vpM/edit?usp=sharing +Schedules and available reservation time slots are available at the Google `doc +`. +DAMON maintainer will also provide periodic reminder to the mailing list +(damon@lists.linux.dev).