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

Re: docs: Convert the Speakup guide to rst

From: Igor Torrente <hidden>
Date: 2021-06-01 15:39:08
Also in: lkml

Hi Samuel,

On 5/31/21 7:07 PM, Samuel Thibault wrote:
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 was reading all the emails sent in this thread, but I'm not sure how I 
should proceed. Do think should I continue to improve the patch with the 
Jani Nikula suggestions? Or abandon it? Or keep both versions?
Samuel
Thanks,
---
Igor M. A. Torrente
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help