Directory structuur Kennisbank¶
Voor de structuur van de kennisbank is gekozen voor de indeling zoals die bepaald wordt door de HBO-I domeinbeschrijving van 2018.
Beroepstaken¶
Indeling¶
De indeling is als volgt voor de beroepstaken:
graph TD
Software --> Realiseren
Software --> Analyseren
Software --> Ontwerpen
Software --> MC[Manage & Control]graph TD
Infrastructuur --> Realiseren
Infrastructuur --> Analyseren
Infrastructuur --> Ontwerpen
Infrastructuur --> MC[Manage & Control]graph TD
Gebruikersinteractie --> Realiseren
Gebruikersinteractie --> Analyseren
Gebruikersinteractie --> Ontwerpen
Gebruikersinteractie --> MC[Manage & Control]graph TD
Organisatieprocessen --> Realiseren
Organisatieprocessen --> Analyseren
Organisatieprocessen --> Ontwerpen
Organisatieprocessen --> MC[Manage & Control]graph TD
Hardware --> Realiseren
Hardware --> Analyseren
Hardware --> Ontwerpen
Hardware --> MC[Manage & Control]Mappenstructuur¶
\beroeptaken
\software
\realiseren
\analyseren
\ontwerpen
\manage_and_control
\infrastructuur
\realiseren
\analyseren
\ontwerpen
\manage_and_control
\gebruikersinteractie
\realiseren
\analyseren
\ontwerpen
\manage_and_control
\organistatieprocessen
\realiseren
\analyseren
\ontwerpen
\manage_and_control
\hardware_interfacing
\realiseren
\analyseren
\ontwerpen
\manage_and_control
Professional Skills¶
Indeling¶
graph TD
TO[Toekomst Gericht Organiseren]
TO --> Managen
TO --> OC[Organisatorische context]
TO --> Ethiekgraph TD
OP[Onderzoekend Probleemoplossen]
OP --> Probleemanalyse
OP --> Onderzoeken
OP --> Oplossengraph TD
DC[Doelgericht Communiceren]
DC --> Partners
DC --> Communiceren
DC --> Samenwerkengraph TD
PL[Persoonlijk Leiderschap]
PL --> PO[Persoonlijke ontwikkeling]
PL --> OZ[Ondernemend zijn]
PL --> PP[Persoonlijke Profilering]Mappenstructuur¶
\professional_skills
\toekomst_gericht_organiseren
\managen
\organisatorische_context
\ethiek
\onderzoekend_probleemoplossen
\probleemanalyse
\onderzoeken
\oplossen
\doelgericht_communiceren
\partners
\communiceren
\samenwerken
\persoonlijk_leiderschap
\persoonlijke_ontwikkeling
\ondernemend_zijn
\persoonlijke_profilering
Mappenstructuur op de knowledgebase¶
Elke map levert een klikbare link in de uiteindelijke kennisbank op. De inhoud van de pagina die wordt getoond komt overeen met de inhoud va het eerste bestand in de map. Een goede vuistregel voor het maken van een nieuwe map is het maken van een bestand dat dezelfde naam heeft als de map maar begint met een cijfer. Dit bestand wordt dan als eerste getoond in de kennisbank. Bijvoorbeeld:
De map \software\realiseren\basisprincipes ziet er dan zo uit:
\software
0_software.md
\realiseren
0_realiseren.md
\basisprincipes
0_basisprincipes.md
array.md
class.md
variabele.md
In alle bestanden die beginnen met 0_ staat informatie over het overkoepelende thema.
Meerdere onderwerpen per artikel¶
Het kan voorkomen dat een artikel over meerdere onderwerpen gaat. Artikelen worden echter maar in één map geplaatst.
Om artikelen toch vindbaar te maken zijn er meerdere manieren:
Linken naar andere artikelen¶
In een artikel kan een link worden geplaatst naar een ander artikel. Dit kan door de naam van het artikel tussen vierkante haken te plaatsen. Bijvoorbeeld:
# Arrays
Een array is een verzameling van variabelen. [Meer informatie over variabelen](../../1_beroepstaken/software/realiseren/basis_principes/variabele.md)
Intern linken? Padnamen niet nodig
Het is niet nodig om de volledige padnaam te gebruiken als je linkt naar een ander artikel. Het is voldoende om de naam van het bestand te gebruiken. Daarom is het wel belangrijk dat alle bestanden een unieke naam hebben.
Categorieën¶
Categorieën zijn een manier om artikelen te categoriseren. Een artikel kan meerdere categorieën hebben. Categorieën worden bovenaan het artikel geplaatst in de “frontmatter” van het artikel. De frontmatter is het stukje tekst dat bovenaan het artikel staat en tussen de --- staat.