opengeospatial / templates

OGC document templates in AsciiDoc
Apache License 2.0
11 stars 20 forks source link

Requirements editing needs to be simplified for editors #45

Open ogcscotts opened 3 months ago

ogcscotts commented 3 months ago

The structure for authoring Requirements (and thus Conformance statements and classes for both) is complicated for editors. The DocTeam is requesting proposals for a more simple means to edit this information.

Please suggest the most intuitive way for editors to create this information.

Two end results are likely:

  1. Metanorma is updated to reflect the new content model; or
  2. A parsing tool must be developed to extract the Requirements information and create the Metanorma files.
ghobona commented 1 month ago

Discussed 2024-09-09

@opoudjis is going to create a ticket, in the metanorma-ogc repo, outlining a proposed workflow.

@ogcscotts will invite OGC Members to provide feedback during the 130th OGC Member Meeting.

opoudjis commented 1 month ago

Proposal is in https://github.com/metanorma/metanorma-ogc/issues/716

It is conditional on the implementation of https://github.com/metanorma/modspec-ruby/issues/2, the integration of YAML into Metanorma via an object model (although the workaround via Liquid that we have already published will still work.)