Skip to content
Open
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
4 changes: 2 additions & 2 deletions _pages/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ In case of trouble joining, please contact [Carsten Bormann](mailto:cabo@tzi.org

[ASDF][] is the IETF working group that is governing the work on SDF.

Progress and specifications can be found at [IETF SDF][].
The SDF base specification can be found at [IETF SDF][].

[SDF language][] is the GitHub repository for the specification of the SDF syntax.

Expand All @@ -58,7 +58,7 @@ Progress and specifications can be found at [IETF SDF][].
-->

[SDF language]: https://github.com/ietf-wg-asdf/SDF
[IETF SDF]: https://datatracker.ietf.org/doc/draft-ietf-asdf-sdf/
[IETF SDF]: https://www.rfc-editor.org/rfc/rfc9880
[ASDF]: https://datatracker.ietf.org/wg/asdf/about/

[2020 Spring conference]: https://github.com/one-data-model/Conference2020
Expand Down
2 changes: 1 addition & 1 deletion _pages/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ one data model<sup>TM</sup>


[SDF language]: https://github.com/ietf-wg-asdf/SDF
[IETF SDF]: https://datatracker.ietf.org/doc/draft-ietf-asdf-sdf/
[IETF SDF]: https://www.rfc-editor.org/rfc/rfc9880
[ASDF]: https://datatracker.ietf.org/wg/asdf/about/


Expand Down
6 changes: 3 additions & 3 deletions _pages/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,10 +85,10 @@ To achieve that goal the first step to take is to have a common way how to write
Since all participating organizations are currently doing this
in their own ways, it makes sense to develop a single way to describe models.
Hence, the Semantic Definition Format (SDF) is created.
The syntax and semantics of the SDF format are described in the [SDF][] repository.
The syntax and semantics of the base SDF format are described in the [IETF SDF][] RFC.
The easy readable version [SDF language][].

To track the updates in the IETF version see the [IETF draft of SDF](https://www.ietf.org/id/draft-onedm-t2trg-sdf-00.html).
To track the updates in the IETF specifications that depend on the base SDF specification, see the [ASDF][] working group.

SDF is representing the models in JSON.
Using JSON as a representation language has a few advantages:
Expand Down Expand Up @@ -154,7 +154,7 @@ Next steps for OneDM (conducted in parallel):
[unit_test]: https://github.com/one-data-model/unit_test

[SDF language]: https://github.com/ietf-wg-asdf/SDF
[IETF SDF]: https://datatracker.ietf.org/doc/draft-ietf-asdf-sdf/
[IETF SDF]: https://www.rfc-editor.org/rfc/rfc9880
[ASDF]: https://datatracker.ietf.org/wg/asdf/about/
[IETF editors version of SDF]: https://github.com/ietf-wg-asdf/SDF

Expand Down
8 changes: 5 additions & 3 deletions _pages/sdflanguage.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,10 @@ toc_sticky : true
---
## Introduction

Semantic Definition Format (SDF) is a new description format to describe abstract data models.
Semantic Definition Format (SDF) is a description format to describe abstract data models.
SDF conveys abstract meta-model for IoT device affordances, behavior, and context,
decoupled from communication details. SDF provides:

- Common categories for affordances
- Common categories for constraints
- Common format for definitions
Expand Down Expand Up @@ -48,7 +49,8 @@ Using JSON as a representation language has a few advantages:
so tooling to work with SDF models can be created efficiently.

The syntax and semantics of SDF are described in the SDF specification.
After the initial development at the OneDM group, the SDF standardization continues now in the [IETF ASDF Working Group][ASDF]. Information about the latest published draft of SDF is available in the [IETF Data Tracker][IETF SDF]. The latest editor draft is available in the [SDF language] repository.
The Base SDF specification has been published as an [IETF RFC].
Further work on SDF-based standardization continues in the [IETF ASDF Working Group][ASDF].
The [terminology][] page relates the SDF terms against terms used in other SDOs.

## Verification of SDF
Expand All @@ -73,7 +75,7 @@ repositories tolerate (or deliberately contain) deviations.
[unit_test]: https://github.com/one-data-model/unit_test

[SDF language]: https://github.com/ietf-wg-asdf/SDF
[IETF SDF]: https://datatracker.ietf.org/doc/draft-ietf-asdf-sdf/
[IETF RFC]: https://www.rfc-editor.org/rfc/rfc9880
[ASDF]: https://datatracker.ietf.org/wg/asdf/about/
[RFC8610]: https://tools.ietf.org/html/rfc8610

Expand Down