Re: [agl-dev-community] New documentation site...

["Stephane Desneux" <stephane.desneux@xxxxxxx>]

redone != published : that's arguable.

Anyway, that's your call.
---
Stephane Desneux - CTO - IoT.bzh
stephane.desneux@xxxxxxx - www.iot.bzh

On 22/10/2020 17:29, Jan Simon Moeller wrote:
> Hi all, Stephane.
> 
> All progress has been shared in the devcall and in the weekly email reports. 
> Thus there is *no surprise* that the doc site being redone.
> 
> The new site is actively being worked on and sections will be added when
> they're *updated* and done. There is no point in hosting old or outdated
> content to avoid confusion.
> 
> You want to help improve the documentation? great -> patches welcome in
> gerrit (AGL/documentation) .
> 
> 
> Best regards, Jan-Simon
> 
> ------ Jan-Simon Möller AGL Release Manager The Linux Foundation
> 
> Visit us at: www.automotivegradelinux.org
> <http://www.automotivegradelinux.org> lists.automotivelinux.org
> <http://lists.automotivelinux.org> www.linuxfoundation.org
> <http://www.linuxfoundation.org>
> 
> 
> On Thu, Oct 22, 2020 at 5:17 PM Stephane Desneux <stephane.desneux@xxxxxxx>
> wrote:
> 
> Hi all,
> 
> The documentation site http://docs.automotivelinux.org has been updated
> without notice and this is very surprising as there are some issues:
> 
> * In the migration, some recent documentation updates have been lost (see 
> https://jira.automotivelinux.org/browse/SPEC-3666).
> 
> * In the new site, we noticed some missing sections (developer guides, apis 
> etc.). I'm not aware of the plan to fill the gap with documentation/books
> coming from source repositories.
> 
> * On the content, there have been no real review of the new documentation.
> For example, as maintainers of the document 
> https://docs.iot.bzh/docs/en/master/getting_started/reference/getting-started/machines/renesas.html
>
> 
, some changes have been made in the text and we don't agree with those changes.
> Furthermore, what has been committed doesn't render properly on the new
> site. We'll have to push some updates to fix this...
> 
> I'm not against moving to new things, but I don't see the gain in having the
> new version more incomplete than the previous one...
> 
> Meanwhile, for the missing parts, IoT.bzh provides a backup (legacy) 
> documentation here: https://docs.iot.bzh .
> 
> Best regards, -- Stephane Desneux - CTO - IoT.bzh stephane.desneux@xxxxxxx -
> www.iot.bzh
> 
> 
> 
> 
> 
> 


-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#8758): https://lists.automotivelinux.org/g/agl-dev-community/message/8758
Mute This Topic: https://lists.automotivelinux.org/mt/77732264/2167316
Group Owner: agl-dev-community+owner@xxxxxxxxxxxxxxxxxxxxxxxxx
Unsubscribe: https://lists.automotivelinux.org/g/agl-dev-community/leave/4543822/883735764/xyzzy [list-automotive-discussions82@xxxxxxxxxxx]
-=-=-=-=-=-=-=-=-=-=-=-