<div dir="ltr">Thanks so much for your work on this and the further clarification! I really like the layout and the acknowledgement that things that are currently working where they are do not need to be changed:)<div><br></div><div>Amy<br clear="all"><div><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><p style="font-size:12px;margin:0px;text-transform:capitalize;font-family:RedHatText,sans-serif"><b>Amy Marrich</b></p><p style="font-size:12px;margin:0px;text-transform:capitalize;font-family:RedHatText,sans-serif">She/Her/Hers</p><p style="font-size:12px;margin:0px;text-transform:capitalize;font-family:RedHatText,sans-serif">Principal Technical Marketing Manager - Cloud Platforms</p><p style="margin:0px 0px 4px;font-size:12px;font-family:RedHatText,sans-serif"><a href="https://www.redhat.com/" style="margin:0px" target="_blank"><font color="#0b5394">Red Hat, Inc</font></a></p><div style="margin-bottom:4px"></div><p style="margin:0px;font-size:12px;font-family:RedHatText,sans-serif"><span style="margin:0px;padding:0px"><a href="mailto:amy@redhat.com" target="_blank"><font color="#0b5394">amy@redhat.com</font></a><br></span></p><p style="margin:0px;font-size:12px;font-family:RedHatText,sans-serif"><span style="margin:0px;padding:0px"></span>Mobile: 954-818-0514<br></p><p style="margin:0px;font-size:12px;font-family:RedHatText,sans-serif">Slack: amarrich</p><p style="margin:0px;font-size:12px;font-family:RedHatText,sans-serif">IRC: spotz</p><div style="margin-top:12px"><table border="0"><tbody><tr><td width="100px"><a href="https://www.redhat.com/" style="color:rgb(17,85,204)" target="_blank"><img src="https://marketing-outfit-prod-images.s3-us-west-2.amazonaws.com/f5445ae0c9ddafd5b2f1836854d7416a/Logo-RedHat-Email.png" width="90" height="auto"></a></td></tr></tbody></table></div></div></div></div></div></div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Sep 6, 2023 at 10:28 AM Fabian Arrotin <<a href="mailto:arrfab@centos.org">arrfab@centos.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 06/09/2023 17:04, Aleksandra Fedorova wrote:<br>
> On 9/6/23 16:48, Fabian Arrotin wrote:<br>
>> On 06/09/2023 15:47, Aleksandra Fedorova wrote:<br>
>>> Hi, folks,<br>
>>><br>
>>> I was playing with the ways to organize the CentOS Documentation site <br>
>>> and came up with the following proposal:<br>
>>><br>
>>> <a href="https://hackmd.io/@bookwar/centos-docs-layout" rel="noreferrer" target="_blank">https://hackmd.io/@bookwar/centos-docs-layout</a><br>
>>><br>
>>> The link has more details but in short we need three categories of <br>
>>> content:<br>
>>><br>
>>> * User Documentation: everything about installing and administering <br>
>>> the CentOS system. Large guides go here, as well as small Knowledge <br>
>>> Base articles.<br>
>>><br>
>>> * Project Documentation: All about processes and policies of the <br>
>>> CentOS Project.<br>
>>><br>
>>> * SIGs documentation: Documentation subtrees maintained by each <br>
>>> Special Interest group on their own.<br>
>>><br>
>>> Note that by SIG docs here I mean documentation written and owned by <br>
>>> individual special interest groups. The current SIG Guide <br>
>>> (<a href="https://sigs.centos.org/guide/" rel="noreferrer" target="_blank">https://sigs.centos.org/guide/</a>) belongs to the "Project <br>
>>> Documentation" section in this hierarchy.<br>
>><br>
>> These ones (SIGs docs) already exist and are all rendered via mkdocs <br>
>> (from various git repositories) and so already under <br>
>> <a href="https://sigs.centos.org" rel="noreferrer" target="_blank">https://sigs.centos.org</a> so no need to change the existing (and <br>
>> working) workflow<br>
>> :-)<br>
> <br>
> Yes, I forgot to say it explicitly:<br>
> <br>
> I do not propose to put all docs into one repository. Or even to use the <br>
> same tooling. Existing guides should stay where the are.<br>
> <br>
> The idea is that we should have a defined hierarchy and a path how to <br>
> get to the SIG Guide from the top page on <a href="http://docs.centos.org" rel="noreferrer" target="_blank">docs.centos.org</a>. And it is <br>
> perfectly fine if following that path you use an external link and land <br>
> on a different site built by a different tool.<br>
> <br>
> So the *link* to the SIG Guide will be in the Project Documentation <br>
> section on <a href="http://doc.centos.org" rel="noreferrer" target="_blank">doc.centos.org</a>.<br>
> <br>
> Same for other parts of the documentation:<br>
> <br>
<br>
Ah ! makes sense .. and yes, huge +1 to have finally <a href="http://docs.centos.org" rel="noreferrer" target="_blank">docs.centos.org</a> the <br>
main entry point even if itself would either host docs or have pointers <br>
to other docs :-)<br>
<br>
-- <br>
Fabian Arrotin<br>
The CentOS Project | <a href="https://www.centos.org" rel="noreferrer" target="_blank">https://www.centos.org</a><br>
gpg key: 17F3B7A1 | @arrfab[@<a href="http://fosstodon.org" rel="noreferrer" target="_blank">fosstodon.org</a>]<br>
<br>
_______________________________________________<br>
CentOS-devel mailing list<br>
<a href="mailto:CentOS-devel@centos.org" target="_blank">CentOS-devel@centos.org</a><br>
<a href="https://lists.centos.org/mailman/listinfo/centos-devel" rel="noreferrer" target="_blank">https://lists.centos.org/mailman/listinfo/centos-devel</a><br>
</blockquote></div>