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@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@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:
Have everything on the same site
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@centos.org https://lists.centos.org/mailman/listinfo/centos-devel