Overzicht beschikbare documenten

De onderstaande tabbelen geven een overzicht van reeds beschikbare handleidingen en andere documenten die voor een modelleur bij Geonovum relevant zijn.

Note Nog verwerken

  1. Handboek beheer standaarden
  2. Handleiding toepassing standaarddatatypes
  3. Document JvG, beheerinformatie GitHub, ReSpec, etc.
  4. Handleiding Logius Respec (door Linda)
  5. Handleiding GitHub ReSpec Markdwon v1.1 (org:Handleiding GitHub ReSpec Markdown v1.1.docx)
  6. Handleiding introductie GitHub (org:Handleiding introductie GitHub.docx)

Note Wilko heeft twee bestaande documenten samengevoegd, maar daarin zit ook overlap met het document van Linda over Logius ReSpec. Bovendien bevat het document secties waarvan het fijn is om er apart naar te kunnen verwijzen. M.a.w.: tabellen kunnen aangevuld worden, maar goed kijken welke documenten (zie ook: rij 16 en 22 in de tabel met het overzicht van beschikbare documentatie m.b.t. werkomgeving. ). Intranet luistert iets nauwer: daar misschien specifiekere verwijzingen maken.

Suggestie voor de langetermijn

Note Voorbeeld samenhang processen, data, inten/extern van aquo-standaarden

De volgende lijst bevat een aantal suggesties om documentatie (van o.a. werkwijze en -omgeving) beter en efficienter op orde te krijgen. Voor documentatie zouden we eens kunnen kijken naar DITA, een standaard uit de uitgeverswereld. Op Wikipedia wordt het als volgt uitgelegd: "Uitgangspunt van de architectuur is het verdelen van tekst in bouwstenen of 'topics' ten behoeve van hergebruik en specialisatie en het bundelen van bouwstenen via zogenaamde DITA Maps."

  • Dit zou heel aantrekkelijk kunnen zijn voor onze documentatie, zoals handleidingen en instructies, maar ook modellen.
  • Imvertor maakt nu van UML een catalogus.
  • Maar zou het niet mooier zijn om van datamodel naar database met objecten, definities en diagrammen te gaan
  • En van daaruit kun je dat (bijvoorbeeld) een catalogus genereren?
  • Informatie die op meerdere plekken terugkeert kan zo éénmalig opgeslagen en beheerd worden
  • Op dit moment is verwijzen tussen standaarden onderling lastig, een dergelijke structuur zou een oplossing kunnen zijn.,
  • NEN3610 is topmodel voor veel modellen, daar wil je naar kunnen verwijzen; m.a.w. echt mee kunnen verbinden
  • Wat is ervoor nodig?
  • Welke stappen kunnen we nu al nemen zonder onszelf in de toekomst klem te zetten?
  • Informatie in database zou applicatie-onafhankelijk moeten zijn (m.a.w. niet afhankelijk van EA of Imvertor)
  • De huidige werkwijze van het publiceren van modellen en standaarden is te veel verzuild; ieder model is een zuil.
  • Gerard W. heeft affiniteit met de uitgeverswereld en weet hierover meer.
  • Een ander deel van de workflow zou kunnen zijn om documenten via MS Word aan te leveren voor de database.
  • Maar misschien wil je aan de aanleverkant meerdere formaten kunnen toestaan.
  • Arjan Loeffen heeft hier vanuit andere invalshoek ook ideeën over: datamodel van heel NL
  • Dan moet je ook kunnen verbinden en standaardistaie ook verder doorvoeren (bijv. lay-out)

Inventarisatie inhoud documenten

Deze paragraaf geeft per document een korte analyse van de inhoud. Op basis hiervan wordt een koppeling gemaakt met de lijst met personen die op dit moment verantwoordelijk zijn voor bepaalde onderdelen binnen Geonovum. Dit wordt voorlopig alleen toegepast op wat relevant is voor de Geonovumwerkomgeving (m.u.v. HIM). Op die manier wordt duidelijk welke onderdelen afgedekt zijn en welke niet, maar ook wie er mogelijk verantwoordelijk voor is.

HIM

  • Past misschien beter bij Geonovumwerkwijze (i.p.v. ~omgeving)
  • Handreiking voor informatiemodellering
  • Voor informatieproduten uitwisselen in context DSO
  • Objectgeoriënteerd
  • Heeft update nodig
  • Hoofdstuk 2-5 zijn met name relevant
  • Zouden we naast 'bijlage offerte' (Arnoud) moeten leggen.
  • Waarom blijven liggen? Nuttig document toch!?
  • Veel DSO-taal, hoewel idee toch voor alle informatiemodellen geldt?

Geonovum Technisch register (2019)

  • Bevat Drie Documenten
  • Niet allemaal even compleet
  • Heel inhoudelijk van aard, weinig extra uitleg
  • Missschien ook prima
  • Deels in Nederlands, deels in Engels

Publiceren van het IMGeluid EAP-bestand

  • Heel nuttig!
  • Verwijst naar wijzigingsprotocol IMGeluid (ook breed nuttig)
  • Herinnert mij aan doc. Pano: versionering
  • Noemt 'beheerhandboek' (BOMOS?), is ook relevant voor modelleur. Grensgeval scope?
  • Bevat ook SVN, bestaat ook GitHub handleiding van
  • Handmatig XSD bewerken: o.a. imvertor ns verwijderen, hoorde ik ook bij BRO. Terugkoppelen naar Arjan?
  • Worden ook tools genoemd:
    • XML editor voor validatie
    • W3C Markup Validation Service

Installatie SVN

  • Actueel
  • Volledig

Importeren van een bestaand SVN-project in EA

  • Actueel
  • Volledig

Note Overzicht verder aanvullen

Note Relevante passages uit Model Driven Design documentatie VNG-realisatie. In het algemeen heel mooi dat alles netjes bij elkaar staat: begrippen, werkomgeving en werkwijze:

  • Sectie 1: EA Toolpack installeren
  • Sectie 5: Gebruik van datatypes
  • Sectie 5: Technieken en handigheidjes
  • Sectie 5: Naamgevingsconventies (het hebben hiervan!)
  • Sectie 8: Veel voorkomende fouten (het hebben hiervan!)