Template Repository¶
This project is a template repository for creating new repositories with a pre-defined structure. This template repository is relevant for sommerfeld.io projects.
Todo - Remove if not needed
Short introduction to the project, its goals, and objectives.
- Documentation Website
- Github Repository
- Where to file issues
- Project Board for Issues and Pull Requests
Requirements and Features¶
This section outlines the basic requirements and features of the project. These requirements serve as a guideline for the development of the application and provide a clear overview of the expected functionality.
Todo - Remove if not needed
Short description of the functional requirements, driving forces, extract (or abstract) of requirements. Maybe link to GitHub issues (which are written as user stories) or to link some BDD-style executable specifications.
Usage¶
Todo - Remove if not needed
The basic commands to get any response from the system. This could be a simple docker run ...
command. Link to the Getting started guide for more detailed instructions.
Scope and Context¶
Todo - Remove if not needed
Who is the target audience of the software? Who are the stakeholders? Use a list when stakeholders are clearly identifiable. Otherwise write a short description (e.g. when stakeholders are possibly everybody because the software is offered as open source to the whole world). Scope and context delimits your system (i.e. your scope) from all its communication partners (neighboring systems and users, i.e. the context of your system). It thereby specifies the external interfaces. If necessary, differentiate the business context (domain specific inputs and outputs) from the technical context (channels, protocols, hardware).
Architecture Constraints¶
Todo - Remove if not needed
Any requirement that constraints software architects in their freedom of design and implementation decisions or decision about the development process. These constraints sometimes go beyond individual systems and are valid for whole organizations and companies. Only list constraints that are not covered in the Development Guide.
Building Block View¶
Todo - Remove if not needed
The building block view shows the components of the system and their relationships. It is a high-level view of the system architecture. Maybe think of C4 model diagrams. Do not write too much text here.
Contact¶
Feel free to contact me via sebastian@sommerfeld.io or raise an issue in this repository.