[prev in list] [next in list] [prev in thread] [next in thread] 

List:       centos-docs
Subject:    [CentOS-docs] State of CentOS Wiki and other CentOS documentation sources
From:       Tomáš Glozar <tglozar () gmail ! com>
Date:       2023-08-23 14:37:18
Message-ID: CAHtyXDfFe1COToqO8T92y0wTDFPhOAaqpWjtv+N86v0DO622+g () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


Note: Re-sending this email, since it looks like it didn't arrive to the ML
the first time. I apologize if the message is duplicated.

The CentOS Wiki is being referenced as the main documentation source
from the CentOS homepage, being in the Documentation menu on
https://www.centos.org/ along with https://docs.centos.org/ and
https://www.centos.org/keys/. Neither of these are most relevent to a
reader who wants to read documentation about CentOS.

CentOS Wiki is outdated and behind what is happening in the CentOS
Project. This can be seen in its homepage mentioning CentOS Linux 7
first, only then it gets to Stream 8, which is the primary and soon to
be only Linux distribution by the CentOS Project. CentOS Stream 9 is
missing altogether, also from the Downloads page (which, confusingly,
is not the primary download page for CentOS;
https://www.centos.org/download/ is). The rest of the wiki contains
mostly legacy information about CentOS Linux and information about
CentOS Stream 8.

CentOS Docs page at https://docs.centos.org/ only mentions how to
contribute to CentOS Stream documentation plus links to legacy CentOS
Linux documentation, no mention of the current WIP documentation at
https://redhat.gitlab.io/centos-stream/docs/enterprise-docs/,
https://redhat.gitlab.io/centos-stream/src/kernel/documentation/, and
https://docs.infra.centos.org/.

Have you considered reworking the links such that either the
up-to-date documentation is available from the CentOS homepage or
linked from CentOS Wiki and CentOS Docs? I know there has been a
discussion about how to organize CentOS documentation post-Stream in
https://lists.centos.org/pipermail/centos-docs/2022-August/033755.html,
but it looks that no much happened since then.

I can imagine people coming to the CentOS page being disappointed and
choosing Alma or Rocky instead just because of this. It would help if
CentOS explained what the situation about its documentation is on a
visible place, e.g. a box on the CentOS Wiki homepage. What do you
think? I'd be happy to contribute to the documentation effort as time
allows.

Tom=C3=A1=C5=A1 Glozar

[Attachment #5 (text/html)]

<div dir="ltr"><div>Note: Re-sending this email, since it looks like it didn&#39;t \
arrive to the ML the first time. I apologize if the message is \
duplicated.<br></div><div><br></div><div>The CentOS Wiki is being referenced as the \
main documentation source</div> from the CentOS homepage, being in the Documentation \
menu on<br> <a href="https://www.centos.org/" rel="noreferrer" \
target="_blank">https://www.centos.org/</a> along with <a \
href="https://docs.centos.org/" rel="noreferrer" \
target="_blank">https://docs.centos.org/</a> and<br> <a \
href="https://www.centos.org/keys/" rel="noreferrer" \
target="_blank">https://www.centos.org/keys/</a>. Neither of these are most relevent \
to a<br> reader who wants to read documentation about CentOS.<br>
<br>
CentOS Wiki is outdated and behind what is happening in the CentOS<br>
Project. This can be seen in its homepage mentioning CentOS Linux 7<br>
first, only then it gets to Stream 8, which is the primary and soon to<br>
be only Linux distribution by the CentOS Project. CentOS Stream 9 is<br>
missing altogether, also from the Downloads page (which, confusingly,<br>
is not the primary download page for CentOS;<br>
<a href="https://www.centos.org/download/" rel="noreferrer" \
target="_blank">https://www.centos.org/download/</a> is). The rest of the wiki \
contains<br> mostly legacy information about CentOS Linux and information about<br>
CentOS Stream 8.<br>
<br>
CentOS Docs page at <a href="https://docs.centos.org/" rel="noreferrer" \
target="_blank">https://docs.centos.org/</a> only mentions how to<br> contribute to \
CentOS Stream documentation plus links to legacy CentOS<br> Linux documentation, no \
mention of the current WIP documentation at<br> <a \
href="https://redhat.gitlab.io/centos-stream/docs/enterprise-docs/" rel="noreferrer" \
target="_blank">https://redhat.gitlab.io/centos-stream/docs/enterprise-docs/</a>,<br> \
<a href="https://redhat.gitlab.io/centos-stream/src/kernel/documentation/" \
rel="noreferrer" target="_blank">https://redhat.gitlab.io/centos-stream/src/kernel/documentation/</a>, \
and<br> <a href="https://docs.infra.centos.org/" rel="noreferrer" \
target="_blank">https://docs.infra.centos.org/</a>.<br> <br>
Have you considered reworking the links such that either the<br>
up-to-date documentation is available from the CentOS homepage or<br>
linked from CentOS Wiki and CentOS Docs? I know there has been a<br>
discussion about how to organize CentOS documentation post-Stream in<br>
<a href="https://lists.centos.org/pipermail/centos-docs/2022-August/033755.html" \
rel="noreferrer" target="_blank">https://lists.centos.org/pipermail/centos-docs/2022-August/033755.html</a>,<br>
 but it looks that no much happened since then.<br>
<br>
I can imagine people coming to the CentOS page being disappointed and<br>
choosing Alma or Rocky instead just because of this. It would help if<br>
CentOS explained what the situation about its documentation is on a<br>
visible place, e.g. a box on the CentOS Wiki homepage. What do you<br>
think? I&#39;d be happy to contribute to the documentation effort as time<br>
allows.<font color="#888888"><br>
<br>
Tomáš Glozar</font></div>



_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
https://lists.centos.org/mailman/listinfo/centos-docs


[prev in list] [next in list] [prev in thread] [next in thread]