Ik maak een systeemontwerp document, software architectuur en technische specificatie
Technische documentatie en data automation voor software teams
Over deze dienst
Schrijf me gerust in het Italiaans.
Over zes maanden zal iemand vragen waarom het systeem op deze manier werkt. Als niemand de reden opschrijft, zal het team het of opnieuw bouwen of bang zijn om eraan te raken.
Ik schrijf het document dat die vraag beantwoordt voordat het wordt gesteld.
WAT JE KRIJGT
- Het probleem dat het systeem oplost en de beperkingen waar het onder leeft
- Componenten, verantwoordelijkheden en hoe ze met elkaar communiceren
- Data model en de belangrijkste flows door het systeem
- Diagrammen: context, container en sequence, in C4 of gewoon UML
- Niet-functionele doelen: schaalbaarheid, latency, beschikbaarheid, kosten
- De opties die je niet hebt gekozen en waarom - architecture decision records (Premium)
WIE KOOPT DIT
Oprichters die iets geloofwaardigs nodig hebben voor een technische investeerder of een CTO-kandidaat. Teams die een systeem overdragen aan een ander team. Agencies die aan een klant moeten laten zien wat er is gebouwd.
Ik ben een software engineer, geen schrijver die over architectuur heeft gelezen. Als je ontwerp een probleem heeft, hoor je dat van mij voordat je het uit productie hoort.
Type document:
Documentatie
•
Technische specificaties
Branche:
Software
Taal:
Engels
•
Italiaans
Voorkeur voor een leveringsstijl
Laat het de freelancer weten als je voorkeuren voor of zorgen hebt over het gebruik van AI-tools voor het voltooien en/of leveren van je bestelling.
Mijn portfolio
Veelgestelde vragen
Automatische vertaling
Kun je een ADR schrijven voor een beslissing die we al hebben genomen?
Ja, dat is het grootste deel van het werk. Ik interview degene die de beslissing heeft genomen, reconstrueer de opties en beperkingen zoals ze toen waren, en noteer de gevolgen die je sindsdien hebt gezien. Backfilled ADRs blijven nuttig.
Bepaal jij de architectuur, of documenteer je alleen?
Ik documenteer jouw beslissing. Ik wijs op een afweging die je niet hebt opgeschreven, of een gevolg dat ondergewaardeerd lijkt, maar de keuze blijft jouw. Als je liever architectuuradvies wilt, stuur me een bericht en ik vertel je of ik de juiste persoon ben.
Welk hulpmiddel gebruik je voor de diagrammen?
Standaard Mermaid of PlantUML, zodat het diagram in de repository als tekst blijft en reviewbaar is in pull requests. Als je draw.io of Excalidraw liever hebt, lever ik het bewerkbare bronbestand daarvoor.

