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

[Jan Kiszka <jan.kiszka@siemens.com>]

On 2018-02-19 13:19, Alexander Smirnov wrote:
> 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.

I generally agree, but - as I said - the manual was already outdated
prior to all the recent changes. That was the reason I didn't care
updating it.

Again, it would be best to redesign the manual once all the upcoming key
user-visible changes have been send and merged. And those are IMHO

- wic
- image generation (internally via debootstrap, externally via some
  bbclass or include)
- refactoring of meta-isar to meta-isar-example

Jan

-- 
Siemens AG, Corporate Technology, CT RDA IOT SES-DE
Corporate Competence Center Embedded Linux