Stageopdracht in Software Development: Code detective: the out-of-date documentation analyzer

Stageopdracht in Software Development: Code detective: the out-of-date documentation analyzer

Ben je ooit gefrustreerd geraakt door verouderde documentatie tijdens het ontwikkelen van een nieuwe feature? Deze stageopdracht daagt je uit om een tool te bouwen die automatisch controleert of documentatie moet worden bijgewerkt bij codewijzigingen. Je ontwikkelt een slimme “Code Detective” die codewijzigingen analyseert, vergelijkt met documentatie, en pull requests blokkeert totdat de documentatie actueel is. Hiermee verbeter je niet alleen je eigen werk, maar ook dat van toekomstige ontwikkelaars.

Benodigde interesse(s)

• Code-analyse
• CI/CD Tooling
• Artificial Intelligence
• Documentatie

Wat krijg je

• Een uitdagende stageopdracht
• Professionele begeleiding
• Trainingen gericht op jouw stagetraject
• Sparren met andere stagiairs en collega’s

Wat je gaat doen

• 35% Afstudeeronderzoek
• 40% Analyseren, ontwerpen, realiseren
• 25% Documentatie

Je kent het wel; je bent bezig met het implementeren van een nieuwe feature in een project en vindt daarvoor de ideale library. Met volle moed begin je aan de implementatie, alleen… het werkt niet?! Na uren frustratie, waarin code niet wil compileren of de applicatie bij start-up crasht, ontdek je dat de documentatie compleet verouderd is.

Iedereen heeft bovenstaand scenario als softwareontwikkelaar wel eens meegemaakt. De documentatie van een library, framework of applicatie komt niet meer overeen met de laatste versie. Hoe kunnen we ervoor zorgen dat wanneer er code gewijzigd wordt, er automatisch wordt gecontroleerd of de bijbehorende documentatie moet worden bijgewerkt?

De opdracht

Stel je voor dat je een tool kunt bouwen die effectief kan worden ingezet om automatisch te controleren of projectdocumentatie moet worden bijgewerkt wanneer de code verandert. Dit is niet alleen voor jou, maar voor iedereen die later met jouw code in contact komt. De opdracht is om als proof of concept (PoC) een slimme “Code Detective” te ontwikkelen.

Wat moet de Code Detective doen?

1. Codewijzigingen analyseren.
2. Deze wijzigingen vergelijken met de bestaande documentatie.
3. Signaleren wanneer de documentatie mogelijk verouderd is.
4. Pull requests blokkeren totdat de documentatie is bijgewerkt.

Hierbij komen de volgende uitdagingen naar boven:

• Complexiteit code-analyse: het nauwkeurig analyseren van codewijzigingen en bepalen of ze impact hebben op de documentatie.
• Contextbegrip: begrijpen welke codewijzigingen relevant zijn voor welke delen van de documentatie.
• Vals-positieven en -negatieven: hoe voorkomen we onnodige meldingen bij pull requests voor irrelevante wijzigingen?

Bonusopdracht: maak je tool nog beter door AI te integreren. Kan de tool suggesties geven voor documentatie-updates op basis van de codewijzigingen?

Wat biedt Info Support jou tijdens je afstudeerperiode?

Uiteraard bieden we je een uitstekend pakket aan afstudeervoorwaarden. Denk hierbij aan:

• Laptop
• Alle benodigde tools en ontwikkelomgevingen om je opdracht succesvol uit te kunnen voeren

Tijdens je afstudeerstage word je volledig in ons team opgenomen. Zo krijg je direct een goed beeld van de ontwikkelingen binnen onze projecten.

Daarnaast biedt Info Support jou:

• Een uitdagende stageopdracht bij een solide, groeiend en financieel gezond bedrijf
• Professionele en ervaren begeleiding, hybride werken
• Een afstudeerprogramma met onder meer trainingen, kennisavonden, projectbezoek, activiteiten en team-, unit- en bedrijfsuitjes
• Experimenteren met nieuwe producten en releases die in de pre-releasefase zitten
• Sparren met andere stagiairs en collegiale en gepassioneerde IT-collega’s
• Uitzicht op het IT Top Traineeship mét een vast dienstverband!

Over Info Support

Info Support is specialist in maatwerksoftware, data/AI solutions, beheer en trainingen en actief in de sectoren Finance, Industry, Agriculture, Food & Retail, Mobility & Public en Healthcare. Wij bieden solide en innovatieve oplossingen voor complexe en bedrijfkritische softwarevraagstukken. Onze hoofdkantoren zijn gevestigd in Veenendaal (NL) en Mechelen (BE). Op dit moment zijn er circa 500 medewerkers bij Info Support in dienst.

De werkwijze van Info Support kenmerkt zich door een aantal kernwaarden: soliditeit, integriteit, vakmanschap en passie. Deze kernwaarden zijn verweven in ons werk en de manier waarop we met elkaar omgaan. Ook dit jaar zijn we uitgeroepen tot Great Place to Work en dit jaar zelfs Best Workplace!

Om te zorgen dat alle medewerkers altijd op de hoogte kunnen zijn van de nieuwste ontwikkelingen beschikt Info Support over een inhouse kenniscentrum waar graag wordt voldaan aan de honger naar meer of andere kennis en vaardigheden.

B2-taalvaardigheid in het Nederlands is vereist.