On 27/09/2021 16:49, Tomas Tomecek wrote: <snip> >> The way of reusing content among > different distribution-specific workflow documentation sites could be > addressed by pulling the appropriate git repos. Antora > (https://docs.antora.org/ <https://docs.antora.org/>) seems to be > handy for such scenario. > > > Thanks for the tip! Antora looks like an interesting project and a good > fit, we'll definitely check it out more closely. I was looking at pandoc > ( https://pandoc.org/ <https://pandoc.org/> ) in the meantime. > > You are right that we'll need to create documentation for every > ecosystem to describe the specific workflow. Once we have that we can > try pulling the shared content or link to it and decide what's better. I > guess I'll make another thread in future when we have a concrete > proposal with actual documents instead of just an abstract idea. > Wondering if we can combine with another proposal that we wanted to present for the SIGs : it all started from the Automotive SIG and initial request to provide a simple doc like the one we use for the infra doc (all based on mkdocs - https://www.mkdocs.org/) : https://pagure.io/centos-infra/issue/458 So basically, that would be something like https://sigs.centos.org/<sig_name> and content being built from a git origin url (hosted wherever SIGs want, as long as it's public doc) and it would be rendered automatically -- Fabian Arrotin The CentOS Project | https://www.centos.org gpg key: 17F3B7A1 | twitter: @arrfab -------------- 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/20210928/e858012a/attachment-0005.sig>