Skip to content

Move and revise terminology section - #57

Open
maximiliani wants to merge 7 commits into
fairdo-org:devfrom
maximiliani:dev
Open

Move and revise terminology section#57
maximiliani wants to merge 7 commits into
fairdo-org:devfrom
maximiliani:dev

Conversation

@maximiliani

Copy link
Copy Markdown
Contributor

This PR closes #50 and does the following:

  • Terminology section was moved into the appendix
  • Terminology definitions related to concepts already defined in the Building Blocks were removed
  • Some definition conflicts were resolved
  • Editorial fixes of typos and grammar errors
  • ReSpec was configured to support dark mode

Please check if I deleted too many terminology definitions.

@maximiliani
maximiliani requested a review from jboehm1911 July 29, 2026 16:45
@maximiliani maximiliani added the documentation Improvements or additions to documentation label Jul 29, 2026
@maximiliani maximiliani linked an issue Jul 29, 2026 that may be closed by this pull request
@github-actions

Copy link
Copy Markdown

🚀 PR Preview Available

A preview deployment of this PR is now available.

🔗 Preview URL: https://fairdo-org.github.io/fdo-architecture-spec/preview/pr-57/

⚠️ This preview is automatically updated with each commit. The banner on the preview page will show when the PR is merged or closed.

</dd>

<dt><h4 class="rule-heading" id="rule-r1_3">[R1-3] <dfn>Global <a>PID</a> Resolution</dfn></h4></dt>
<dt><h4 class="rule-heading" id="rule-r1_3">[R1-3] <dfn data-lt="pid resolution">Global <a>PID</a> Resolution</dfn></h4></dt>

@jboehm1911 jboehm1911 Jul 30, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use capital letters for pid.
Also add resolution as data-lt.

It defines a set of <a>attribute definitions</a> that MUST be contained in any <a>FDO Record</a>
instantiating the profile, according to the cardinalities specified in the <a>attribute definitions</a> (see <a
href="#rule-r5_7">[R5-7]</a>).
instantiating the profile, according to the cardinalities specified in the <a>attribute definitions</a> (see <a href="#rule-r5_7"></a>).

@jboehm1911 jboehm1911 Jul 30, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use <a>profile</a>.
Use <a>cardinalities</a> and add a dfn for cardinality.

@fdo-secretariat

Copy link
Copy Markdown
Contributor

The change needs to be discussed by the group, whether we need that section at all. The current list contains terms not used in the document. If we use the respec functions all used terms are links anyway to their definition.

@maximiliani maximiliani added the Future discussion This topic should be discussed at some point in the near future. label Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation Future discussion This topic should be discussed at some point in the near future.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Move terminology to the bottom as a glossary

3 participants