Toelichting maken bij toepasbare regels in het Omgevingsloket

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

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.

Voorbeeld_toelichting1 — *Voorbeeld van een korte toelichting onder een informatie-icoon (i) bij een vraag*

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.

Voorbeeld_toelichting3 — *Voorbeeld van een toelichting bij een antwoordoptie direct in beeld*

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).

Voorbeeld combinatie korte en lange toelichting met 'lees meer'-knop — *Voorbeeld van de combinatie van een korte en lange toelichting bij een vraagoptie*

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.

*Voorbeeld van een toelichting bij een conclusie in het uitklapvenster*

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 (![alt text](image.jpg))
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.