Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
396 changes: 396 additions & 0 deletions LICENSE

Large diffs are not rendered by default.

41 changes: 36 additions & 5 deletions README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ This document is available in its rendered forms here:

== Introduction

This repository contains official specifications maintained by the EXPRESS
Language Foundation (ELF). The EXPRESS Language Foundation facilitates the
This repository contains official specifications and directives maintained by the
EXPRESS Language Foundation (ELF). The EXPRESS Language Foundation facilitates the
education, standardization, research, promotion, definition, and usage of
information modelling and programming languages, with a focus on the EXPRESS
language family.
Expand All @@ -21,13 +21,22 @@ The specifications include:
5003:: *EXPRESS documentation migration* -- Specification for migrating EXPRESS documentation to the new format
5004:: *EXPRESS schema manifest* -- Specification for creating a manifest of EXPRESS schemas
5005:: *EXPRESS changes* -- Specification for documenting changes to the EXPRESS language and its specifications
5006:: *EXPRESS mapping language* -- Specification for expressing reference paths amongst a set of EXPRESS schemas

These specifications are written in Metanorma to generate standardized
The directives include:

101:: *Standardization and publication* -- Directive on the ELF standardization and publication processes
102:: *Standard document requirements* -- Directive on requirements for ELF standard documents
103:: *Patent policy* -- Directive on the ELF patent policy
104:: *Guidelines for the implementation of the patent policy* -- Directive providing guidelines for the implementation of the ELF patent policy
105:: *Intellectual property rights policy* -- Directive on the ELF intellectual property rights policy

The specifications and directives are written in Metanorma to generate standardized
documentation in multiple formats.

== Structure

`sources/`:: source files for EXPRESS specifications in Metanorma format.
`sources/`:: source files for EXPRESS specifications and ELF directives in Metanorma format.

`sources/annotated-express/`:::
Annotated EXPRESS specification
Expand All @@ -44,6 +53,24 @@ EXPRESS schema manifest specification
`sources/express-changes/`:::
EXPRESS changes specification

`sources/express-mapping/`:::
EXPRESS mapping language specification

`sources/directive-standardization/`:::
ELF Directive 101: Standardization and publication

`sources/directive-document-requirements/`:::
ELF Directive 102: Standard document requirements

`sources/directive-patent-policy/`:::
ELF Directive 103: Patent policy

`sources/directive-ipr-guidelines/`:::
ELF Directive 104: Guidelines for the implementation of the patent policy

`sources/directive-ipr-policy/`:::
ELF Directive 105: Intellectual property rights policy

== Building documentation

This repository uses Metanorma to build standardized documentation.
Expand All @@ -64,7 +91,7 @@ metanorma site generate

=== Building with Docker

If you prefer using Docker, run:
If you prefer to use Docker, run:

[source,sh]
----
Expand All @@ -83,3 +110,7 @@ The build process generates documentation in multiple formats:
== License

Copyright EXPRESS Language Foundation.

ELF documents are made available under the Creative Commons Attribution
4.0 International (CC BY 4.0) license. The full license text is available
in the LICENSE file.
5 changes: 5 additions & 0 deletions metanorma.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ metanorma:
- sources/express-schema-manifest/document.adoc
- sources/express-changes/document.adoc
- sources/express-mapping/document.adoc
- sources/directive-standardization/document.adoc
- sources/directive-document-requirements/document.adoc
- sources/directive-patent-policy/document.adoc
- sources/directive-ipr-guidelines/document.adoc
- sources/directive-ipr-policy/document.adoc

collection:
organization: "EXPRESS Language Foundation"
Expand Down
26 changes: 26 additions & 0 deletions sources/directive-document-requirements/document.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
= ELF Directive: Standard document requirements
:title-main-en: ELF Directive: Standard document requirements
:docnumber: 102
:edition: 1
:copyright-year: 2026
:revdate: 2026-08-30
:language: en
:doctype: standard
:technical-committee: TCB
:imagesdir: images
:mn-document-class: elf
:mn-output-extensions: xml,html,doc,pdf,rxl
:docidentifier: ELF 102:2026
:data-uri-image:
:local-cache-only:

include::sections/00-foreword.adoc[]
include::sections/00-intro.adoc[]

include::sections/01-scope.adoc[]
include::sections/02-normrefs.adoc[]
include::sections/03-terms.adoc[]
include::sections/04-requirements.adoc[]
include::sections/05-structure.adoc[]

include::sections/99-bibliography.adoc[]
27 changes: 27 additions & 0 deletions sources/directive-document-requirements/sections/00-foreword.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
.Foreword
The EXPRESS Language Foundation ("`ELF`") is a registered public charity in the
US that facilitates the education, standardization, research, promotion,
definition, and usage of information modelling and programming languages, with a
focus on the EXPRESS language family.

