wip

Author: Mr-Leshiy

docs/src/architecture/08_concepts/catalyst_docs/index.md

@@ -56,8 +56,8 @@ is just the metadata that structure will carry for different kinds of documents.
 Catalyst signed document is a [Catalyst Signed Document],
 so its fully follows the structure of the [Catalyst Signed Document] specification.
 
-* [`content type`](./../signed_doc/index.md#content-type): `application/json`.
-  [Catalyst Signed Document content](./../signed_doc/index.md#signed-object-content) must be in [Json] format.
+* [`content type`](./../signed_doc/spec.md#content-type): `application/json`.
+  [Catalyst Signed Document content](./../signed_doc/spec.md#signed-object-content) must be in [Json] format.
 
   ```CDDL
   3 => 30
@@ -97,7 +97,7 @@ Document Contents are signed documents, and are typically produced in accordance
 Documents will contain metadata which allows the document to be categorized, versioned and linked.
 This data does not properly belong inside the document,
 but is critical to ensure the document is properly referenced and indexable.
-It is defined and specified as [Catalyst Signed Document protected header fields](./../signed_doc/index.md#signed-object-fields).
+It is defined and specified as [Catalyst Signed Document protected header fields](./../signed_doc/spec.md#signed-object-fields).
 
 ```CDDL
 ? "ref" => reference_type,
@@ -110,15 +110,15 @@ It is defined and specified as [Catalyst Signed Document protected header fields
 #### Document Reference : `ref` (optional)
 
 This is a reference to another document.
-The purpose of the `ref` will vary depending on the document [`type`](./../signed_doc/index.md#type).
+The purpose of the `ref` will vary depending on the document [`type`](./../signed_doc/spec.md#type).
 
 The `ref` can be either a single [UUID] or a [CBOR] Array of Two [UUID].
 
-If the `ref` is a single [UUID], it is a reference to the document of that [`id`](./../signed_doc/index.md#id).
+If the `ref` is a single [UUID], it is a reference to the document of that [`id`](./../signed_doc/spec.md#id).
 If the `ref` is a [CBOR] array, it has the form `[<id>,<ver>]` where:
 
-* `<id>` = the [UUID] of the referenced documents [`id`](./../signed_doc/index.md#id)
-* `<ver>` = the [UUID] of the referenced documents [`ver`](./../signed_doc/index.md#ver).
+* `<id>` = the [UUID] of the referenced documents [`id`](./../signed_doc/spec.md#id)
+* `<ver>` = the [UUID] of the referenced documents [`ver`](./../signed_doc/spec.md#ver).
 
 #### Template Reference : `template` (optional)
 
@@ -194,8 +194,8 @@ which is a reference to another comment,
 where the comment is in reply to the referenced comment.
 
 Comments may only [`reply`](#document-reference--reply-optional) to a single other comment document.
-The referenced `comment` must be for the same proposal [`id`](./../signed_doc/index.md#id),
-but can be for a different proposal [`ver`](./../signed_doc/index.md#ver).
+The referenced `comment` must be for the same proposal [`id`](./../signed_doc/spec.md#id),
+but can be for a different proposal [`ver`](./../signed_doc/spec.md#ver).
 
 Comments may *OPTIONALLY* also contain a [`section`](#document-reference--section-optional) field,
 when the comment only applies to a specific section to the document being commented upon,
@@ -228,7 +228,7 @@ Fund 14 project catalyst will deploy this scheme for Key derivation.>
 
 This document is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
 
-[Catalyst Signed Document]: ./../signed_doc/index.md
+[Catalyst Signed Document]: ./../signed_doc/spec.md
 [JSON Schema]: https://json-schema.org/draft-07
 [Brotli]: https://datatracker.ietf.org/doc/html/rfc7932
 [JSON]: https://datatracker.ietf.org/doc/html/rfc7159

docs/src/architecture/08_concepts/catalyst_voting/gen_vote_tx.md

@@ -26,18 +26,18 @@ Project "Catalyst" requires a structure to keep people vote's data in the secure
 Generalized vote transaction is a [Catalyst Signed Document],
 so its fully follows the structure of the [Catalyst Signed Document] specification.
 
-* [`content type`](./../signed_doc/index.md#content-type): `application/cbor`.
-  [Catalyst Signed Document content](./../signed_doc/index.md#signed-object-content) must be a [CBOR] encoded.
+* [`content type`](./../signed_doc/spec.md#content-type): `application/cbor`.
+  [Catalyst Signed Document content](./../signed_doc/spec.md#signed-object-content) must be a [CBOR] encoded.
 
   ```CDDL
   3 => 50
   ```
 
-* [`content encoding`](./../signed_doc/index.md#content-encoding-optional): is missing
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): is missing
 
 ### Content format
 
-The generalized vote transaction [content format](./../signed_doc/index.md#signed-object-content)
+The generalized vote transaction [content format](./../signed_doc/spec.md#signed-object-content)
 
 <!-- markdownlint-disable max-one-sentence-per-line code-block-style -->
 ??? note "vote transaction definition: `gen_vote_tx.cddl`"
@@ -70,5 +70,5 @@ Vote:
 
 <!-- OPTIONAL SECTIONS: see CIP-0001 > Document > Structure table -->
 
-[Catalyst Signed Document]: ./../signed_doc/index.md
+[Catalyst Signed Document]: ./../signed_doc/spec.md
 [CBOR]: https://datatracker.ietf.org/doc/rfc8949/

docs/src/architecture/08_concepts/catalyst_voting/v2.md

@@ -26,7 +26,7 @@ defined on top the ["Generalized Vote Transaction"](./gen_vote_tx.md#specificati
 
 Following that spec need to define a `choice`, `proof` and `prop-id`.
 
-Also additional [Catalyst Signed Document protected header fields](./../signed_doc/index.md#catalyst-signed-document-fields) are defined,
+Also additional [Catalyst Signed Document protected header fields](./../signed_doc/spec.md#catalyst-signed-document-fields) are defined,
 
 ```CDDL
 "brand_id" => UUID, ; UUID v4
@@ -54,7 +54,7 @@ Also additional [Catalyst Signed Document protected header fields](./../signed_d
     ```
 <!-- markdownlint-enable max-one-sentence-per-line code-block-style -->
 
-For the public vote [`type`](./../signed_doc/index.md#type) value defined as follows:
+For the public vote [`type`](./../signed_doc/spec.md#type) value defined as follows:
 
 ```CDDL
 vote-type = #6.37(h'8DE5586CE9984B9587427BE3C8592803') ; 8de5586c-e998-4b95-8742-7be3c8592803
@@ -70,7 +70,7 @@ vote-type = #6.37(h'8DE5586CE9984B9587427BE3C8592803') ; 8de5586c-e998-4b95-8742
     ```
 <!-- markdownlint-enable max-one-sentence-per-line code-block-style -->
 
-For the private vote [`type`](./../signed_doc/index.md#type) value defined as follows:
+For the private vote [`type`](./../signed_doc/spec.md#type) value defined as follows:
 
 ```CDDL
 vote-type = #6.37(h'E78EE18DF38044C1A85280AA6ECB07FE') ; e78ee18d-f380-44c1-a852-80aa6ecb07fe

docs/src/architecture/08_concepts/signed_doc/.pages

@@ -1,3 +1,4 @@
 title: Catalyst Signed Document
 nav:
-- Catalyst Signed Document Specification: index.md
+- Specification: spec.md
+- Metadata Fields List: meta.md

docs/src/architecture/08_concepts/signed_doc/meta.md

@@ -0,0 +1 @@
+Something