Structure of a PLATEAU document

[ronaldtse]

In the following order.

Document 001

Introduction (はじめに) [unnumbered]

Summary of changes (改定の概要) [unnumbered]

TOC

1 Overview 概覧

1.1 "Product Specification Authorship Information 製品仕様の作成情報"

1.2. "Purpose 目的" (generic text)

1.3 "Product Scope 製品の範囲" (generic text)

1.4 "References" 引用規格等

Table 1 References that are standards

Table 2 References that are specifications

1.5 Terms and definitions 用語と定義

"標準製品仕様書で使用する用語を示す。以下に記載のない用語とその定義については、JPGIS 2014 付属書 5（規定）定義に従う。" => "The following terms are used in the standard product specifications. Terms and definitions not listed below are defined in JPGIS 2014, Appendix 5 (normative)."

1.6 Abbreviations 略語

A table describing a mapping of an abbreviation to version used.

Scope (適用範囲) [Clause 2]

Body content

Clause 3 and onwards.

Clause hierarchy:

PDF TOC:

Clause hierarchy:

PDF TOC:

"Footnote"

"Table Key"

"Table Source"

Bibliography [unnumbered]

Change history [unnumbered]

日付 => Date 版 => Edition 説明 => Description

Back cover [unnumbered]

[ronaldtse]

Document 002

Foreword

Summary of changes

TOC

Different from 001:

• the Overview is included as Clause 0, instead of Clause 1
• there are Annexes

0 Overview 概覧

Different from 001:

• It is called 概要 (abstract) not 概覧 (overview)
• it shows the Title (3D 都市モデル標準作業手順書) before Overview (概要):

0.1 本書の目的

"本書の目的" (Purpose of this book) instead of just "目的" (Purpose) in 001. So this is free text?

0.2 引用文献

Different in title name of first table (standards references):

No second table (specification references).

Instead of a table in Abbreviated terms referring to versions, this information is provided in the References clause.

Main body elements

0.4 本書で使用する用語 (Terms and definitions)

But there is additional explanatory text after:

Main text from Clause 1 onwards

These additional elements:

"Item of attention"

"Explanation"

"Example" <img width="528" alt="Screenshot 2024-05-25 at 10 58 48 AM" src="https://github.com/metanorma/metanorma-plateau/assets/11865/64115eb3-b166-4

0b8-9a79-fbdbd5e47266">

"Requirement"

"Recommendation"

Clause hierarchy:

This subdivision of the clause is also in the TOC.

Bulleted items hierarchy:

Numbered list hierarchy:

Bibliography

Change history

Backcover

[ReesePlews]

@ronaldtse i will confirm if levels 4 and 5 should follow the current format or if it is possible to apply them to a JIS format. the current format is commonly used for japanese documents, yet there are disadvantages using these formats with machine processing and translation tools.

[ReesePlews]

@ronaldtse comments have been added to the off-github working document.

[ronaldtse]

Closing this since the document is nearly done.