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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5E1A3C3DA7A for ; Mon, 2 Jan 2023 23:35:26 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236360AbjABXfY (ORCPT ); Mon, 2 Jan 2023 18:35:24 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53904 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229603AbjABXfW (ORCPT ); Mon, 2 Jan 2023 18:35:22 -0500 Received: from ms.lwn.net (ms.lwn.net [IPv6:2600:3c01:e000:3a1::42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6351CBCB6; Mon, 2 Jan 2023 15:35:21 -0800 (PST) Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id E4C0C6D6; Mon, 2 Jan 2023 23:35:20 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net E4C0C6D6 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1672702521; bh=8Urwkhnl8X2pfaw1kHAwUmTLLQL4RD3KeQARX6NwZkU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=b3dpElX9lrF8bY2SqAacBRKrkzHM/rKdJm2qvbaZ+Hq0pJel6SdXe+SVKo2vkg2ds FjDMKwPXOpB3z4WVlZwhla8yaU+9gbuymFblf/2XWo3Syos1WdOjC31p3sg+hXVpZl 33hFPhk3NLwKAU0hmi6X2N2HqCfOSnGCnC2VvGnoKwMXC1HMKeucfgxnUJT/uDnQ9p C9wg1Wfdc8Y531+MydMRDCBCsMxrnn9SRzLAMjbmm9Br9vrlqhaNQxoWw06emOMgzh iQLz6aa13KRJyP2ZKmV3DmjQjPHhsn7pUOyowBykiaGdmwhHByNMM9oEFwBeUVM4G+ 3dzHBtJRU6qVQ== From: Jonathan Corbet To: Bagas Sanjaya , cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Linux Memory Management List Cc: Tejun Heo , Zefan Li , Johannes Weiner , Michal Hocko , Andrew Morton , Hugh Dickins , Shakeel Butt , Bagas Sanjaya Subject: Re: [PATCH 00/10] docs: cgroup-v1: formatting improv for "Memory Resource Controller" doc In-Reply-To: <20221219042209.22898-1-bagasdotme@gmail.com> References: <20221219042209.22898-1-bagasdotme@gmail.com> Date: Mon, 02 Jan 2023 16:35:20 -0700 Message-ID: <87a630h5mv.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Bagas Sanjaya writes: > "Memory Resource Controller" CGroup v1 documentation has been in reST > since 99c8b231ae6c6c ("docs: cgroup-v1: convert docs to ReST and rename to *.rst"). The current doc look is kinda ugly, so improve the formatting (only > htmldocs is tested). > > The first patch is a fix for recently reported htmldocs warning, which can > be pickup separately from rest of the series. > > Bagas Sanjaya (10): > docs: cgroup-v1: extend underline of section 8 > docs: cgroup-v1: replace custom note constructs with appropriate > admonition blocks > docs: cgroup-v1: wrap remaining admonitions in admonition blocks > docs: cgroup-v1: use code block for locking order schema > docs: cgroup-v1: fix footnotes > docs: cgroup-v1: move hierarchy of accounting caption > docs: cgroup-v1: use bullet lists for list of stat file tables > docs: cgroup-v1: use make swap extension subsections subsections > docs: cgroup-v1: add internal cross-references > docs: cgroup-v1: use numbered lists for user interface setup > > .../admin-guide/cgroup-v1/cgroups.rst | 2 + > .../admin-guide/cgroup-v1/memory.rst | 290 ++++++++++-------- > 2 files changed, 158 insertions(+), 134 deletions(-) Tejun, do you have an opinion on these? I'm not really sure we need to be tweaking the v1 docs at this point, but I don't see anything in here that seems harmful either... Thanks, jon