De tekst is het model

Een model is een structuur waarin je ziet hoe elementen zijn verbonden. Een model maken is lastig. Een verhaal schrijven kan bijna iedereen. Met conventies en goed formuleren, maak je een verhaal, dat zelf het model is. Conversie software zorgt voor het uit elkaar halen van de elementen en het in het in kaart brengen van de relaties. Als dat eenmaal is gebeurt kun je er van alles mee doen. Bijvoorbeeld:

Controleren of de elementen en de relaties correct zijn.
Een proces beschrijven.
Het verhaal omzetten naar een ontwerp voor een applicatie.

Lees verder

Navigatie Terug Verder

Het verhaal is het model

Een verhaal dat gaat over iets dat gemaakt moet worden kun je als basis voor een model gebruiken. Met conventies en consistent gebruik van woorden, zorg je ervoor dat een verhaal zelf een model is.

Een verhaal dat een model bevat hoeft niet over ICT of software te gaan.

Het voorbeeld dat we hier gebruiken is het schrijven van de documentatie over de Moxen software gebruiken voor het omzetten van teksten naar modellen.

Een compleet voorbeeld voor deze aanpak is beschikbaar voor het maken van analyses om wetteksten om te zetten naar bedrijfsregels.

Het begin van dat verhaal is hier beschreven.

Waar gaat het verhaal naar toe

Het verhaal beschrijft hoe je een tekstdocument omzet naar een model en vervolgens naar een publicatie op internet. De beschrijving van de functionaliteit is is verdeeld over meerdere documenten. In de documenten zijn verwijzingen aangebracht zodat je eenvoudig tussen de verhalen kunt navigeren.

Basis verhaal. Waarom zou je doen wat is beschreven
Document verhaal. Welke conventies en regels moet je volgen
Gebruiken van de software. Hoe converteer je een tekstdocument.
Genereren van extra elementen. Hoe doe je dat.
Inrichten van de software. Folder structuur en starten software.
Mogelijkheden benutten. Welke mogelijkheden biedt de software.
Opties beheren. Optionele instellingen beheren.
Proces doorlopen. Hoe verloopt het totale proces van de conversie.
Publiceren van de resultaten. Hoe publiceer je in een website.
Structuur van de software. Uit welke modules bestaat de software.

Wat is er nodig

Elke stap in het maken en converteren van het tekstdocument moet zo beschreven zijn dat iedere gebruiker van deze website een document kan maken en converteren eventueel met iemand die een computer en software kan beheren.

De beschrijvingen van deze stappen volgen de instructies op deze website. Dit wordt niet alleen gedaan om de werkwijze te illustreren maar ook om de beschreven werkwijze te valideren.

Je kunt hier de basis beschrijving openen.

Wat moet er gebeuren

Documenten maken en omzetten naar modellen en publicaties.

Per deelverhaal is een MS-Word document aangemaakt op een gedocumenteerde plaats in een folder..
Voor elk document zijn plaatjes toegevoegd die in de publicaties komen.
Alle documenten zijn geconverteerd op de beschreven wijze.

Voor elk document zijn deze stappen meerdere malen uitgevoerd. De resultaten zijn gevalideerd. In de resultaten kun je makkelijk zien:

of alle termen correct zijn gespeld,
of de conventies zijn toegepast,
of de structuur overeenkomt met de bedoeling.

Omdat een complete download van volledig geconfigureerde Moxen software nog niet beschikbaar is wijzen wij u op onze service.