International-Data-Spaces-Association / ids-specification

The Dataspace Protocol is a set of specifications designed to facilitate interoperable data sharing between entities governed by usage control and based on Web technologies. These specifications define the schemas and protocols required for entities to publish data, negotiate Agreements, and access data in a data space
https://docs.internationaldataspaces.org/dataspace-protocol/
Apache License 2.0
34 stars 16 forks source link

Improving findability of files #28

Closed ssteinbuss closed 1 year ago

ssteinbuss commented 1 year ago

The json files are not rendered by GitBook, Some overview would be good to discover all releated files

juliapampus commented 1 year ago

I think the list of files is not rendered as you @ssteinbuss thought it would be. Selecting the files in the menu on the left-hand side opens up empty pages.

However, the summary.md is rendered correctly and links to repository files: https://docs.internationaldataspaces.org/communication-guide-v2-draft/list-of-files/summary. I would propose to insert the list of files into a list_of_files.md and link this in summary.md. Nevertheless, this will prevent users without any reading permissions to take a look at the documents.

ssteinbuss commented 1 year ago

Will update this