...
| Waarom is deze RFC nodig? | Vaste URL's beschikbaar maken voor zowel de verplichte als de gepubliceerde versie van het afsprakenstelsel. |
|---|---|
| Oplossingsrichting | Introductie van Confluence plug-in waarmee revisie en publicatie beheer, door het ontwikkelteam, gemanaged wordt. |
| RACI |
|
| Aanpassing van | Interne procedure van het MedMij stelseldocumentatie revisie en publicatie proces. |
| Impact op rollen | N.V.T. |
| Impact op beheer | Vaste locatie (URL) voor verplichte en optionele MedMij stelseldocumentatie. |
| Impact op RnA | N.V.T. |
| Impact op Acceptatie | Vaste locatie (URL) voor verplichte en optionele MedMij stelseldocumentatie |
| PIA noodzakelijk | N.V.T. |
| Gerelateerd aan (Andere RFCs, PIM issues) | https://pimvzvz.vzvzatlassian.nlnet/browse/AF-1378 |
| Implementatietermijn | Standaard release interval, vanaf versie 1.6 beschikbaar |
| Motivatie verkorte RFC procedure (patch) | N.V.T. |
...
De drie confluence spaces:
- MMontwikkelingMMOntwikkeling, dit is de revisie beheerde ontwikkel omgeving. In deze omgeving kan altijd terug gekeken worden (en opnieuw gepubliceerd worden) naar voorgaande versies. De ontwikkelomgeving is niet publiek.
- MMverplichtMMVerplicht, dit is de huidige verplichte versie van het MedMij afsprakenstelsel. De MMverplicht MMVerplicht is publiek.
- MMoptioneelMMOptioneel, dit is de huidige optionele versie van het MedMij afsprakenstelsel. De MMoptioneel MMOptioneel is publiek.
Het niet meer opnemen van het versie nummer in de confluence-space naam betekend dat het versie nummer als tekst gepubliceerd wordt in het afspraken stelsel. En het versie nummer wordt in de space navigatie-zijbalk geplaatst.
Het actualiseren van dit nummer is onderdeel van het updaten van de publicatie revisie versie in de MMontwikkelomgevingontwikkelversie in MMontwikkeling.
Bij een volgende release van het afsprakenstelsel wordt opnieuw vanuit de MMontwikkeling gepubliceerd naar MMverplicht en MMoptioneel om invulling te geven aan het dakpan release model.
Drawio border true diagramName MM-Ontwikkeling-Versiebeheer simpleViewer false width links auto tbstyle top lbox true diagramWidth 1001 revision 1
Wanneer de basis pagina-anker structuur niet verandert blijven de aangemaakte links naar MMverplicht -pagina-anker intact bij een update naar de 'nieuwe' MMverplicht en Optioneel versie.
...
- Versie 1.5.1-verplicht wordt als baseline versie onder revisiebeheer geplaatst in MMontwikkeling als versie 1.5.1 verplicht
- In MMontwikkeling wordt versie 1.6.0 als ontwikkelversie aangemaakt.
- De RFC's voor versie 1.6.0 worden in de 1.6.0 MMontwikkelversie verwerkt.
- Verwerken van de 1.5.0 en 1.5.1 erratalijst in MMontwikkeling 1.5.1
In de release fase:
- Versie 1.4.0 De huidige versie (1.4.1) blijft zoals deze is en wordt gearchiveerd rond 30 april.Rond 30 april publiceren we de nieuwe als PDF gearchiveerd (volgens huidige proces).
- Publiceren nieuwe versie, de verplichte 1.5.1 versie door een release publicatie (kopie) te maken van MMOntwikkeling 1.5.1 naar MMverplicht en deze noemen we MMverplicht (publieke URL).Rond 30 april publiceren we de nieuwe optionele .
In de space navigatie-zijbalk wordt het versienummer toegevoegd.
Voorbeeld versienummer in space navigatie-zijbalk.
- Publiceren nieuwe optionele (1.6.0) versie door een release publicatie (kopie) te maken van MMOntwikkeling 1.6.0 naar MMoptioneel en deze noemen we MMoptioneel (publieke URL).
In de space navigatie-zijbalk wordt het versienummer toegevoegd.
In de ontwikkelfase:
- Doorontwikkeling van de volgende versie wordt uitgevoerd op MMontwikkeling. Dit kan zowel de nieuwe optionele versie zijn of een patch op de bestaande verplichte versie.
- Patches worden doorgevoerd op MMOptioneel en/of MMVerplicht, maar alleen nadat van deze space een (archief) kopie is gemaakt met het op dat moment geldende versienummer.
...
Resulterend in twee stelsel publicaties op elk een vast URL basis-adres:
- https://afsprakenstelselvzvz.medmijatlassian.nlnet/wiki/display/MMVerplicht
- https://afsprakenstelselvzvz.medmijatlassian.nlnet/wiki/display/MMOptioneel
Dit geeft een stabiele* basis om vanuit externe locaties naar de stelselpublicatie te linken.
* Bij grote updates waarbij pagina-anker structuur aangepast wordt kan dit alsnog resulteren in een 'broken URL link'.
...
| Dreiging | Kans | Impact | DreigingsID (intern) | Maatregelen |
|---|---|---|---|---|
Bijlagen
| Attachments | preview | false|
|---|---|---|
|
Goedkeuring
| Beoordelaar | Datum | Toelichting | Beoordelaar | Datum | Toelichting |
|---|---|---|---|---|---|
| Productmanager Stichting MedMij | Productmanager Beheerorganisatie | ||||
| Leadarchitect Stichting MedMij | Leadarchitect Beheerorganisatie | ||||
| Ontwerpteam | |||||
| Deelnemersraad | Eigenaarsraad |
...