Re: [docs] [PATCH] manuals: updates for building on Windows (WSL 2)

[Michael Opdenacker <michael.opdenacker@bootlin.com>]

Hi Quentin,

On 10/20/22 10:14, Quentin Schulz via lists.yoctoproject.org wrote:
> Hi Michael,
>
> On 10/19/22 15:24, Michael Opdenacker via lists.yoctoproject.org wrote:
>> From: Michael Opdenacker <michael.opdenacker@bootlin.com>
>>
>> - Use the Wikipedia naming scheme: WSL 2 instead of WSLv2
>> - Take into account Windows Server 2019 and 2022 which are
>>    supported too.
>> - Improve some explanations
>>
>> Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
>> ---
>>   documentation/brief-yoctoprojectqs/index.rst  | 17 ++---
>>   documentation/dev-manual/start.rst            | 70 +++++++++----------
>>   documentation/overview-manual/yp-intro.rst    | 17 ++---
>>   .../ref-manual/system-requirements.rst        | 10 +--
>>   4 files changed, 50 insertions(+), 64 deletions(-)
>>
>> diff --git a/documentation/brief-yoctoprojectqs/index.rst 
>> b/documentation/brief-yoctoprojectqs/index.rst
>> index 7ae0ddc349..0dfb4cc7ff 100644
>> --- a/documentation/brief-yoctoprojectqs/index.rst
>> +++ b/documentation/brief-yoctoprojectqs/index.rst
>> @@ -25,18 +25,11 @@ build a reference embedded OS called Poky.
>>         in the Yocto Project Development Tasks Manual for more
>>         information.
>>   -   -  You may use Windows Subsystem For Linux v2 to set up a build 
>> host
>> -      using Windows 10.
>> -
>> -      .. note::
>> -
>> -         The Yocto Project is not compatible with WSLv1, it is
>> -         compatible but not officially supported nor validated with
>> -         WSLv2, if you still decide to use WSL please upgrade to WSLv2.
>> -
>> -      See the :ref:`dev-manual/start:setting up to use windows
>> -      subsystem for linux (wslv2)` section in the Yocto Project 
>> Development
>> -      Tasks Manual for more information.
>> +   -  You may use version 2 of Windows Subsystem For Linux (WSL 2) 
>> to set
>> +      up a build host using Windows 10 or 11 or Windows Server 2019 
>> or 2022.
>
> Matter of personal taste but I would have written:
> Windows 10, Windows 11, Windows Server 2019 or Windows Server 2022
>
> We could probably even say
> Windows 10 or later, or Windows Server 2019 or later
> since that's currently true and may lower the documentation 
> maintenance burden (provided Microsoft keeps on shipping WSL 2 in 
> later versions, but time will tell :) ).


I go for this last one, thanks!
Cheers
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com