ELF works with international partners and experts across the globe, reflecting
the international nature of its mission. More information about ELF is available
on the official website (https://www.expresslang.org).

The procedures used to develop this document and those intended for its further
maintenance are described in the ELF Directives.

In particular the different approval criteria needed for the different types of
ELF documents should be noted. This document was drafted in accordance with the
editorial rules of the ELF Directives.

Attention is drawn to the possibility that some of the elements of this
document may be the subject of patent rights. ELF shall not be held responsible
for identifying any or all such patent rights. Details of any patent rights
identified during the development of the document will be provided in the
Introduction.

Any trade name used in this document is information given for the convenience of
users and does not constitute an endorsement.

This document was prepared by the Technical Coordination Board (TCB).
16 changes: 16 additions & 0 deletions sources/directive-document-requirements/sections/00-intro.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
== Introduction

ELF is committed to expanding the realm of standards for information
modelling and programming languages, with a focus on the EXPRESS
language family and interoperability across the globe and communities
of practice.

To facilitate its mission, the ELF Board of Directors has decided
to align standardization and publication processes with international
best practices, such as the ISO standardization process
(<<ISODIR1>>, <<ISODIR1C>>, <<ISODIR2>>)
and the <<WTOTBT>>.

This document aims to achieve the said intention.

The document describes requirements for ELF standard documents.
27 changes: 27 additions & 0 deletions sources/directive-document-requirements/sections/01-scope.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
== Scope

This document provides requirements on document structure of the following types of ELF publication:

* Directive

* Standard

* Guide

* Specification

* Amendment

* Technical corrigendum

* Report

These publication types are described in <<DIR101>>.

This document does not apply to the following types of documents
produced by ELF, although processes described in this document
can be optionally used as guidance:

* policy statements;
* internal administrative documents; and
* how-to guides.
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
[bibliography]
== Normative References

* [[[DIR101,ELF 101:2026]]], _ELF Directive: Standardization and publication_
111 changes: 111 additions & 0 deletions sources/directive-document-requirements/sections/03-terms.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
[source="ISODIR1,ISODIR1C,ISODIR2,DIR101"]

[[terms]]
== Terms, definitions and abbreviations

=== Terms and definitions

[[term-std-work-item]]
==== standardization work item

publishable work item that creates output that relates
to standardization


[[term-std-project]]
==== standardization project

organized process with one or more
_standardization work items_ (<<term-std-work-item>>) that
contributes towards a defined scope of work


[[term-project-owner]]
==== project owner

entity with authority in charge of a _standardization project_
(<<term-std-project>>)

[[term-document]]
==== document

written output of a _standardization work item_ (<<term-std-work-item>>)

[[term-cc-deliverable]]
==== ELF deliverable

_document_ (<<term-document>>) that could be an ELF Standard,
Guide, Specification, Report

[[term-iso-deliverable]]
==== ISO TC deliverable

_document_ (<<term-document>>) of an ISO TC as described in <<ISODIR1>>

NOTE: According to <<ISODIR1>>, ISO TC deliverables include the following types: International Standards, Technical Specifications, Publicly Available Specifications and Technical Reports.

[[term-cc-tc]]
==== ELF technical committee
alt:[ELF TC]

internal committee of ELF tasked with a scope of work it
is responsible for

[[term-document-stage]]
==== document stage

stage of _document_ (<<term-document>>) as specified in the ELF stages (as defined in <<DIR101>>)

[[term-std-project-output]]
==== standardization project output

output of a _standardization project_ (<<term-std-project>>)

NOTE: In this document, this explicitly means any documents and IP rights
produced by the standardization project.

[[term-sdo]]
==== standardization body
alt:[standards-developing organization]
alt:[SDO]

entity that publishes _standardization work items_ (<<term-std-work-item>>)


[[term-std-proposal]]
==== proposal for standardization

proposal for a new _work item_ (<<term-std-work-item>>) for standardization

[[term-co-develop]]
==== co-develop
alt:[collaborative development]

act of developing a _standardization work item_ (<<term-std-work-item>>) by multiple parties from the proposal
_document stage_ (<<term-document-stage>>)

[[term-co-publish]]
==== co-publish
alt:[collaborative publishing]

act of publishing _documents_ (<<term-document>>) of identical content
by multiple parties

==== joint work item

_standardization work item_ (<<term-std-work-item>>) _co-developed_ (<<term-co-develop>>) by both parties


==== joint publication

publication that is _co-published_ (<<term-co-publish>>) by ELF with
an external _standardization body_ (<<term-sdo>>)

NOTE: Both parties may jointly hold copyright of the joint publication.


=== Abbreviations

IPR:: Intellectual Property Rights

TCB:: Technical Coordination Board
Loading
Loading