Armacom Coding-Guidelines

Die Qualität einer Softwarelösung hängt wesentlich von der Qualität des Quellcodes ab. Deshalb achten wir bei der Entwicklung auf sauberen, wartbaren und nachvollziehbaren Code.

Dabei berücksichtigen wir insbesondere:

  • gut dokumentierten Quellcode
  • klare und konsistente Code-Strukturen
  • Vermeidung von Code-Duplikationen
  • objektorientierte Entwicklung
  • Einsatz bewährter Design-Patterns

 

Versionsverwaltung & Entwicklung

Um Software langfristig wartbar und nachvollziehbar zu halten, setzen wir auf transparente Entwicklungsprozesse und zentrale Versionsverwaltung. Dafür verwenden wir GitLab (Armacom VCS).

Codeänderungen werden regelmässig versioniert und nach definierten Qualitätsrichtlinien in den Main-Branch übernommen.

Dabei achten wir insbesondere auf:

  • getesteten und funktionalen Code
  • nachvollziehbare und möglichst kleine Änderungen
  • saubere Merge- und Review-Prozesse
  • versionierte Releases mittels Tags für produktive Softwarestände

Dadurch bleiben Änderungen transparent, reproduzierbar und auch bei mehreren Entwicklern jederzeit nachvollziehbar.

 

Dokumentation

Quellcode wird direkt im Code dokumentiert, um Funktionen, Abläufe und Entwicklungsentscheidungen nachvollziehbar zu machen. Kommentare erfolgen nach Möglichkeit in englischer Sprache und in angemessenem Umfang.

Auch Commits im Armacom VCS werden aussagekräftig dokumentiert und beschreiben klar die enthaltenen Funktionen, Änderungen oder Bugfixes. Zusätzlich werden, sofern relevant, Versionsänderungen sowie Referenzen auf Anforderungen oder ergänzende Dokumentationen festgehalten.

FAQ

Was ist euch bei der Software Entwicklung besonders wichtig?

Wir entwickeln Software nachhaltig und setzen auf etablierte Technologien, sauber dokumentierten Code und langfristige Wartbarkeit.


Welche Technologien setzt Armacom ein?

Zu den Technologien, die wir regelmässig aus unserem Werkzeugkasten einsetzen, gehören:

Programmiersprachen

- Phyton

- TypeScript

- JavaScript

- Java

- PHP

Frameworks

- Django

- React

- Next.js

- Angular

- FastAPI

- Laravel

Unser Fokus liegt dabei auf den fett markierten Technologien. Gleichzeitig achten wir darauf, für jedes Projekt die passende technologische Grundlage zu wählen.

Interessiert an weiteren Informationen?

Massgeschneiderte Softwarelösungen

► KI & Automatisierungen