Difference between revisions of "Repositories Policy"
(Repositories Policy) |
m (add markdown tag) |
||
Line 1: | Line 1: | ||
+ | {{MARKDOWN}} | ||
+ | |||
Intro | Intro | ||
----- | ----- |
Revision as of 10:19, 29 August 2017
Intro
SatNOGS uses GitHub for code, hardware, designs and issues repositories around the project. Each repository has a main and a co- maintainer who are ultimately responsible for committing code, versioning, accepting pull requests, triaging issues and generally owning the repo.
Naming
Any repo originating from SatNOGS project is named using `satnogs-<name>` (e.g. `satnogs-rotator`). We also maintain forks of other projects retaining their original names (e.g. `rtl-sdr`)
Versioning
Most **hardware** repos will be following this scheme:
- `master` is for current dev work. - major versions will be branched out of `master` with major version number (e.g. `v2`). - minor versions will be tags (e.g. `v2.1`).
All **software** repos are following this scheme:
- `master` reflects the production-ready state of the code. - `dev` reflects the latest development code changes. This is the default merge target for Pull Requests. - featured branches are created for development (e.g. `feature-add-single-view`), - tags will be created for major revisions that we want to point to (e.g. `v3`).
Some repos (minority, like `satnogs-antennas`) will be following a folders-based versioning as it fits more their development scheme. (sorry git lovers!)
List of repos with descriptions and maintainers
- [`satnogs-rotator`](https://github.com/satnogs/satnogs-rotator)
- *Description*: Designs for SatNOGS Rotator - *Maintainer*: Manthos Papamatthaiou - *Co-maintainer*: Agis Zisimatos
- [`satnogs-rotator-controller`](https://github.com/satnogs/satnogs-rotator-controller)
- *Description*: Electronics for SatNOGS Rotator - *Maintainer*: Agis Zisimatos - *Co-maintainer*: Manthos Papamatthaiou
- [`satnogs-docs`](https://github.com/satnogs/satnogs-docs)
- *Description*: Documentation for SatNOGS software projects - *Maintainer*: John Nemo Giannelos - *Co-maintainer*: Nikos Roussos
- [`satnogs-software`](https://github.com/satnogs/satnogs-software)
- *Description*: Various Software used in SatNOGS project - *Maintainer*: Vasilis Tsiligiannis - *Co-maintainer*: Ioannis Charitopoulos
- [`satnogs-org`](https://github.com/satnogs/satnogs-org)
- *Description*: Repo for organizational purposes and assets - *Maintainer*: Pierros Papadeas - *Co-maintainer*: Papamathaiou Manthos
- [`satnogs-preso`](https://github.com/satnogs/satnogs-preso)
- *Description*: Presentations about SatNOGS project - *Maintainer*: Pierros Papadeas - *Co-maintainer*: Eleytherios Kosmas
- [`satnogs-antennas`](https://github.com/satnogs/satnogs-antennas)
- *Description*: Designs for SatNOGS Antennas - *Maintainer*: Vasilis Tsiligiannis - *Co-maintainer*: Dimitris Papadeas
- [`satnogs-diplexer`](https://github.com/satnogs/satnogs-diplexer)
- *Description*: Designs and plans for SatNOGS Diplexer - *Maintainer*: Agis Zisimatos - *Co-maintainer*: Vasilis Tsiligiannis
- [`satnogs-tripod`](https://github.com/satnogs/satnogs-tripod)
- *Description*: Designs for SatNOGS Tripod - *Maintainer*: Dimitris Papadeas - *Co-maintainer*: Pierros Papadeas
- [`satnogs-radome`](https://github.com/satnogs/satnogs-radome)
- *Description*: Designs for SatNOGS Radome - *Maintainer*: Dimitris Papadeas - *Co-maintainer*: Pierros Papadeas
- [`satnogs-client`](https://github.com/satnogs/satnogs-client)
- *Description*: Software for SatNOGS Client - *Maintainer*: John Nemo Giannelos - *Co-maintainer*: Ioannis Charitopoulos
- [`satnogs-ansible`](https://github.com/satnogs/satnogs-ansible)
- *Description*: Ansible recipes and templates for our infrastructure setup - *Maintainer*: Nikos Roussos - *Co-maintainer*: Axilleas Pipinellis
- [`satnogs-network`](https://github.com/satnogs/satnogs-network)
- *Description*: Software for SatNOGS Network - *Maintainer*: Nikos Roussos - *Co-maintainer*: John Nemo Giannelos
- [`satnogs-db`](https://github.com/satnogs/satnogs-db)
- *Description*: Software for SatNOGS DB - *Maintainer*: Nikos Roussos - *Co-maintainer*: John Nemo Giannelos
- [`satnogs-rotator`](https://github.com/satnogs/satnogs-rotator)
- *Description*: Designs and plans for SatNOGS Rotator - *Maintainer*: Manthos Papamatthaiou - *Co-maintainer*: Agis Zisimatos
- [`upscuits`](https://github.com/satnogs/upscuits)
- *Description*: Our service monitoring site - *Maintainer*: Pierros Papadeas - *Co-maintainer*: Axilleas Pipinellis
- [`rtl-sdr`](https://github.com/satnogs/rtl-sdr)
- *Description*: SatNOGS maintained rtl-sdr fork - *Maintainer*: Vasilis Tsiligiannis - *Co-maintainer*: none