[CentOS-devel] Contributor documentation: to link between sites or all-in-one?

Fri Sep 24 15:36:41 UTC 2021
Amy Marrich <amy at redhat.com>

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-0005.html>