Re: docs: Convert the Speakup guide to rst

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




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

Adding the speakup list in the loop.

Igor Matheus Andrade Torrente wrote:
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




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux