In general our O2A software is open source, free of charge and may be re-used in other contexts. Our software is administrated in the gitlab.awi.de repository and you can also find examples on github.com also. To foster and streamline software development we want to have one central managed code basis. All splitted branches for new features and bug fixes shall be finally merged into the central master branch aligned with Gitflow. The agile software development process for each O2A component is managed in 2-weekly sprints with jira-software.awi.de following SCRUM-based principles.
...
Our software development follows some simple rules as best practices. Use the following topics and tasks as guideline and checklist.
README.md
markdown file in its root directory describing the project (see template below)..gitignore
file in its root directory defining files to exclude or to force inclusion.Code Block | ||||
---|---|---|---|---|
| ||||
# Name of the project and repository content * Short description of the project and repository content. * Provide relative links to demonstrators in this repository. * Provide an overview of the architecture and relation to other projects. * Use [diagrams.net](https://diagrams.net) for your sketches and provide a editable link here. ## Getting started * Describe how to start with this project. ### Prerequisites * Describe requirements to fulfill before starting. ### Installing * Describe how to install required software and this software. ## Tests * Describe how to test this software. ## Deployment * Describe how to deploy this software including required prerequisites and configuration. ## Contributing * Describe how to contribute to this project. At best you link to general [documentation](https://spaces.awi.de/x/bu7FEw) and improve it if necessary. ## Versioning * Describe shortly the versioning approach. ## Authors * List the authors and emails here. ## License We have a BSD-3-Clause license and refer to [documentation](https://spaces.awi.de/x/bu7FEw). ## Acknowledgments * Any acknowledgements? ## Notes * Any additional notes? |
...
...