From mboxrd@z Thu Jan 1 00:00:00 1970 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 749C0C2BD09 for ; Thu, 4 Jul 2024 03:33:12 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EE7426B008C; Wed, 3 Jul 2024 23:33:11 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E97626B0092; Wed, 3 Jul 2024 23:33:11 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D5DEC6B0093; Wed, 3 Jul 2024 23:33:11 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id B7F676B008C for ; Wed, 3 Jul 2024 23:33:11 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 719E21A102F for ; Thu, 4 Jul 2024 03:33:11 +0000 (UTC) X-FDA: 82300649382.28.C544625 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf02.hostedemail.com (Postfix) with ESMTP id A547E80012 for ; Thu, 4 Jul 2024 03:33:09 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=Ts1WtiRx; spf=pass (imf02.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1720063977; a=rsa-sha256; cv=none; b=cP2ZaM2TQs0e/3NehMQxdUDdDGpOiXkeYHbfOemA0kbXjaIZYV/raua9aqJFsrTfLL29Q6 ZxU0Sx+1yoaixMnSZusvNxqPOmv/qdJ7Chge01QMhAOTgpegIp/5+4mVm0ewz/MI+w4tpo F+cZfHSNTN79XL1HPMYqI52vozKK31g= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=Ts1WtiRx; spf=pass (imf02.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1720063977; 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-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=gn8VeQmAjqKRDXc7pj3PJe/TmWs/l+lqI85K99D3rKc=; b=MQBtdoWJMRLvoBXAALhMDtowiiExFuZOCv7T0Ng3K45MBHRroZIGJWElb68KteZ/kHUsVg IljUUYKXZ0xApn29qGm7y79kGt/8IselupZuN0/sk/YfcnHeL4XBGVc++bZXAYa1C90kiy v0UBKpMozzMpVYGvDvkkb4EHIKXgCcA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id C1845616AF; Thu, 4 Jul 2024 03:33:08 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id BDCDBC2BD10; Thu, 4 Jul 2024 03:33:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1720063988; bh=tcm1IcCORRAi6yPGnK23d43U5d99YCQ7myWX0KsENNM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Ts1WtiRxrRypIJlOi/Or/G0T5uB6qyn16k62V1VunKRaq2XHdtKxVR5V3ELW34Yn2 wrCttctsy2MihhkXG2xnXqY3AsbM0sBvLqTtr2fj6MAVq6B7ft6NfLJjbClFXqfIpy GNIqQiPhePWPI7vaCca16Luw8JOaV/I8+lxYcD7Di9+eSLiMO9X+52f+MVYNGcLd2D zu7hF+QdhWGvEfSGs2MIjgOZL8KrbP1JpMT0EXlfAk265VOhkvH6RhEo5IPs07/814 LfuxvdxdX3AuQvqubKnx11cGvY6genODrb8CaUiQttoDYSnsZ36ZBrCBtou1jOLPxW The2lTBnsp5bg== From: SeongJae Park To: Suren Baghdasaryan Cc: SeongJae Park , Jonathan Corbet , Andrew Morton , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Kent Overstreet Subject: Re: [PATCH 4/4] Docs/mm/index: move allocation profiling document to unsorted documents chapter Date: Wed, 3 Jul 2024 20:33:05 -0700 Message-Id: <20240704033305.93425-1-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Stat-Signature: jt86mbotzg536wjpw3f6pcdeadcewmct X-Rspamd-Queue-Id: A547E80012 X-Rspam-User: X-Rspamd-Server: rspam10 X-HE-Tag: 1720063989-485328 X-HE-Meta: U2FsdGVkX1/3/Xw3oeHZ3UjjarSTssq1Az60PbMv52dBGCERmNikeVraieS8peJau1W44ZVmksfTkLqABckq4sMHZktZn3uKwiA2Dk6C5V2l7KabTE0CWQqovlj6EcqXxnZSU2f1T02unWi+2x9n62D8FIhwzbI7Ab9QARMuo15noB1P8XKD6Jp2NR9a7MZlq0l5qKJQcOQt6VSLPzwff41cgo3+DCCvM3aJpBNbyQrmqP8o5HCtySVlKqTHsjh++S+3BmLm9YTQu+Jd13axk5G9kJi1te7nkIOc9/sAER0QfQ6g/kGmpzY3nwenisKL2+FA/7tZSzMc4CqOggXfvVjRdZaF0snAOocE9PL6VAkeEtbcmkAnRQadquifj1Ws3+az3vvHpjrfnzxRHXPNmPCwT6IhqU20bq+794Mg27uG/P3SywGFj/kGgfsE0xSuwBlZX5nMS+YAEBUOUISTN86shlq70qLdCgXZce5TSh7L6ydCaTNUzzWqErm73McZUxibJJBEUNapx97XqM5PoBHrGbmU3QqNLjKGhUXw060sjHHfLKsw7z3GMKUTNnOwYbtRre1rPCQx1iM1RsfndI3ckbaZvIeVTr94cn1gK8RtCL1QDoBOeHkC7YDApoIdBkfXBl6UzIYQTLTVpRwfynTCg72lmtKTF2e8aBV3P/bj2SLf5BomO/hTrbGVWjnq2rt0tzUrjQxraPugu88cvWA9UaAZYGs8PYF/eSpo8sgGxbNKaP2IrJYSOu0dREKc8alXoYephSvm2AJBslu2fJ30JHfu5FqzP8rMRiHF8CtzjvSfEap2oulDA8M5UxGu6nBFK4dIK2C6EWz1Yn0ctWhkfRleGnkymftZCd7U45/AmB9g0P0aFa3oJe6kYzaLJmmT+MftRHebFILqd4WiC67fihMFKI2Oa7/BLJfE1lmHTH5olGqvQVR7oFcKQVBgtFr3b7CFrkqLctxi5ix bKfOaEBQ 2WyezznQQ6rBgrCb16j5TbUcNax1EKuP/jg1mZf2jGcqvhLF6w6YbVNE2jmLHEm5G2/oNnsy0ZWV7N1kgH+QC7IdcA407C3vBQQ6JduJnuAQg1hUH6/3nZA6tnktXQFHvzMRuBAoiXoRyomMtJ/Y0pCBnu0SFWwM3cLwHts6YsXlMynH31fI50OyNOkl5sctV0NEWttC7sAn8jqvnmaLIeWX0syGlxZlbwiJtP2Pl7/442/QfX4YGjINDvXm8g7GSyKhS3aM+EUUvuv1sI94bMnpcQzWA+3YyVi1z2VrPb2ODYeDSrBwtZW5g0BKKA1I4zAylE8m4oVx1zuEXofvGnV0nX0HJPzoLqVpM X-Bogosity: Ham, tests=bogofilter, spamicity=0.005722, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: On Wed, 3 Jul 2024 19:10:03 -0700 Suren Baghdasaryan wrote: > On Wed, Jul 3, 2024 at 4:00 PM SeongJae Park wrote: > > > > On Wed, 03 Jul 2024 16:18:42 -0600 Jonathan Corbet wrote: > > > > > SeongJae Park writes: > > > > > > > The memory allocation profiling document was added to the bottom of the > > > > new outline. Apparently it was not decided by well-defined guidelines > > > > or a thorough discussions. Rather than that, it was added there just > > > > because there was no place for such unsorted documents. Now there is > > > > the chapter. Move the document to the new place. > > > > > > I'll take this for now, but it's truly sad to see new documentation > > > being added to the slushpile at the end. It seems better to create a > > > "development tools" section in the new outline and put the allocation > > > profiling document there? > > > > I have no strong opinions about that. Cc-ing Suren and Kent, as they are the > > author of the allocation profiling document and hence might have some opinion. > > IMHO if this would be the only document belonging to "development > tools" then keeping it under unsorted is fine. > If more documents will fall into that category then Jonathan's > suggestion makes sense to me. Looking at the current list, page_owner > and maybe damon might be considered for this category as well. > SeongJae, WDYT? I agree it makes more sense to have multiple documents under dedicated sections. And putting page_owner sounds not that odd to me. DAMON is, however, not a tool but a framework that helps easy development of access-aware kernel components. Such components could be development tools and system operations optimizations (using DAMOS). So, IMHO, 'development tools' section is not the perfect place for DAMON documents. Actually, even for allocation-profiling and page_owner, I think 'development tools' might not be a perfect category. I understand those as features that could be useful for system investigations of multiple purposes. So, in short, I think it is not easy to find a perfect cateogry... Thanks, SJ [...]