[Feature Request]: Cross-repo snippets/includes

[florent-leborgne]

Prerequisites

• I have searched existing issues to ensure this feature hasn't already been requested
• I have tested using the latest version of docs-builder

What problem are you trying to solve?

Snippets and more generally reuse in documentation are a great way to display the important information anywhere it's needed while maintaining a single source of truth.

It would be super awesome if documentation files in different repositories could also share snippets.

This actually is not a simple nice to have, it's rather important in a multi-repo docs setup like ours

Proposed Solution

Just like we do with cross-repo links, what if we could include files with similar links, like {include} repo://path_to_snippet

Examples and Research

No response

Alternative Solutions

No response

Additional Context

No response

How important is this feature to you?

Important

[reakaleek]

IMO, it would be easy for assembler builds.

The bigger problem is the isolated build, and therefore, the previews.

@Mpdreamz what are your thoughts on this?

[Mpdreamz]

Not sharing is pivotal to the stability of our system.

It's what makes our builds idempotent, repeatable, immutable.

Let's discuss these snippets maybe they are directives in disguise?

Otherwise git submodules would be a way to share reliably but they come with their own DX challenges.