From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa2.mentor.iphmx.com (esa2.mentor.iphmx.com [68.232.141.98]) by sourceware.org (Postfix) with ESMTPS id B90FF385114B; Mon, 17 Oct 2022 22:26:07 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org B90FF385114B Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com X-IronPort-AV: E=Sophos;i="5.95,192,1661846400"; d="scan'208";a="85015315" Received: from orw-gwy-02-in.mentorg.com ([192.94.38.167]) by esa2.mentor.iphmx.com with ESMTP; 17 Oct 2022 14:26:05 -0800 IronPort-SDR: RbaEa1fH3+aUnpfwsuOgQ/hkpXs1wGCRLwFifny45s72u794+3mq5I3KmgX6ptNEaEEDI6kMPs I/XHB8dSI3pWPLaq5pgxyLzKOmEuBmFem61IFOVJRWHMWDLYu5IKkru9x2EdB/Vwj8jgasb4q+ 1spSWW6uM/B15jkf/MhYJ0uWk0gUEBgMin5+9szH0OfMOlSUNewqE94JXcpPMjyuWMvGX6vNs0 IrxjD3nZiPgkEfUDccAJ9jjoxSPbM1uvcfFKh/q1R8yHpUyKOiEo3dLat/GFx2nnwh8sRH51LC 7v0= Message-ID: <5088118f-ae16-c746-2889-71ae6a4e2c3a@codesourcery.com> Date: Mon, 17 Oct 2022 16:26:02 -0600 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 Subject: Re: Announcement: Porting the Docs to Sphinx - 9. November 2022 Content-Language: en-US To: =?UTF-8?Q?Martin_Li=c5=a1ka?= , GCC Patches , GCC Development CC: "Joseph S. Myers" , Gerald Pfeifer References: <9975b774-46d7-8870-fd92-498f5ec50ab4@suse.cz> <9ea57a95-fefe-81a3-848e-ede0893f5b61@suse.cz> <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> From: Sandra Loosemore In-Reply-To: <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 8bit X-ClientProxiedBy: svr-orw-mbx-12.mgc.mentorg.com (147.34.90.212) To svr-orw-mbx-13.mgc.mentorg.com (147.34.90.213) X-Spam-Status: No, score=-4.0 required=5.0 tests=BAYES_00,HEADER_FROM_DIFFERENT_DOMAINS,KAM_DMARC_STATUS,NICE_REPLY_A,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On 10/17/22 07:28, Martin Liška wrote: > Hello. > > Based on the very positive feedback I was given at the Cauldron Sphinx Documentation BoF, > I'm planning migrating the documentation on 9th November. There are still some minor comments > from Sandra when it comes to the PDF output, but we can address that once the conversion is done. My main complaint about the PDF is that the blue color used for link text is so light it interferes with readability. Few people are going to print the document on paper any more, but I did try printing a sample page on a grayscale printer and the blue link text came out so faint that it was barely visible at all. An E-ink reader device would probably have similar problems. I'm generally not a fan of the other colors being used for formatting, either. To me it seems like they all interfere with readability, plus in code samples it seems like random things get highlighted in random colors, instead of focusing on the thing the example is trying to demonstrate. I've been preferring to use the PDF form of the GNU manuals because it is easier to search the whole document that way. The search feature in the new web version doesn't quite cut it.... it gives you a list of web pages and then you have to do a second browser search within each page to find the reference. So I hope we can continue to support the PDF as a canonical format and better tune it for easy readability, instead of assuming that most people will only care about the online web version. -Sandra