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