common-workflow-language / common-workflow-language/schema_salad

There are no descriptions of how to behave in the case of `"_id": "@type"`

Open
#498 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
86
Forks
64
Avg merge
19h 24m
Merged PRs (30d)
19

Description

The [schema of CWL](https://github.com/common-workflow-language/cwl-v1.2/blob/c0c31c54412619d106e100bfe70a49831a673004/Process.yml#L901) uses the following `jsonldPredicate` but there are no descriptions how `"_id": "@type"` field must be used for preprocessing.

```yaml
jsonldPredicate:
"_id": "@type"
"_type": "@vocab"
```

It would be nice if it is clarified in the spec.

Contributor guide

Open the contributing guide

Research direction

Start with the referenced CWL Process.yml section around line 901 and inspect how the jsonldPredicate fields are described and processed. Clarify the preprocessing behavior for an "_id": "@type" entry in the specification, including a concrete explanation of the expected result, then verify that the wording is consistent with the existing schema documentation.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.