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
lists.automotivelinux.org
www.linuxfoundation.org
Jan-Simon
------
Jan-Simon Möller
AGL Release Manager
The Linux Foundation
Visit us at:
www.automotivegradelinux.org
lists.automotivelinux.org
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 (#8757) | Reply To Group | Reply To Sender | Mute This Topic | New Topic
Your Subscription | Contact Group Owner | Unsubscribe [list-automotive-discussions82@xxxxxxxxxxx]
_._,_._,_
