Commit b28be570 authored by Agis Zisimatos's avatar Agis Zisimatos

Closes #62 , update repository policy,

Signed-off-by: Agis Zisimatos's avatarzisi <[email protected]>
parent dcd60791
......@@ -4,14 +4,38 @@ Hardware for SatNOGS Rotator. This repository includes all needed source files f
## Documentation
More information can be found in our [documentation](http://satnogs.org/documentation/hardware/), or our [wiki](https://wiki.satnogs.org).
## Repository policy
SatNOGS hardware repositories only track source design files. All needed derivative files (e.g. stl, grb etc) for production are created per release, packaged in an archive and uploaded linked to a [release](https://gitlab.com/librespacefoundation/satnogs/satnogs-rotator/tags).
Each major release (x.0.0) is branched out of master. Subsequent fixes (minor or not) are commited on those branches and tagged accordingly.
Master branch is most times under active development, so expect things to break. For production ready and previous releases source files check tags and branches.
More information can be found in our [wiki](https://wiki.satnogs.org/SatNOGS_Rotator_v3).
## Repository policy - Naming Convention
According to F3 - [Form, Fit and function](https://en.wikipedia.org/wiki/Form,_fit_and_function) and
[Part number, wiki page](https://en.wikipedia.org/wiki/Part_number) some rules build about the naming
convention and versioning:
* C, custom parts, placed in rotator_parts file
* H, hardware parts, placed in shared file
* A, assemblies, placed in assemblies file
* All used part numbers are placed in part-number-list spreadsheet.
* Start the number from 1000, e.g. C1000-1.
* Dash -1 (odd), are parts from same family for example M5 screws with same DIN and different lengths.
* Dash -2 (even), are parts from same family but all features are mirrored.
* Small changes in the part (fit - aspect), not affect the part number but affected the variant (-n).
* Big changes in the part or assembly (form and function aspect), affect the part number, make a new one
and replace or remove the old one.
* When a part is ready, in the commit message only this part and the message contains the revision of the part and a
release note about the changes. If needed update the drawing inside the freecad.
Then commit all sub-assemblies and the main assembly which affected by the part or parts.
* In order to add a new part take a new part number according to the part number list (spreadsheet).
* When a part or assembly isn't ready for release, in commit message add WIP, work in progress, write the
changes must be done, refers to the issue.
* When all parts and assemblies are ready and working properly, a release is done with tagging the last commit
and a file with all fabrication files like *.stl, *.step, *.pdf (for drawings), *.dxf (for 2D parts) are generated
which each file is naming with pn_revN.*
* Master branch is most times under active development, so expect things to break.
* Assembly is broken down to specific groups, sub-assemlies. The first priority of assembly levels is to help the designer in
design process and not in the real assembly. The second priority is to make assemblies that helps in assembly process.
We never work on very large assemblies, due to limitation in CAD program.
* Try to use a coordinate system that is fit in the main assembly.
* Drawing revision does not exist, only part or assembly revision is modified. When a small change is done in drawing for example in text the revision isn't change because the part or assembly isn't change.
## Contribute
......@@ -19,6 +43,5 @@ The main repository lives on [Gitlab](https://gitlab.com/librespacefoundation/sa
## License
&copy; 2014-2015 [Libre Space Foundation](http://librespacefoundation.org).
[![Libre Space Foundation](https://img.shields.io/badge/%C2%A9%202014--2018-Libre%20Space%20Foundation-6672D8.svg)](https://librespacefoundation.org/)
Licensed under the [CERN OHLv1.2](LICENSE).
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment