policy-instantiation-spec

ODRL Policy Instantiation specification

This is the Bikeshed specification repository for the ODRL Policy Instantiation.

This specification document has the aim to provide a starting point to standardize the instantiation of an ODRL Agreement based on a set of ODRL Policies, an ODRL Request and a knowledge graph of the state of the world (SotW) modeled as RDF.

The envisioned application is the automated generation of agreements by policy engines, targeting the generation of technical contracts as the basis for Web-based data exchanges that include verifiable signatures from both parties in the agreement.

Contributing

Install Bikeshed

You can either install Bikeshed locally or use a Docker image. You build a Docker image locally by executing the following steps:

  1. Clone the Bikeshed repository via

    git clone https://github.com/speced/bikeshed
    
  2. In the repository, build a Docker image via

    docker build --tag=bikeshed:latest .
    

Edit spec

You edit spec by updating the file spec.bs.

Build

If you installed Bikeshed locally, execute build.sh. If you use Docker, execute build.docker.sh. You find the result in the folder dist.

You have to commit and push the dist folder and its content to your git repo.

If you want Bikeshed to watch for changes, execute either watch.sh or watch.docker.sh. Every time you save spec.bs a new build is automatically triggered.

Bikeshed uses a default copyright and license. Please make sure that it fits your requirements.