Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Subject: Re: docs: Convert the Speakup guide to rst
To:     Samuel Thibault <samuel.thibault@ens-lyon.org>,
        Igor Matheus Andrade Torrente <igormtorrente@gmail.com>,
        speakup@linux-speakup.org, corbet@lwn.net,
        gregkh@linuxfoundation.org, grandmaster@al2klimov.de,
        rdunlap@infradead.org, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org
References: <20210531215737.8431-1-igormtorrente@gmail.com>
 <20210531220754.h4ep2dj65wl6hejf@begin>
From:   Didier Spaier <didier@slint.fr>
Message-ID: <393c2df8-9cb1-f428-5629-6e98c078c24f@slint.fr>
Date:   Tue, 1 Jun 2021 00:42:22 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.12.0
MIME-Version: 1.0
In-Reply-To: <20210531220754.h4ep2dj65wl6hejf@begin>
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Precedence: bulk

Hello,

On 01/06/2021 00:07, Samuel Thibault wrote:
> Mmm, I'm unsure how the result is readable with the speakup screen
> reader itself. I have attached the result, could people on the speakup
> mailing list check how well it goes? If it significantly degrades
> readability, we'll have to reject the move to rst formatting, since in
> the end it's people who use the speakup screen reader who need to be
> able to read this document.
> 
> Samuel

Can we not have two versions? I don't have Sphinx installed (used to format
https://www.kernel.org/doc/html/latest/index.html) but converted 
speakup.rst to
html5 using rst2html5.py and indeed the output is way better looking and 
easier
to navigate than the txt version.

And anyway can we just provide a link to the web page that will be built
from the rst file? I think it should be accessible in graphical web 
browsers as
in console ones (I tried using links, lynx and w3m).

As an aside the document still states:
Speakup does NOT support usb connections!

Is it still true? PS I widely prefer the asciidoc/asciidoctor format 
than rst,
but the choice has been done for the Linux Kernel documentation, I know...

Didier