Thread (35 messages) 35 messages, 11 authors, 2021-06-04

Re: docs: Convert the Speakup guide to rst

From: Alexander Epaneshnikov <hidden>
Date: 2021-05-31 23:31:13
Also in: lkml

01.06.2021 01:07, Samuel Thibault пишет:
Hello,

Adding the speakup list in the loop.

Igor Matheus Andrade Torrente wrote:
quoted
Modify some parts of the text and add the necessary formatting to leverage
the rst features. Including links, code-blocks, bullet lists, etc.

Also, adds a table of contents at the beginning and a section to the
license.

This change helps integrate this documentation to the rest of the rst
documentation.
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.
I think this is a great change. to be honest - I myself thought to do it 
a few months ago.

As for readability, rst is a rather minimalistic format, so it is 
convenient to perceive it even in a raw format, and the advantages of 
using it, in my opinion, outweigh all the non-conveniences that I do not 
observe.

Samuel

Alexander
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help