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

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

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 (#8756): https://lists.automotivelinux.org/g/agl-dev-community/message/8756
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]
-=-=-=-=-=-=-=-=-=-=-=-