Tomas, What would the searchability be for a new contributor in order to find the information? Can we do 'includes' of pages so that shared content is in one location and can be included to others? That way for example a Fedora page talks about Fedora and then includes the information that is relative to all projects and then could even return to Fedora specific information. Thanks, Amy *Amy Marrich* She/Her/Hers Principal Technical Marketing Manager - Cloud Platforms Red Hat, Inc <https://www.redhat.com/> amy at redhat.com Mobile: 954-818-0514 Slack: amarrich IRC: spotz <https://www.redhat.com/> On Fri, Sep 24, 2021 at 5:09 AM Tomas Tomecek <ttomecek at redhat.com> wrote: > Hello, we're interested in hearing your feedback, the CentOS community, as > well as my Red Hat colleagues. > > Within our team (packit, context - source-git repos and workflow) we've > recently discussed what would be the preferred way of structuring > documentation for the source-git workflow. The thing is that the workflow > would be available in Fedora, CentOS Stream (and transitively RHEL) while > having some common documentation hosted in our project's documentation. > That causes fragmentation and the need to link between various sources. > > I'd like to hear what are your preferences: > > 1. Have everything on the same site > > 2. Link between sites and document only specifics to an ecosystem > > Both of these have pros and cons: > * duplicate content vs. linking between sources > * everything on the same place vs. the need to access multiple sources > * the need to automate the publication process > * translate documentation sources between various formats > * maintenance burden for the duplicate or fragmented content > > Right now we have some documentation available here > https://docs.centos.org/en-US/stream-contrib/contributing/source-git/ > while the technical details live on https://packit.dev/source-git > Is this fine or should we improve? The feedback we got so far was to unify > it in a single place so I wanted to open up a discussion to hear more. > > > Thank you for your time, > Tomas > > _______________________________________________ > CentOS-devel mailing list > CentOS-devel at centos.org > https://lists.centos.org/mailman/listinfo/centos-devel > -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.centos.org/pipermail/centos-devel/attachments/20210924/2becc9a2/attachment-0003.html>