federate-your-repos/README.md

# federate-your-repos

Support mirroring your federated repositories to common plattforms in order to get found.

## Contents

- [federate-your-repos](#federate-your-repos)
  - [Contents](#contents)
  - [Rationale](#rationale)
  - [Concept](#concept)
    - [Mirroring](#mirroring)
    - [Artifacts \& CI](#artifacts--ci)
  - [Development \& mirrors](#development--mirrors)

## Rationale

It is always the same - it's about regaining digital sovereignty.

With OpenSource, the story is absolutely comparable to the situation on Twitter, Facebook or Youtube. You have invested countless hours to realize your idea and building a community. The big platforms profit from this.

We advocate that the fruits of our investment end up with us and not with Microsoft, Facebook, Twitter or Gitlab.

So we will no longer propagate links to Github, Gitlab or any other non OSS platform. Our ideal world is fully federated.

But we don't live in this perfect world yet. That is why we present our model to handle this intermediate time. Here are some principles:

1. Any marketing invest (links in blogs, mblogs, toots, ...) will link to our own repository.
2. In order to enable interaction with our community we accept issues & PR on the most relevant and the least unappealing platform.
3. We interact primarily with the platform our CI is running on.
4. We mirror our repository to the remaining bunch of platforms in order to get found if someone is searching for our OpenSource solution.
5. Every repository has a section where we accept Issues & PRs and where mirrors exist.

## Concept

### Mirroring

At the moment our CI is running on gitlab, so thats our current model

```mermaid
flowchart LR
    m[Maintainer]
    co[Community]
    o[Origin at out repo server]
    gh[mirror at GitHub]
    gl[mirror at GitLab for CI]
    cb[mirror at codeberg for federation test]
    m -->|interact| o
    o -->|mirror on push| gh
    o -->|mirror on push| gl
    gl -->|artefacts from ci| o
    o -->|mirror on push| cb
    co -->|issues & PR| cb
    cb -->|PR manual with git| o
```

### Artifacts & CI

<div style="background-color: white;">

![](doc/ciAndArtifacts.svg)

</div>

## Development & mirrors

Development happens at: https://repo.prod.meissa.de/meissa/federate-your-repos

Mirrors are:

* https://codeberg.org/meissa/federate-your-repos (issues and PR)
* https://gitlab.com/domaindrivenarchitecture/federate-your-repos 
* https://github.com/DomainDrivenArchitecture/federate-your-repos

For more details about our repository model see: https://repo.prod.meissa.de/meissa/federate-your-repos