Setup basic document sections and structure

Add specification sections to match expected work items.  Organize document
corresponding to ultimate future disposition of each section.

Makefile

@@ -13,7 +13,7 @@
 # the Doc Template for RISC-V Extensions.
 
 DOCS := \
-	spec-sample.adoc
+	composable-custom-extensions.adoc
 
 DATE ?= $(shell date +%Y-%m-%d)
 VERSION ?= v0.0.0

src/spec-sample.adoc → src/composable-custom-extensions.adoc

@@ -1,10 +1,10 @@
-= RISC-V Example Specification Document (Zexmpl)
-Authors: Author 1, Author 2
+= RISC-V Composable Custom Extensions (Ztodo)
+Authors: RISC-V Composable Custom Extensions Task Group
 :docgroup: RISC-V Task Group
-:description: RISC-V Example Specification Document (Zexmpl)
+:description: RISC-V Composable Custom Extensions Specification Document (Ztodo)
 :company: RISC-V.org
-:revdate: 1/2023
-:revnumber: 1.0
+:revdate: 2024-12-23
+:revnumber: 0.0
 :revremark: This document is under development. Expect potential changes. Visit http://riscv.org/spec-state for further details.
 :revinfo:
 :url-riscv: http://riscv.org
@@ -21,7 +21,7 @@ Authors: Author 1, Author 2
 //:WaveDromEditorApp: app/wavedrom-editor.app
 :imagesoutdir: ../build/images
 :srcdir: src
-:bibtex-file: {srcdir}/example.bib
+:bibtex-file: {srcdir}/biblio.bib
 :bibtex-order: alphabetical
 :bibtex-style: apa
 :icons: font
@@ -61,7 +61,16 @@ Copyright 2024 by RISC-V International.
 include::contributors.adoc[]
 
 include::intro.adoc[]
-include::chapter2.adoc[]
+include::isa.adoc[]
+include::isa-priv.adoc[]
+include::isa-unpriv.adoc[]
+include::isa-state.adoc[]
+include::non-isa.adoc[]
+include::criteria.adoc[]
+include::li.adoc[]
+
+include::external.adoc[]
+include::guidance.adoc[]
 
 // The index must precede the bibliography
 include::index.adoc[]

src/contributors.adoc

@@ -3,5 +3,4 @@
 This RISC-V specification has been contributed to directly or indirectly by:
 
 [%hardbreaks]
-* Author1 <required1@email.com>
-* Author2 <required2@email.com>
+* Darius Rad <darius@bluespec.com>

src/criteria.adoc

@@ -0,0 +1,6 @@
+[[criteria]]
+== Composability criteria
+
+=== Basic Criteria
+
+=== Composable Memory Access Behavior

src/external.adoc

@@ -0,0 +1,41 @@
+[[external]]
+[appendix]
+= External Specifications
+
+This section contains changes to external specifications for RISC-V
+Composable Custom Extensions.  It is intended that as these sections
+are incorporated into the upstream specification or similar, they will
+be removed from this document.  External specifications include both
+RISC-V and non-RISC-V specifications and other information
+specification mechanisms.
+
+=== Devicetree
+
+=== ACPI
+
+[NOTE]
+====
+This section will be incorporated into the ACPI Specification.
+====
+
+=== User Space ABI
+
+[NOTE]
+====
+This section will be incorporated into the RISC-V psABI Specification.
+====
+
+==== Composable Custom Extension Aware Calling Convention
+
+==== Legacy Interoperability Calling Convention
+
+=== User Space API
+
+=== SBI
+
+[NOTE]
+====
+This section will be incorporated into the RISC-V SBI Specification.
+====
+
+=== Linux

src/guidance.adoc

@@ -0,0 +1,10 @@
+[[guidance]]
+[appendix]
+= Guidance
+
+This section provides guidance for developing Composable Custom
+Extensions.  This entire section is non-normative.
+
+=== Software Recommendations
+
+=== Hardware Recommendations

src/isa-priv.adoc

@@ -0,0 +1,2 @@
+[[isa-priv]]
+== Privileged Opcode and State Multiplexing

src/isa-state.adoc

@@ -0,0 +1,2 @@
+[[isa-state]]
+== Privileged State Management 

src/isa-unpriv.adoc

@@ -0,0 +1,2 @@
+[[isa-unpriv]]
+== Unprivileged Opcode and State Multiplexing

src/isa.adoc

@@ -0,0 +1,5 @@
+[[isa]]
+= ISA Specification
+
+This section contains the ISA specification for RISC-V Composable
+Custom Extensions.

src/li.adoc

@@ -0,0 +1,2 @@
+[[li]]
+== Logic Interface

src/non-isa.adoc

@@ -0,0 +1,5 @@
+[[non-isa]]
+= Non-ISA Specification
+
+This section contains the non-ISA specification for RISC-V Composable
+Custom Extensions.