<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Sep 24, 2021 at 2:35 PM Alain Reguera Delgado <<a href="mailto:alain.reguera@gmail.com">alain.reguera@gmail.com</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"><br>
> 1. Have everything on the same site<br>
<br>
If the workflow is exactly the same for all distributions, I would go<br>
for option number one, a single documentation site and all references<br>
would point to it. There would be no distinction regarding the<br>
distribution itself. The site would document a common workflow that<br>
runs on all of them.<br></blockquote><div><br></div><div>The workflow won't be the same since every ecosystem is using different services and guidelines right now (e.g. Fedora has pagure, bodhi, community maintainers while CentOS uses <a href="http://gitlab.com">gitlab.com</a>, pagure, custom composing, build mirroring, strict change gating, Red Hat maintainers). I guess that's making the decision easy now, thanks for a good pointer!</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
> 2. Link between sites and document only specifics to an ecosystem<br>
<br>
If the workflow may vary among distributions, I would go for option<br>
number two, individual documentation sites for each distribution-<br>
specific workflow and would try to reuse all that is possible to reuse<br>
among them. In this case, each distribution-specific workflow site will<br>
have its own documentation reference. The way of reusing content among<br>
different distribution-specific workflow documentation sites could be<br>
addressed by pulling the appropriate git repos. Antora<br>
(<a href="https://docs.antora.org/" rel="noreferrer" target="_blank">https://docs.antora.org/</a>) seems to be handy for such scenario.<br></blockquote><div><br></div><div>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 ( <a href="https://pandoc.org/">https://pandoc.org/</a> ) in the meantime.</div><div><br></div><div>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.</div><div><br></div><div><br></div><div>Thank you, Alain, for those great suggestions!</div><div><br></div><div>Tomas</div><div><br></div></div></div>