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:     Jani Nikula <jani.nikula@linux.intel.com>,
        Samuel Thibault <samuel.thibault@ens-lyon.org>,
        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>
 <b8769ad4-9188-a735-3ac4-4a79b9b06487@gmail.com>
 <20210601215536.5rhnbwwt66uyqhze@begin>
 <85969150-6e00-12b8-b56d-5f161436777d@gmail.com> <87pmx4pi29.fsf@intel.com>
From:   Igor Torrente <igormtorrente@gmail.com>
Message-ID: <2044b3a6-45e1-5fe9-cabb-88a2758cde24@gmail.com>
Date:   Wed, 2 Jun 2021 10:38:01 -0300
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101
 Thunderbird/78.10.0
MIME-Version: 1.0
In-Reply-To: <87pmx4pi29.fsf@intel.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Precedence: bulk

Hi Jani,

On 6/2/21 9:27 AM, Jani Nikula wrote:
> On Tue, 01 Jun 2021, Igor Torrente <igormtorrente@gmail.com> wrote:
>> Hi Samuel,
>>
>> On 6/1/21 6:55 PM, Samuel Thibault wrote:
>>> Hello,
>>>
>>> Igor Torrente, le mar. 01 juin 2021 12:39:01 -0300, a ecrit:
>>>> 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?
>>>
>>> It seems that people are fine with the switch to the .rst format, and
>>> it'll indeed allow much better distribution of its content, so please
>>> continue improving the patch with the suggestions from Jani, you have an
>>>
>>> Acked-by: Samuel Thibault <samuel.thibault@ens-lyon.org>
>>>
>>> and the review will probably come from Jani, who seems to actually know
>>> a bit about the rst syntax :)
>>
>> OK, I will keep improving it.
> 
> Heh, I just made suggestions on things that I thought could be done
> better, but please see for yourself how it renders and how it actually
> works with Braille displays. That should have priority over anything I
> suggest.

I understand and agree. But I don't have a braille display to test the 
change, so I will need the help of the community anyway.

And if anything gets worse I can revert the changes in the next patch 
version based on the feedback.

> 
> BR,
> Jani.
> 
> 

Thanks,
---
Igor M. A. Torrente