Repositories Policy

From SatNOGS
Revision as of 10:19, 29 August 2017 by Comzeradd (talk | contribs) (add markdown tag)

Template:MARKDOWN

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