Re: [PATCH 5/8] Add qemuarm64-stretch multiconfig

[Alexander Smirnov <asmirnov@ilbers.de>]

On 02/19/2018 02:15 PM, Jan Kiszka wrote:
> On 2018-02-19 11:23, Alexander Smirnov wrote:
>> On 02/16/2018 11:52 AM, Jan Kiszka wrote:
>>> From: Jan Kiszka <jan.kiszka@siemens.com>
>>>
>>> Extend the image build script as needed and add a multiconfig that
>>> allows to build a qemuarm64 target using stretch. Also add a machine
>>> config for QEMU.
>>
>> This patch makes the documentation out-dated:
>>
>> https://github.com/ilbers/isar/blob/master/doc/user_manual.md#getting-started
>>
>>
>> Should I expect updated for user_manual?
> 
> The user manual is widely outdated already, and we are about to change
> further fundamental aspects of Isar (proper wic integration, multistrap
> removal, ...). Let's wait for that to finish, then rewrite the manual.
> 

I couldn't agree with such approach. Isar is the community project, so 
at anytime new users could appear, keeping out-dated documentation or 
even invalid one, makes the whole project unusable. Also I suppose in 
near future we will be in permanent "about to change fundamentals".
It would be nice to define who and when will document new features, so 
the new official release could be announced.

Alex