From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.7 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 4CA0D7D2F0 for ; Tue, 11 Jun 2019 15:37:11 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2405106AbfFKPhE (ORCPT ); Tue, 11 Jun 2019 11:37:04 -0400 Received: from ms.lwn.net ([45.79.88.28]:51262 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2405101AbfFKPhD (ORCPT ); Tue, 11 Jun 2019 11:37:03 -0400 Received: from lwn.net (localhost [127.0.0.1]) (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 A356C382; Tue, 11 Jun 2019 15:37:02 +0000 (UTC) Date: Tue, 11 Jun 2019 09:37:01 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Daniel Vetter , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Maarten Lankhorst , Maxime Ripard , Sean Paul , David Airlie , dri-devel@lists.freedesktop.org Subject: Re: [PATCH v3 33/33] docs: EDID/HOWTO.txt: convert it and rename to howto.rst Message-ID: <20190611093701.44344d00@lwn.net> In-Reply-To: <20190611060215.232af2bb@coco.lan> References: <74bec0b5b7c32c8d84adbaf9ff208803475198e5.1560045490.git.mchehab+samsung@kernel.org> <20190611083731.GS21222@phenom.ffwll.local> <20190611060215.232af2bb@coco.lan> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Tue, 11 Jun 2019 06:02:15 -0300 Mauro Carvalho Chehab wrote: > Jon, please correct me if I' wrong, bu I guess the plan is to place them > somewhere under Documentation/admin-guide/. That makes sense to me. > If so, perhaps creating a Documentation/admin-guide/drm dir there and > place docs like EDID/HOWTO.txt, svga.txt, etc would work. Maybe "graphics" or "display" rather than "drm", which may not entirely applicable to all of those docs or as familiar to all admins? > Btw, that's one of the reasons[1] why I opted to keep the files where they > are: properly organizing the converted documents call for such kind > of discussions. On my experience, discussing names and directory locations > can generate warm discussions and take a lot of time to reach consensus. Moving docs is a pain; my life would certainly be easier if I were happy to just let everything lie where it fell :) But it's far from the hardest problem we solve in kernel development, I assume we can figure it out. Thanks, jon