Feedback

Feedback

De feedback punten die ik heb gekregen om mijn feature en documentatie beter te maken:

Van de docent

• Je readme begint al aardig vorm te krijgen en er is ook een license en code of conduct, top! Je zou bovenin, voor iemand die voor het eerst op je repo komt, nog iets uitgebreider kunnen uitleggen wat je project nu eigenlijk precies is / doet. Een paar screenshots doen vaak ook wonderen. En om het te installeren en aan de praat te krijgen, moet ik misschien ook nog iets doen voor de database?
• Een discussiepunt voor vrijdag zal ook code quality zijn. Ben jij daadwerkelijk met een formatter en linter (ESLint, denk ik?) bezig geweest?
• Ik zie al veel goede research, ook dat is top! Een paar stukken zijn nog in te vullen.
• Je conceptbeschrijving kan nog iets worden aangescherpt. Het is bijvoorbeeld fijn dat je hebt gekeken naar je doelgroep en vergelijkbare sites. Welke lessen neem je daar uit mee? Hoe komt die info terug in je ontwerp? Op de pagina concept staat wel duidelijk wat je gaat bouwen, maar op de pagina job stories zou je dat ook mogen vermelden. De requirements en designs mogen vervolgens echt specifiek over je gekozen job story gaan.

Hiermee ben ik snel aan de slag gegaan, zodat ik dit nog voor de deadline af zou hebben. Zo heb ik in mijn README.md duidelijker op geschreven wat de bezoeker van mijn repo nou eigenlijker op mijn repo kan vinden. Daarnaast heb ik ook aangegeven bij hoe je mijn repo kan installeren dat je een database moet aanmaken met MongoDB en waar je de link naar je database moet zetten. Verder ben ik ook verder gegaan met de onderdelen die ik nog moest onderzoeken en informatie over moest opschrijven en heb ik mijn concept duidelijker opgeschreven, aangegeven wat ik meeneem uit het onderzoek en mijn requirements list uitgebreid met een requirements list specifiek voor mijn feature.