diff --git a/markdown/home.md b/articles/index.md similarity index 100% rename from markdown/home.md rename to articles/index.md diff --git a/articles/inhetkort/1 - broodjeszaak.md b/articles/inhetkort/1 - broodjeszaak.md new file mode 100644 index 0000000..f154bc9 --- /dev/null +++ b/articles/inhetkort/1 - broodjeszaak.md @@ -0,0 +1,14 @@ +#### De broodjeszaak +--- +Ik hoop dat ik je geen honger heb gegeven met deze titel, ik moet toegeven dat ik zelf ook honger kreeg toen ik dit voorbeeld bedacht. +Laten we beginnen. Hoe Werkmanrooster werkt is vergelijkbaar met een broodjeszaak. Jij komt binnen bij een broodjeszaak. Je loopt naar de balie en vraagt naar een bepaald soort broodje. Dit broodje wordt dan vervolgens voor je gemaakt: er worden ingrediënten voorbereid en uiteinelijk op je broodje gedaan. Uiteindelijk word het broodje ingepakt in wat papier met wat servetten, daarna kan je genieten van je broodje. + +Bij Werkmanrooster gaat het ook op deze manier. Als jij bij Werkmanrooster je naam in typt is het alsof jij bij de balie verteld wat voor je broodje je wil. Het persoon wat achter de balie staat weet wat wat er moet gebeuren om dat broodje te maken, afhangend van welk broodje je wil. Hetzelfde geld voor Werkmanrooster. Door jouw naam in te voeren op Werkmanrooster doe jij als het ware een bestelling, van je naam en verwacht jij dat er een rooster voor je gemaakt wordt. Bij beide voorbeelden is er eerst sprake van uitwisseling van informatie. Bij de broodjeszaak is het wat voor soort brood, of je er ook zout en peper op wilt, bij Werkmanrooster is het een naam, docentencode of lokaalcode. +Nadat je een naam of code hebt ingetypt, word er bij Werkmanrooster een zoektocht gemaakt naar de informatie die bij die naam of code hoort. Die [informatie](http://werkmanrooster.nl/api/search?name=Bram%20van%20der%20Veen) zijn dingen zoals, is dit rooster van een docent of een leerling, hoe heet dit persoon en wat is zijn of haar achternaam. Deze informatie word allemaal gebruikt om het zoeken naar bepaalde leerlingen, docenten, lokalen en klassen makkelijker te maken, zodat je bijvoorbeeld ook kan zoeken met je leerling nummer als je weet dat er iemand is met dezelfde voornaam als jij. Als dat allemaal gedaan is word er je rooster gehaald van de [officiële](http://roosters5.gepro-osi.nl/roosters/rooster.php?school=934) roostersite. Wat overblijft is een groot pakket van rauwe informatie. + +Deze "rauwe informatie" is net zoals rauw ingredienten. Niemand wil een hele kaas op zijn broodje, met plastic randen er nog aan vast. Nee jij wil gewoon een plakje kaas. Dit is waarom Werkmanrooster niet die rauwe informatie doorstuurd, maar eerst verwerkt net zoals bij de broodjeszaak waar je kaas eerst in plakjes word gedaan. +Nadat deze rauwe informatie is verwerkt wordt alles bij elkaar gegooid, de informatie die is gevonden bij je zoek opdracht en het rooster wat daar bij hoort. Bij de broodjeszaak zou je nu kijken naar een afgemaakt broodje. Maar zelfs dan is alles nog niet klaar, want als je een lekker broodje eenmaal in je handen hebt kan je misschien knoeien en je handen plakkerig maken. Hiervoor krijg je altijd nog wat mee. Bij de broodjeszaak word namelijk eerst je broodje ingepakt in wat papier zodat het niet gaat knoeien als je er mee rond loopt, en ze geven wat servetten zodat je, wat je dan ook knoeit, kan opruimen. Dit alles word gedaan om het "gebruiksgemak" te maximaliseren. Bij Werkmanrooster wordt de verwerkte informatie ([je rooster](http://werkmanrooster.nl/api/schedule?name=Bram%20van%20der%20Veen&tab=0)) nog in een webpagina gestopt voor dezelfde principes. Bij Werkmanrooster is het papier en de servetten de website zelf. De website, de zoekbalk en zoekknop zijn er allemaal voor gebruiksgemak. + +Als dit allemaal is gebeurd ziet het resultaat er ongeveer [zo](http://werkmanrooster.nl/rooster/Bram%20van%20der%20Veen) uit. Of je geniet van je rooster op dezelfde manier als een lekker broodje is natuurlijk de vraag. + +[Volgende (Nu wat moeilijker) >>](/moeilijker.md) diff --git a/markdown/inleiding.md b/articles/inleiding/1 - inleiding.md similarity index 100% rename from markdown/inleiding.md rename to articles/inleiding/1 - inleiding.md diff --git a/markdown/eli5.md b/articles/moeilijkheidsgraad/1 - eli5.md similarity index 100% rename from markdown/eli5.md rename to articles/moeilijkheidsgraad/1 - eli5.md diff --git a/markdown/moeilijker.md b/articles/moeilijkheidsgraad/2 - moeilijker.md similarity index 73% rename from markdown/moeilijker.md rename to articles/moeilijkheidsgraad/2 - moeilijker.md index cb15458..2100a67 100644 --- a/markdown/moeilijker.md +++ b/articles/moeilijkheidsgraad/2 - moeilijker.md @@ -1,15 +1,15 @@ -##Moeilijker +#### Moeilijker --- Hoewel veel van het process is uitgelegd in [de broodjeszaak](/broodjeszaak.md) is er meer aan de hand dan alleen het vragen van informatie en het krijgen hier van. Werkmanrooster of hoe ik het noem [rooster.io](http://git.werkmanrooster.nl/werkmanrooster/rooster-io), bestaat uit iets genaamd '`code`'. Deze code beschrijft wat een computer moet doen en wanneer. Deze code zorgd ervoor dat een computer bepaalde afwegingen maakt, bijvoorbeeld dat hij een [lijst geeft van meerdere leerlingen als er meerdere zijn gevonden](http://werkmanrooster.nl/rooster/bram) in plaats van het weergeven van [een rooster](http://werkmanrooster.nl/rooster/Bram van der Veen). Deze afwegingen komen veel voor in de `code` van rooster.io. Zo'n afweging ziet er als volgende uit in `code`. ```javascript -//leerlingen.length wil zeggen hoeveel leerlingen er zijn. -if (leerlingen.length > 1) { - //Code voor het maken van een lijst. +//found_students.length wil zeggen hoeveel leerlingen er zijn. +if (found_students.length > 1) { //Afweging: als er meer dan een leerlingen is gevonden + //Maak dan een lijst. } -else { - //Code voor het laten zien van een rooster. +else { //Als de eerste afweging niet klopt, dan gaat hij naar de volgende + //Laat een rooster zien } ``` diff --git a/markdown/broodjeszaak.md b/markdown/broodjeszaak.md deleted file mode 100644 index ae41f0b..0000000 --- a/markdown/broodjeszaak.md +++ /dev/null @@ -1,14 +0,0 @@ -#### De broodjeszaak ---- -Ik hoop dat ik je geen honger heb gegeven met deze titel, ik moet toegeven dat ik zelf ook honger kreeg toen ik dit voorbeeld bedacht. -Laten we beginnen. Hoe Werkmanrooster werkt is vergelijkbaar met een broodjeszaak. Als jij je rooster opvraagd bij Werkmanrooster gebeuren er allemaal dingen achter elkaar om ervoor te zorgen dat jij uiteindelijk je rooster te zien krijgt. Je moet het op de volgende manier zien. Jij komt binnen bij een broodjeszaak. Je loopt naar de balie en vraagt naar een bepaald soort broodje. Dit broodje wordt dan vervolgens voor je gemaakt : er worden ingrediënten voorbereid en uiteinelijk op je broodje gedaan. Uiteindelijk word het broodje ingepakt in wat papier met wat servetten, daarna kan je genieten van je broodje. - -Bij Werkmanrooster gaat het ook op deze manier. Als jij bij Werkmanrooster je naam in typt is het alsof jij bij de balie verteld wat voor je broodje je wil. Het persoon wat hier achter de balie staat weet wat hij of zij moet doen om dat broodje te maken. Hetzelfde geld voor Werkmanrooster. Door jouw naam in te voeren gaat Werkmanrooster op zoek naar de naam die je hebt ingevoerd, opzoek naar het soort brood, en pakt deze informatie zodat het verder verwerkt kan worden. -Deze [informatie](http://werkmanrooster.nl/api/search?name=Bram%20van%20der%20Veen) zijn dingen zoals je naam, leerlingid en of je wel een leerling bent en geen docent. Bij de broodjeszaak worden er nu allemaal lekkere dingen op het broodje gedaan, maar bij Werkmanrooster word je rooster opgevraagd bij de [officiële](http://roosters5.gepro-osi.nl/roosters/rooster.php?school=934) roostersite. - -Dan heb je nog in principe nog rauwe informatie (rauwe ingrediënten). Niemand wil een hele kaas op zijn broodje, met plastic randen er nog aan vast. Nee jij wil gewoon een plakje kaas. Dit is waarom Werkmanrooster niet die informatie doorstuurd, maar eerst verwerkt net zoals bij de broodjeszaak waar je kaas eerst in plakjes word gedaan. -Nadat deze rauwe informatie is verwerkt wordt alles bij elkaar gegooid (het broodje en de ingrediënten). Maar zelfs dan is alles nog niet klaar, wat je terugkrijgt is een broodje waarvan je handen plakkerig worden en wat niet handig in gebruik is, daardoor krijg je een papieren hoes voor je broodje samen met wat servetten voor "gebruiksgemak". Bij Werkmanrooster wordt de verwerkte informatie ([je rooster](http://werkmanrooster.nl/api/schedule?name=Bram%20van%20der%20Veen&tab=0)) nog in een webpagina gestopt voor dezelfde principes. Bij Werkmanrooster is het papier en de servetten de website zelf. De website, de zoekbalk en zoekknop zijn er allemaal voor gebruiksgemak. - -Als dit allemaal is gebeurd ziet het resultaat er ongeveer [zo](http://werkmanrooster.nl/rooster/Bram%20van%20der%20Veen) uit. Of je geniet van je rooster op dezelfde manier als een lekker broodje is natuurlijk de vraag. - -[Volgende (Nu wat moeilijker) >>](/moeilijker.md) [Is er nog niet]