solid / solid/specification

Consider further detailing the classes of products for the conformance model

Open
#480 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

topic: conformance
Dominant language
HTML
Stars
563
Forks
108
Avg merge
4d 13h
Merged PRs (30d)
3

Description

Solid Protocol's #conformance model identifies servers and clients as the kinds of products ( https://solidproject.org/TR/protocol#classes-of-products ) that will implement the specification ( as originally clarified by https://github.com/solid/specification/pull/478 alongside https://github.com/solid/vocab/pull/84 ). See also https://solidproject.org/TR/notifications-protocol#classes-of-products as another spec with its own classes of products.

Servers and clients is just one generalisation. The Solid Protocol normatively requires other specifications with their own conformance classes of products.

Identifying other meaningful generalisations of the classes of products opens up a new space in that different conforming products can be implemented by different parties and codebases, modularised and used in the Solid ecosystem, exchanged in a marketplace, or searched in stores.

Another generalisation of the conformance classes in the Solid Protocol could also be the following for example:

  • server (or responding agent)
  • client (or producer or consumer)
  • producer of content
  • content
  • consumer
  • storage
  • producer of instructions
  • processor

Besides the definitions and classifications, conformance clauses need to be updated to refer to specific concepts, e.g., is it the server or the storage product that is the subject of that requirement that needs to conform?

Meaningful conformance classes of products and cross linking is expected in all Solid specifications.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Solid Protocol and Notifications Protocol “classes of products” sections, then review specification PRs #478 and vocab PR #84. Define meaningful shared conformance classes and update the affected conformance clauses and cross-links across Solid specifications; completion requires agreement on the classifications and their normative usage.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.