Repositories Policy

From SatNOGS Wiki
Revision as of 21:19, 2 February 2019 by Cshields (talk | contribs) (deprecated warning)
Important.png
This page is out of date and should be removed soon.

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