MinBZK / regels.overheid.nl

This monorepo stores all code and assets of all projects with which we develop regels.overheid.nl
https://regels.overheid.nl/roadmap
European Union Public License 1.2
19 stars 6 forks source link

Make DCAT application profile suitable for metadata ALEF specifications #129

Closed sgort closed 1 month ago

sgort commented 1 year ago

Consider this example with ALEF described conclusively. What metadata do I need to upload these specifications into a rule library and make them findable there?

Example:

Consider this DCAT-AP-RONL (concept) profile as a standard specification of the aforementioned metadata.

hayoschreijer commented 1 year ago

Hello,

One thing that might be missing is the link with the analysis of the specific legislation to "annotations" which led to the product and rule-set.

I asked Mariette Lokin for a "wetsanalyse" flow description to describe metadata for the complete flow. Then we can determine if we want to, and how, include the analysis in here.

Met vriendelijke groeten,

Hayo Schreijer managing director Dexes T: 06-4637 4892 E: @.***

Op ma 16 jan. 2023 om 09:16 schreef Datafluisteraar < @.***>:

Consider this example with ALEF described conclusively. What metadata do I need to upload these specifications into a rule library https://regels.dexcat.nl/ and make them findable there?

Example:

Consider this DCAT-AP-RONL (concept) https://minbzk.github.io/dcat-ap-ronl/ profile as a standard specification of the aforementioned metadata.

— Reply to this email directly, view it on GitHub https://github.com/MinBZK/regels.overheid.nl/issues/129, or unsubscribe https://github.com/notifications/unsubscribe-auth/AOLQPMUTBVMUNPTDEXYIOO3WST7WJANCNFSM6AAAAAAT4OC7NU . You are receiving this because you are subscribed to this thread.Message ID: @.***>

hayoschreijer commented 1 year ago

Looking at the "flow" of Legitimaat (see here: https://minbzk.github.io/LegitiMaat/):

Picture: https://minbzk.github.io/LegitiMaat/media/processen-wetsuitvoering.png

The flow implies that the model 1) metadatamodel for Rules (DCAT-RONL) sets "regels" as centrtal object to describe.

2) mandatory fields for the left side of the flow are relations to "wetgeving", but there can be 3 additional relations:

3) there are no mandatory fields for the DONL-RONL on the right part of the flow, but the following are possible: -- Functional design - a pre phase before code/algoritms are created. Are normally not published, but can be available in Github repositories -- Code / Algoritms -

In the flow, on the right bottom, there is the eventual impact of government actions based on rules. Either from the "uitleg aan en interactie met de burger" and/or in the "besluit en brief aan de burger" there will be a link to the ruleset description in a DONL-RONL register like regels.overheid.nl. This could also be a QR-code on the letter that a citizen receives from the government.

For the DONL-RONL it is important to determine: what is stored/described as part of the "rule set" and what can be linked to. It follows that all objects on the left side of rules in the flow need to be linked to. All objects on the right side can be part of the ruleset description on DON-RONL.

Conclusion:

NOTE: DCAT-RONL never publishes the actual parameters of rules or algorithms. No gamification is possible; it is always a further explanation of the interpretations of the legislation and policies.

diederikd commented 1 year ago

I assume DCAT-RONL will publish the actual parameters of rules or algorithms if the source of those parameters are legislation and policies like in the example of the IIT? (https://open-regels.nl/Parameters/parameterset%202021_Parameterset.html)

diederikd commented 1 year ago

Isn't it usefull to use similar metadata which is used for the legislation? Like: image

sgort commented 1 year ago

I assume DCAT-RONL will publish the actual parameters of rules or algorithms if the source of those parameters are legislation and policies like in the example of the IIT? (https://open-regels.nl/Parameters/parameterset%202021_Parameterset.html)

DCAT-AP-RONL describes the metadata with which these parameters can be published and to make them retrievable for (re)use. Zie example parameters van de regelgroep as a distribution here https://regels.dexcat.nl/dataset/regelgroep-uit-te-keren-individuele-inkomenstoeslag

sgort commented 1 year ago

Approach DCAT-AP-RONL(1)

diederikd commented 1 year ago

I guess if rules are the central object, I would expect that above or below these rules one might find the relations to the used and derived data elements, including relations to the nederlandse taxonomie

sgort commented 1 year ago

I guess if rules are the central object, I would expect that above or below these rules one might find the relations to the used and derived data elements, including relations to the nederlandse taxonomie

image

diederikd commented 1 year ago

Thanks! fixed.