On 9/28/21 07:39, Fabian Arrotin wrote: > 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 That sounds like a great plan. -- Rich Bowen: CentOS Community Manager rbowen at redhat.com @rbowen // @CentOSProject 1 859 351 9166