On 06/09/2023 15:47, Aleksandra Fedorova wrote: > Hi, folks, > > I was playing with the ways to organize the CentOS Documentation site > and came up with the following proposal: > > https://hackmd.io/@bookwar/centos-docs-layout > > The link has more details but in short we need three categories of content: > > * User Documentation: everything about installing and administering > the CentOS system. Large guides go here, as well as small Knowledge Base > articles. > > * Project Documentation: All about processes and policies of the > CentOS Project. > > * SIGs documentation: Documentation subtrees maintained by each > Special Interest group on their own. > > Note that by SIG docs here I mean documentation written and owned by > individual special interest groups. The current SIG Guide > (https://sigs.centos.org/guide/) belongs to the "Project Documentation" > section in this hierarchy. These ones (SIGs docs) already exist and are all rendered via mkdocs (from various git repositories) and so already under https://sigs.centos.org so no need to change the existing (and working) workflow :-) FWIW, just waiting on Shaun to turn wiki into read-only static html files (we have a PoC and just need a "go" from Docs-SIG (see https://pagure.io/centos-infra/issue/1245) so content will be available (and stored in a git repo itself) > > Each top-level item is then expanded to more sub-levels. > > For many of the items mentioned in the proposal we do not have the > content written yet. But if we agree on the layout, we can start by > rearranging existing documents to fit the hierarchy. > > Then we will be able to use the proposed map for any new content, which > we add in the future. > -- Fabian Arrotin The CentOS Project | https://www.centos.org gpg key: 17F3B7A1 | @arrfab[@fosstodon.org] -------------- next part -------------- A non-text attachment was scrubbed... Name: OpenPGP_signature Type: application/pgp-signature Size: 840 bytes Desc: OpenPGP digital signature URL: <http://lists.centos.org/pipermail/centos-devel/attachments/20230906/6d4d4920/attachment-0001.sig>