Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Simplify text following req.module changes #337

Open
jerstlouis opened this issue Mar 14, 2024 · 0 comments
Open

Simplify text following req.module changes #337

jerstlouis opened this issue Mar 14, 2024 · 0 comments
Labels
main issue Part 2 Issues to be resolved prior to TC vote

Comments

@jerstlouis
Copy link
Member

Potentially revert and simplify some generic language and requirements which was an attempt at making re-usable requirement modules (e.g., #270) that can be directly and literally included (as in ASCIIDoc include) in different standards, for different resource types.
This is confusing for implementers, as it tends to mkake the text longer than necessary and less clear / straightforward, and in common cases where the same parameters (for example) are used in different resource contexts, it results in conflicts caused by the same ASCIIDoc content being included multiple times.
Instead, the language describing the re-usable building blocks should be adapted to the resource context where they are used.
We already made similar reverts in Maps and Coverages, opting to directly adapt the requirements to the resources they apply to (even though we maintain the concept of building blocks / requirement module).
An example of this the split of 9.1 Parameter Requirements vs. 9.2 Target Resource Requirements, instead of organizing together the parameter requirement with what it does to the resource (in this case, we're always just talking about /collections).

@jerstlouis jerstlouis added Part 2 Issues to be resolved prior to TC vote main issue labels Mar 14, 2024
jerstlouis added a commit that referenced this issue Apr 18, 2024
- API modules are now directly embedded/adapted to the description/requirements where they are used
- Moved "building blocks" such as the subset requirement module and what seems like a copy of Features - Part 2: CRS to bblocks/ directory
jerstlouis added a commit that referenced this issue May 2, 2024
- Also added files for new requirement classes
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
main issue Part 2 Issues to be resolved prior to TC vote
Projects
Development

No branches or pull requests

1 participant