Als overheid kunt u extra uitleg geven bij uw toepasbare regels in het Omgevingsloket van het Digitaal Stelsel Omgevingswet (DSO). Dit kan bij de Vergunningcheck, het onderdeel Aanvragen en bij Maatregelen op maat. U hebt een aantal opties voor het maken van een toelichting.
Op deze pagina
- Een toelichting in het Omgevingsloket
- Toelichtingen maken en aanleveren
- Toelichting opmaken
- Om rekening mee te houden
- Toelichtingen in het Omgevingsloket die u niet kunt aanpassen
Een toelichting in het Omgevingsloket
In het Omgevingsloket zien initiatiefnemers bij sommige vragen een toelichting. Deze extra informatie staat in een grijs tekstblok. Deze informatie is soms nodig om extra uitleg te geven, bijvoorbeeld moeilijke begrippen uit te leggen. Of om te verwijzen naar een andere website om informatie te vinden die nodig is voor het beantwoorden van een vraag.
Als overheid kunt u zelf toelichtingen maken bij uw toepasbare regels. Dit kan binnen de Vergunningcheck, het onderdeel Aanvragen en Maatregelen op maat. Een toelichting kunt u toevoegen aan een vraag, antwoordoptie, bijlage of conclusie.
Toelichtingen maken en aanleveren
Toelichtingen zijn onderdeel van de toepasbare regels die u maakt. U maakt de toelichtingen samen met de vragen in uw regelbeheersoftware. Vanuit de software kunt u de toepasbare regels aanleveren bij het Omgevingsloket. Het gebruik van toelichtingen is beschreven in de Standaard toepasbare regels (STTR).
Gebruik bij het maken van toelichtingen de tips in de vodcast toepasbare regels: toelichtingen (deel 1) en de tips in de Schrijfwijzer Digitaal Stelsel Omgevingswet (DSO).
Een toelichting maken bij vragen, antwoordopties en bijlagen
Toelichting onder informatie-icoon (i)
Een toelichting bij vragen en antwoordopties plaatst het Omgevingsloket standaard onder het informatie-icoon (i). De standaardinstelling is dat initiatiefnemers een toelichting zelf openen en sluiten.
Toelichting direct in beeld tonen
Bij vragen en antwoordopties kunt u ook aangeven dat de toelichting altijd direct in beeld wordt getoond. Dit doet u door de toelichting in de regelbeheersoftware het kenmerk 'belangrijk' te geven. De initiatiefnemer kan de toelichting dan niet sluiten.
Gebruik deze optie alleen als het echt nodig is. Veel toelichtingen die direct in beeld staan, worden minder vaak gelezen. Bij bijlagen in het onderdeel Aanvragen verschijnt de toelichting standaard direct in beeld. Dit kunt u niet anders instellen.
Korte en/of lange toelichting
U kunt een korte toelichting, lange toelichting of combinatie gebruiken:
- Korte toelichting: deze toelichting bestaat uit maximaal 2.048 tekens.
- Lange toelichting: deze toelichting heeft geen maximaal aantal tekens.
- Combinatie korte en lange toelichting: als u een korte en lange toelichting combineert, verschijnt de korte toelichting eerst. De lange toelichting is te lezen via de 'Lees meer'-knop. Ook hier kunt u instellen dat de korte toelichting direct zichtbaar is.
Probeer toelichtingen zo kort en duidelijk mogelijk te houden. Wilt u meer achtergrondinformatie geven? Gebruik dan een combinatie van de korte en lange toelichting (met de 'Lees meer'-knop).
Afbeeldingen en video's in toelichtingen
U kunt een vraag, antwoordoptie of bijlage ook verduidelijken met een afbeelding of video. De bron van een afbeelding of video moet betrouwbaar zijn. Meer hierover vindt u op de pagina Afbeeldingen en video’s gebruiken bij toepasbare regels.
Toelichtingen maken bij de conclusie Vergunningcheck
Toelichting bij conclusie in het uitklapvenster
Bij uw conclusies voor de Vergunningcheck kunt u in de meeste gevallen ook een eigen toelichting geven. Denk bijvoorbeeld aan een verwijzing naar informatie over algemene regels op uw eigen website.
Deze toelichting zien initiatiefnemers per activiteit in een uitklapvenster. Deze toelichtingen zijn maximaal 2.048 tekens. U kunt een hyperlink toevoegen aan de toelichting, maar geen (media)bestand. Voor de conclusie 'Niet van toepassing' kunt u geen toelichting maken.
Specifieke toelichting bij conclusie
U kunt bij uw conclusies ook een specifieke toelichting maken. De toelichting is dan afhankelijk van de vragen die initiatiefnemers beantwoorden. Leidt een vraag over een monumentale boom bijvoorbeeld tot de conclusie vergunningplicht? Dan kunt u een specifieke toelichting maken voor de conclusie, bijvoorbeeld dat initiatiefnemers bij een monumentale boom eerst contact opnemen met uw organisatie.
Meer over conclusies gebruiken leest u op de pagina Conclusies gebruiken bij toepasbare regels voor de Vergunningcheck.
Geen toelichting bij een aansluitpunt
Als u uw toepasbare regels toevoegt aan een aansluitpunt, kunt u geen toelichting toevoegen voor de conclusie. De toelichting van het bovenliggende bestuursorgaan wordt bij de conclusie getoond. Wilt u toch een lokale toelichting tonen, dan kunt u een vaste waarde onder voorbehoud toepassen.
Meer hierover vindt u op de pagina Toepasbare regels voor maatwerkregels toevoegen met een aansluitpunt.
Toelichting opmaken
Toelichting opmaken met Markdown
De tekst van een toelichting kunt u opmaken. U kunt een tekst bijvoorbeeld dikgedrukt of schuingedrukt maken. Dit doet u binnen uw regelbeheersoftware met de opmaaktaal Markdown. Deze eenvoudige opmaaktaal werkt op basis van platte tekst.
DSO ondersteunt niet alle Markdown-opmaak
Het DSO ondersteunt niet alle opmaakmogelijkheden van Markdown. De toelichtingen moeten op verschillende plaatsen goed en toegankelijk worden weergegeven. Zoals in het Omgevingsloket, maar ook in de andere onderdelen van het DSO en in pdf-documenten. Een eenvoudige opmaak voorkomt technische problemen en zorgt ervoor dat het Omgevingsloket een goede en toegankelijke opmaak kan garanderen.
Validatie op toegestane Markdown
Bij het aanleveren van toepasbare regels valideert het DSO op de toegestane Markdown. Het DSO accepteert alleen toepasbare regels met toelichtingen die voldoen aan de geaccepteerde opmaak.
Geaccepteerde opmaak
U kunt gebruikmaken van de volgende Markdown-opmaak:
- cursief (*italicized text*)
- genummerde lijst (1. item)
- lijst met opsommingstekens (- item)
- links ([title](https://www.example.com))
- harde enter (HardlineBreak)
- koptekst in toelichtingen (##### H5)
- vetgedrukt (**bold text**) Let op: gebruik bij een koptekst in een toelichting koptekst H5 (zie vorige bullet).
Toelichtingen bij vragen, antwoordopties en bijlagen kunnen ook afbeeldingen of video bevatten:
- afbeeldingen ()
- video (@[<videoplatform>](id))
Meer over het gebruik van afbeeldingen en video's leest u op de pagina Afbeeldingen en video's gebruiken bij toepasbare regels.
Niet-geaccepteerde opmaak
De volgende Markdown-opmaak accepteert het DSO niet:
- kopteksten H1 t/m H4 en H6 (# H1 / == / --).
- quote (> blockquote)
- code (`code`)
- horizontale lijn (*** / --- / ___)
- 'Fenced Code Block' (```{ }```)
- Thematic break
- IndentedCodeBlock
- HTMLInline (Tekst met <b>html</b>)
- HtmlBlock
Andere opmaak waar DSO niet op controleert
Het advies is om alleen geaccepteerde Markdown-opmaak te gebruiken. Maar u kunt in toelichtingen ook opmaak gebruiken die geen onderdeel is van de basis van Markdown. Het DSO controleert niet op deze opmaak. Gebruikt u deze andere opmaak? Dan zien initiatiefnemers deze opmaak in het Omgevingsloket.
Het is niet zeker dat het DSO in de toekomst nooit op deze opmaak zal controleren. Daarom is het advies om de onderstaande opmaak niet te gebruiken:
- tabel (| Syntax | Description |)
- 'Fenced Code Block' (```{ }```)
- voetnoot ([^1])
- koptekst ID ({#custom-id})
- afvink lijst (- [ ])
- emoji (:joy:)
- highlight (==very important words==)
- definitie lijst (term: definition)
- doorhalen (~~The world is flat.~~)
- subscript (H~2~O)
- superscript (X^2^)
Om rekening mee te houden
- Gebruik een hyperlink die niet verandert. Zo zorgt u ervoor dat initiatiefnemers geen foutmelding krijgen.
- Omschrijf in de link naar welke pagina een initiatiefnemer gaat. Dus niet 'klik hier voor meer informatie', maar bijvoorbeeld 'Meer informatie vindt u op de website van het Informatiepunt Leefomgeving'.
- Besef dat mensen lange teksten niet goed lezen. Houd dus de toelichting kort, bondig en duidelijk. Gebruik hiervoor ook de schrijfwijzer.
- Gebruik bij afbeeldingen en video's betrouwbare bronnen.
Toelichtingen in het Omgevingsloket die u niet kunt aanpassen
In het Omgevingsloket staan ook standaard toelichtingen die u niet zelf kunt aanpassen met toepasbare regels. Bijvoorbeeld bij het resultaat van de Vergunningcheck. Hier verschijnt bijvoorbeeld een standaard toelichting als een organisatie geen toepasbare regels heeft toegevoegd. En ook bij toelichtingen voor conclusies is een deel van de toelichting meestal een standaard tekst.
Alles over de standaardteksten bij conclusies in de Vergunningcheck leest u op de pagina Conclusies gebruiken bij toepasbare regels voor de Vergunningcheck.
