Skip to content

Three documentation additions from the MAC FDT build#1

Open
easchultes wants to merge 4 commits into
knowledgepixels:mainfrom
easchultes:skill-additions-from-mac-fdt-build
Open

Three documentation additions from the MAC FDT build#1
easchultes wants to merge 4 commits into
knowledgepixels:mainfrom
easchultes:skill-additions-from-mac-fdt-build

Conversation

@easchultes
Copy link
Copy Markdown

nanopub-skill: three documentation additions from the MAC FDT build
Following the live-NSN FAIR Digital Twin demonstration on incubator project4, three topics surfaced where SKILL.md does not yet preempt the relevant error modes:

Activating views — gen:ViewDisplay and the requirement to point gen:isDisplayOfView at a wrapper referent URI rather than a bare grlc-query.
npx:retracts vs npx:invalidates — the publisher-facing predicate vs the admin-layer derivation, and the corresponding SPARQL-filter convention.
gen:hasAdmin (Space) vs gen:hasOwner (NanodashProject) — coexistence and comparison of the two ownership models.

A fourth gap from our build (self-materialization on FDOs) is left out at maintainer suggestion to avoid spreading a debatable conceptual pattern; that material is carried instead in the MAC FDT paper and Implementation Guide.
Each addition is sized to slot into an existing SKILL.md section with the suggested insertion point noted in the diff.

Added details on activating a view display on a Space and its implications.
Clarify the distinction between npx:retracts and npx:invalidates, including usage in SPARQL filters.
Clarify the distinction between `npx:retracts` and `npx:invalidates` with improved formatting.
Add comparison of current Space model and older NanodashProject model with details on their differences.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant