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 X-Spam-Level: X-Spam-Status: No, score=-2.6 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_2 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id BCA1AC3F2D0 for ; Fri, 28 Feb 2020 09:14:18 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 88A0E246A2 for ; Fri, 28 Feb 2020 09:14:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1582881258; bh=ABQ/PPo1SyiNv8cj/FKAzTk1cr6OrMdoykpYE3I4QAw=; h=Date:From:To:Cc:Subject:In-Reply-To:References:List-ID:From; b=Yhv+bE5Lr+KZHpnR437oROnuqSGXDdJd9Xw6TDbpfdLvxWdl+yqXSI8eaItaSmMav yiv2zBXK0ChZoLKTOu/bzacNammTbszBycUdYCxxmU/u23Rm103ymWhiS43Y+mrpzK Wmf3NA1LdFspP/ou5Tkx5nSUUxkOiAQB83LJJmsM= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726148AbgB1JOS (ORCPT ); Fri, 28 Feb 2020 04:14:18 -0500 Received: from bombadil.infradead.org ([198.137.202.133]:57802 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726005AbgB1JOS (ORCPT ); Fri, 28 Feb 2020 04:14:18 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To: From:Date:Sender:Reply-To:Content-ID:Content-Description; bh=ABQ/PPo1SyiNv8cj/FKAzTk1cr6OrMdoykpYE3I4QAw=; b=jC8RONz2FazLAGP12/noAgSXEt wHKhA0l5vUvx4U182++Ls21TleVx1FQYcu82li60d1O3fNXqW2+f9Gt2oCZyBstt1lItso22h0pZq 5WUN3YY/wqBu1AF+txAZcIM6R6DZ1h0Dspbkw5AgHevLudrlk0iyA/ly2sAdkghnYuJxAQ3vsYd+Z sp99AYkoKALWi0wAlBARP+fhc9Ma/AtPBLJk/KShw164EFpqwEKbeyAG+WiJg+YNfT/s/OCAAx6vh mySkb8YYivWB2Ucu2Z9J6LHHgfcNk9ugqVUzlksZHXtAvpndeeQHPxSbMwd7Lm5FEZSd4VqyO9nLt Q8YKRl+g==; Received: from ip-109-41-131-202.web.vodafone.de ([109.41.131.202] helo=onda.lan) by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1j7bir-0007du-0w; Fri, 28 Feb 2020 09:14:17 +0000 Date: Fri, 28 Feb 2020 10:14:12 +0100 From: Mauro Carvalho Chehab To: "Rafael J. Wysocki" Cc: Linux Doc Mailing List , Jonathan Corbet , Viresh Kumar , Linux PM Subject: Re: [PATCH v2 14/24] docs: cpu-freq: convert index.txt to ReST Message-ID: <20200228101412.5b57c427@onda.lan> In-Reply-To: References: <7a89b0c82520d340d3c7f45bfd52ee9e6e23dbdf.1581956285.git.mchehab+huawei@kernel.org> X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Hi Rafael, Em Mon, 17 Feb 2020 21:06:20 +0100 "Rafael J. Wysocki" escreveu: > On Mon, Feb 17, 2020 at 5:20 PM Mauro Carvalho Chehab > wrote: > > > > most of the stuff there can be re-used with ReST format, > > but we need to add an empty TOC and remove the existing > > entries, as the following conversion patches will be re-adding > > them, as they're converted. =20 >=20 > I see a very little value in converting the files in the cpu-freq > directory from .txt to .rst, which I have told you at least twice. >=20 > They are just old-style driver API documents for cpufreq, but moving > them under driver-api/ as they are would not be a good idea IMO, > because at least some of them are outdated (note that the admin-guide > part of the cpufreq documentation, in the .rst format, is located > under admin-guide/). >=20 > I haven't had the time to write a proper replacement for them yet and > honestly I find it quite obnoxious to see these reoccurring attempts > to blindly convert them to .rst without taking care of their contents > and location. >=20 > I will take care of these files at one point as promised, but that's > not going to happen today or tomorrow and please just leave them alone > if that is not a big deal. Sorry, I completely forgot that you asked to skip the old cpufreq docs. My bad! The thing is that I have now fully converted all docs to ReST (with a handful exceptions for things that may not make sense to convert, like configuration files that ends with .txt). As a matter of helping those (like me) that are trying to finish this huge conversion/reorganize task, I would very much prefer to keep those files converted somewhere (or trashed, if their contents is now completely garbage). One of the things we discussed at linux-doc ML is to create a "staging" area where we can place: - things that aren't ready to be at the main documentation body yet; - too obsolete docs that may require major work; - things that we didn't find a good place to put yet. =46rom the last discussions, it seems we reach a consensus about creating tha= t. So, I should be preparing a separate patchset adding a Documentation/staging dir.=20 Would it be OK for you if I change the cpufreq patches on this series to be moving those into a new Documentation/staging/cpufreq directory? Regards, Mauro