Wat is dit?
Dit is jullie eigen development-portaal. Via de chat praat je met {{ agentLabel }}, een development-agent die jullie software kent en er ook echt in werkt. Je hoeft geen technische taal te gebruiken. Beschrijf gewoon wat je wil bereiken.
Alles draait om drie dingen:
- Gesprekken. Elke vraag of wens begint met een gesprek over één onderwerp.
- Taken. Uit gesprekken over nieuwe of gewijzigde functionaliteit ontstaan taken. Die volg je van "klaar om te bouwen" tot "voltooid".
- Verwerkingstijd. Je betaalt met tijd uit je weekbundel, niet per vraag.
Je kunt niets stukmaken door iets te vragen. {{ agentLabelCap }} bouwt altijd eerst op de acceptatie-omgeving. Live zetten is een aparte stap die jij zelf start.
De zes routes
Elk gesprek begint met een route: het soort vraag dat je hebt. De route bepaalt wat {{ agentLabel }} doet en ligt vast voor de hele sessie. Heb je een ander soort vraag, start dan een nieuwe sessie.
{{ helpRoute(r.id) }}
Weet je het niet zeker tussen uitdenken en ontwikkelen? Kies uitdenken. Je ziet dan eerst een voorstel en bepaalt daarna zelf of het gebouwd mag worden.
Zo verloopt een gesprek
- Klik op Nieuwe sessie en kies een route.
- Beschrijf je vraag of wens. Enter verstuurt, Shift + Enter maakt een nieuwe regel.
- {{ agentLabelCap }} gaat aan het werk. De chat gaat zolang op slot en je ziet een oplopende klok.
- Het antwoord komt in één keer binnen. Je ziet dus geen tussenstappen meelopen.
- Klopt het nog niet helemaal? Praat gewoon verder in hetzelfde gesprek. {{ agentLabelCap }} kent de hele historie van die sessie.
Je hoeft niet te blijven wachten. Zodra er een antwoord is klinkt er een geluidje, komt er een stip bij het gesprek in de zijbalk en zie je een teller in de titel van je browsertabblad.
Er kan één sessie tegelijk lopen. Werkt {{ agentLabel }} al aan iets, ook als een collega dat gestart heeft, dan wacht je tot dat klaar is. Duurt een sessie te lang, dan verschijnt na vijftien minuten de knop Sessie annuleren.
Annuleren stopt het gesprek aan jouw kant, maar het kan zijn dat {{ agentLabel }} op de achtergrond gewoon doorwerkt. Je krijgt het antwoord dan later alsnog te zien. Wacht dus even voordat je precies dezelfde vraag opnieuw stelt.
Al je gesprekken staan onder Gesprekken, de laatste ook in de zijbalk. Met het zoekveld bovenin vind je een ouder gesprek terug.
Wordt die lijst lang, klik dan bij een gesprek op Archiveren. Het verdwijnt dan uit de lijst en uit de zijbalk, maar er wordt niets weggegooid: onder het tabblad Archief lees je het gewoon terug en met Terugzetten haal je het weer naar voren. Een gesprek dat nog bezig is kun je niet archiveren.
Houd één onderwerp per sessie aan en houd dat onderwerp klein. Dat levert de beste antwoorden op en kost de minste verwerkingstijd.
Van idee naar live
Gaat een gesprek over nieuwe of gewijzigde functionaliteit, dan ontstaat er een taak op de takenlijst. Een taak is een werkitem en geen apart gesprek: het houdt bij hoe ver een wijziging is. Je kunt er ook zelf een opschrijven met Taak toevoegen, zonder er meteen iets mee te doen. Taken doorlopen altijd dezelfde vier stappen.
- To-do. Iets wat je wil, maar nog niet nu. Je schrijft het hier op in plaats van in een apart lijstje. Er gebeurt nog niets en het kost geen verwerkingstijd. Ben je er klaar voor, klik dan op Oppakken en kies: eerst uitdenken (er opent een uitdenkgesprek, en zodra het voorstel goedgekeurd is schuift deze taak door) of laten bouwen (meteen aan de slag). Een to-do kun je ook nog aanpassen of verwijderen.
- Klaar om te bouwen. Er ligt een afgestemd plan. Klik op Laten bouwen. Er opent een ontwikkelgesprek dat al is voorgevuld met de omschrijving.
- Te testen. De wijziging staat klaar op de acceptatie-omgeving. Nu is het aan jullie om te controleren of het klopt. Klopt het niet, zeg dat dan in het gesprek. De taak gaat dan terug naar "klaar om te bouwen". Blijkt het zo al goed en hoeft er niets live, klik dan op Goedkeuren. De taak gaat dan direct naar voltooid en er wordt niets uitgerold.
- Voltooid. Vink de geteste taken aan en klik op Live zetten. Er opent een live-gesprek. Zodra de livegang gelukt is, staat de taak op voltooid. Voltooide taken blijven op de lijst staan, zodat je kunt terugzien wat er is opgeleverd.
Waar ging een taak ook alweer over?
Klik een taak aan, in elke stap en ook bij voltooid. Je ziet dan de volledige omschrijving en alle gesprekken die eraan gewerkt hebben. Vanuit daar klik je zo door naar het gesprek zelf, dus je hoeft niet meer te zoeken in de gesprekkenlijst.
Live zetten gaat soms in twee stappen
- Samenvoegen van de code. De nieuwe versie en de versie die al live staat worden tot één geheel gemaakt. Zie het als twee mensen die in hetzelfde document hebben gewerkt en van wie de wijzigingen netjes worden samengevoegd. Dit werk doet {{ agentLabel }} en het kost verwerkingsminuten uit jullie bundel.
- Uitrollen naar de live-omgeving. Afhankelijk van de applicatie start daarna automatisch een uitrolproces dat de nieuwe versie echt live zet. Dat gebeurt buiten {{ agentLabel }} om en kost jullie geen verwerkingsminuten. Loopt zo'n uitrol, dan zie je dat bovenin het scherm.
Test zelf voordat je live zet. {{ agentLabelCap }} controleert het eigen werk, maar alleen jullie weten hoe het er in de praktijk uit moet zien.
Bijlagen en taken meesturen
Een screenshot zegt vaak meer dan een uitleg. Je kunt op vier manieren een bestand meesturen:
- met de knop + Bestand;
- met + Camera op je telefoon of tablet;
- door een afbeelding in het tekstvak te plakken (Ctrl + V);
- door een bestand op het tekstvak te slepen.
Maximaal 5 bestanden per bericht, elk tot 25 MB. {{ agentLabelCap }} bekijkt bijlagen echt, dus een foto van een foutmelding of een exportbestand helpt enorm. Een bericht mag ook uit alleen een bijlage bestaan.
Met de knop Taak onder het tekstvak haal je een bestaande taak aan. Er komt dan een verwijzing (#nummer) in je bericht te staan, zodat {{ agentLabel }} precies weet over welke eerder gebouwde wijziging je het hebt. Handig bij zinnen als "de knop uit taak #12 staat scheef".
Weekbundel en verwerkingstijd
Je rekent af op verwerkingstijd: de tijd die {{ agentLabel }} daadwerkelijk aan je vraag werkt. Jouw eigen denktijd kost niets en een gesprek open laten staan ook niet. Onderin de zijbalk zie je hoeveel van je weekbundel je hebt gebruikt.
- Bijna op. Je kunt nog één taak deze week doen.
- Op. Nieuwe sessies zijn geblokkeerd tot de bundel weer aanvult.
De bundel loopt in een venster van zeven dagen. Verbruik van meer dan een week terug telt niet meer mee.
Ook meedenken kost tijd. Sparren over een aanpak, een voorstel laten uitwerken of samen een groter plan opsplitsen komt uit dezelfde bundel. Dat is meestal goed besteed, want het scheelt later bouwtijd.
Een gerichte vraag ("waarom mislukt label X bij order 12345?") kost veel minder tijd dan een brede vraag ("kijk eens rond of er iets mis is"). Scherp vragen scheelt bundel.
Downloads
Levert een wijziging een bestand op, bijvoorbeeld een nieuwe versie van een app, dan verschijnt het menu-item Downloads in de zijbalk. De nieuwste versie staat bovenaan en eerdere versies klap je eronder uit. Is er nog nooit iets opgeleverd, dan is het menu-item er niet.
Let op: dit zijn opgeleverde bestanden van een build. {{ agentLabelCap }} stuurt je geen losse bestanden of exports als antwoord in de chat. Wil je gegevens uit het systeem halen, lees dan het advies over rapportages verderop.
Wat {{ agentLabel }} wel en niet doet
- Altijd eerst acceptatie. Nieuwe of gewijzigde functionaliteit komt nooit rechtstreeks live. Live zetten is een aparte stap die jullie starten.
- Meekijken in de database mag, aanpassen niet zomaar. Bij een onderzoek mag {{ agentLabel }} gegevens opvragen om de oorzaak te vinden. Lezen mag, wijzigen niet.
- Gegevens wijzigen gaat langs een mens. Moet er echt iets in de database veranderen, dan doet {{ agentLabel }} een voorstel. Een menselijke developer van Nomibots beoordeelt dat eerst en geeft akkoord. Je gesprek staat dan even in de wacht met de melding dat er iets wordt nagekeken.
- Privacy. {{ agentLabelCap }} deelt geen persoonsgegevens in de chat. Bevindingen komen samengevat of geanonimiseerd terug.
- Gewone taal. Antwoorden zijn leesbaar bedoeld. Je krijgt geen ruwe code of technische structuren voorgeschoteld, tenzij je er zelf om vraagt.
Loopt er een uitrol naar de omgeving, dan zie je bovenin het scherm een melding met de status daarvan. Die staat los van je eigen gesprek en kost geen verwerkingstijd.
Zo krijg je het beste resultaat
Dit zijn de dingen die in de praktijk het meeste verschil maken.
- Houd gesprekken kort en klein. Het werkt het beste als een ontwikkeling behapbaar is. Eén kleine wens per gesprek levert het scherpste resultaat op en kost de minste verwerkingsminuten. Kun je een groter project opknippen, doe dat dan.
- Splits een grotere wens eerst samen op. Wil je iets groots aanpakken, start dan een gesprek via de route "Iets anders" en bedenk samen met {{ agentLabel }} hoe je het opdeelt. Daarna maak je de losse onderdelen via "Functionaliteit uitdenken" stuk voor stuk aan. Dit meedenken kost ook verwerkingsminuten, maar verdient zich terug bij het bouwen.
- Beschrijf het doel, niet de oplossing. "Klanten bellen omdat ze de bezorgdatum niet zien" levert een beter resultaat op dan "zet een veld in de checkout".
- Geef precies genoeg bewijs mee. Een screenshot, een ordernummer, het tijdstip en de exacte foutmelding schelen vaak een hele onderzoeksronde. Maar overdrijf niet: een berg logs, exports en screenshots doorspitten kost juist extra verwerkingstijd. Stuur mee wat het probleem laat zien, niet alles wat je hebt.
- Denk altijd in rollen en rechten. Moet nieuwe functionaliteit maar voor een deel van de gebruikers beschikbaar zijn? Zeg er dan meteen bij voor wie wel en voor wie niet. Rechten achteraf inbouwen kost een extra ronde.
- Wil je gegevens uit het systeem? Vraag om een rapportage. {{ agentLabelCap }} levert geen losse bestanden of exports op als antwoord. Laat in plaats daarvan een rapportage-onderdeel in jullie eigen applicatie bouwen. Dat kost eenmalig verwerkingsminuten en daarna kun je die gegevens altijd zelf opvragen, zo vaak als je wil. Denk dus niet "stuur mij een lijstje", maar "bouw een plek waar dat lijstje altijd staat".
- Zeg wat níét mag veranderen. Bestaande werkwijzen, koppelingen of schermen die met rust gelaten moeten worden: benoem ze expliciet.
- Beantwoord de vragen die je terugkrijgt. Stelt {{ agentLabel }} een vraag, dan is dat omdat het antwoord de richting bepaalt. Kort antwoorden is genoeg.
- Test snel na oplevering. Hoe eerder je een "te testen"-taak bekijkt, hoe makkelijker het is om er nog iets aan bij te sturen.
- Twijfel je over de omvang? Begin met uitdenken. Je ziet dan eerst wat het wordt, voordat er tijd in bouwen gaat zitten.
Deze lijst groeit mee met de praktijk. Loop je tegen iets aan waarvan je denkt "dit had ik eerder willen weten"? Laat het weten, dan komt het hier te staan.
Als er iets misgaat
- De sessie blijft maar bezig
- Na vijftien minuten verschijnt de knop Sessie annuleren. Annuleren kost je geen verwerkingstijd. Houd er wel rekening mee dat {{ agentLabel }} op de achtergrond kan doorwerken, waardoor je het antwoord later alsnog ziet verschijnen.
- "Er is al een sessie bezig"
- Er loopt al werk, mogelijk gestart door een collega of in een ander tabblad. Wacht tot dat klaar is, of open de lopende sessie om mee te kijken.
- Het antwoord klopt niet
- Zeg het gewoon in hetzelfde gesprek. Ging het om een gebouwde wijziging, dan zet {{ agentLabel }} de taak terug naar "klaar om te bouwen" en past het aan.
- Mijn weeksaldo is op
- Je kunt geen nieuwe sessie starten tot de bundel aanvult. Heb je structureel meer nodig, neem dan contact op met Nomibots voor een groter plan.
- Er wordt "nog even iets nagekeken"
- {{ agentLabelCap }} wil iets in de database aanpassen en wacht op akkoord van een menselijke developer van Nomibots. Je hoeft niets te doen, het gesprek gaat daarna vanzelf verder.
- Wachtwoord wijzigen of uitloggen
- Klik onderin de zijbalk op je naam. Na vijf mislukte inlogpogingen is je account vijftien minuten geblokkeerd.