fix mkdocs

Author: Mr-Leshiy

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

@@ -39,14 +39,17 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 30
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"
   ```
 
-* [`ref`](./../signed_doc/meta.md#ref-document-reference). Reference to a related [Proposal Document].
-* [`template`](./../signed_doc/meta.md#ref-document-reference) must be equal to `0b8424d4-ebfd-46e3-9577-1775a69d290c` value, [comment template type](#comment-template).
+* [`ref`](./../signed_doc/meta.md#ref-document-reference).
+  Reference to a related [Proposal Document].
+* [`template`](./../signed_doc/meta.md#ref-document-reference) must be equal to `0b8424d4-ebfd-46e3-9577-1775a69d290c` value,
+  [comment template type](#comment-template).
 
   ```CDDL
   "template" => 37(h'0b8424d4ebfd46e395771775a69d290c')
@@ -91,7 +94,8 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 30
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"

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

@@ -43,14 +43,16 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 30
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"
   ```
 
 * [`ref`](./../signed_doc/meta.md#ref-document-reference) (optional).
-* [`template`](./../signed_doc/meta.md#ref-document-reference) must be equal to `0ce8ab38-9258-4fbc-a62e-7faa6e58318f` value, [proposal template type](#proposal-template).
+* [`template`](./../signed_doc/meta.md#ref-document-reference) must be equal to `0ce8ab38-9258-4fbc-a62e-7faa6e58318f` value,
+  [proposal template type](#proposal-template).
 
   ```CDDL
   "template" => 37(h'0ce8ab3892584fbca62e7faa6e58318f')
@@ -86,7 +88,8 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 30
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"

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

@@ -39,13 +39,15 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 30
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"
   ```
 
-* [`template`](./../signed_doc/meta.md#ref-document-reference) must be equal to `ebe5d0bf-5d86-4577-af4d-008fddbe2edc` value, [review template type](#review-template).
+* [`template`](./../signed_doc/meta.md#ref-document-reference) must be equal to `ebe5d0bf-5d86-4577-af4d-008fddbe2edc` value,
+  [review template type](#review-template).
 
   ```CDDL
   "template" => 37(h'ebe5d0bf5d864577af4d008fddbe2edc')
@@ -77,7 +79,8 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 30
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"

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

@@ -17,7 +17,7 @@ This document describes a Catalyst V2 vote transaction structure.
 Catalyst v2 voting transaction is a [Catalyst Signed Document],
 so its fully follows the structure of the [Catalyst Signed Document] specification.
 
-#### Metadata Fields
+### Metadata Fields
 
 A list of used [Catalyst Signed Document protected header fields](./../signed_doc/spec.md#signed-object-fields).
 
@@ -44,14 +44,14 @@ A list of used [Catalyst Signed Document protected header fields](./../signed_do
   3 => 50
   ```
 
-* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional): [Catalyst Signed Document content] must be [Brotli] compressed.
+* [`content encoding`](./../signed_doc/spec.md#content-encoding-optional):
+  [Catalyst Signed Document content] must be [Brotli] compressed.
 
   ```CDDL
   "content-type" => "br"
   ```
 
-
-##### Public vote
+#### Public vote
 
 For the public vote [`type`](./../signed_doc/spec.md#type) value defined as follows:
 
@@ -61,7 +61,7 @@ For the public vote [`type`](./../signed_doc/spec.md#type) value defined as foll
   "type" => 37(h'8DE5586CE9984B9587427BE3C8592803')
   ```
 
-###### Content format
+##### Content format
 
 The public vote transaction [Catalyst Signed Document content] format is based on the [Generalized Vote Transaction Structure].
 
@@ -75,7 +75,7 @@ Following that spec need to define a `choice`, `proof` and `prop-id`.
     ```
 <!-- markdownlint-enable max-one-sentence-per-line code-block-style -->
 
-##### Private vote
+#### Private vote
 
 For the private vote [`type`](./../signed_doc/spec.md#type) value defined as follows:
 
@@ -85,7 +85,7 @@ For the private vote [`type`](./../signed_doc/spec.md#type) value defined as fol
   "type" => 37(h'E78EE18DF38044C1A85280AA6ECB07FE')
   ```
 
-###### Content format
+##### Content format
 
 The private vote transaction [Catalyst Signed Document content] format is based on the [Generalized Vote Transaction Structure].
 
@@ -99,7 +99,7 @@ Following that spec need to define a `choice`, `proof` and `prop-id`.
     ```
 <!-- markdownlint-enable max-one-sentence-per-line code-block-style -->
 
-###### Vote and Proof generation
+##### Vote and Proof generation
 
 To generate a cryptographically secured `choice-data` and `zk_proof` parts you can follow this [spec](./crypto.md#vote).
 Important to note,
@@ -129,4 +129,4 @@ the following properties are used:
 [ristretto255]: https://ristretto.group
 [Brotli]: https://datatracker.ietf.org/doc/html/rfc7932
 [UUID]: https://www.rfc-editor.org/rfc/rfc9562.html
-[CBOR]: https://datatracker.ietf.org/doc/rfc8949/
+[CBOR]: https://datatracker.ietf.org/doc/rfc8949/

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

@@ -1,5 +1,5 @@
 title: Catalyst Signed Document
 nav:
-- Specification: spec.md
-- Metadata Fields List: meta.md
-- Document Types: types.md
+  - Specification: spec.md
+  - Metadata Fields: meta.md
+  - Document Types: types.md

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

@@ -1,3 +1,4 @@
+# Metadata Fields List
 
 <!-- markdownlint-disable max-one-sentence-per-line code-block-style -->
 ??? note "Additional Metadata fields: `additional_meta.cddl`"
@@ -79,4 +80,3 @@ It does NOT mean that the listed collaborators have agreed to collaborate, only
 gives them permission to.*
 
 This list can impact actions that can be performed by the `Proposal Action Document`.
-

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

@@ -91,7 +91,8 @@ be well constructed.
 
 Creating `id` this way ensures there are no collisions, and they can be independently created without central co-ordination.
 
-*Note: All Catalyst Signed Documents are signed, the first creation of an `id` assigns that `id` to the creator and any assigned collaborators.
+*Note: All Catalyst Signed Documents are signed,
+the first creation of an `id` assigns that `id` to the creator and any assigned collaborators.
 A Catalyst Signed Document that is not signed by the creator, or an assigned collaborator, is invalid.
 There is no reasonable way an `id` can collide accidentally.
 Therefore, detection of invalid `id`s published by unauthorized publishers, could result in anti-spam
@@ -161,13 +162,13 @@ signature_protected_header = {
 ```
 <!-- markdownlint-enable code-block-style -->
 
-* `kid`: A unique identifier of the signer. A [UTF-8] encoded [URI] string.
+* `kid`: A unique identifier of the signer.
+  A [UTF-8] encoded [URI] string.
 
 ## Copyright
 
 This document is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode).
 
-
 [Brotli]: https://datatracker.ietf.org/doc/html/rfc7932
 [UTF-8]: https://datatracker.ietf.org/doc/html/rfc3629
 [URI]: https://datatracker.ietf.org/doc/html/rfc3986

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

@@ -1,3 +1,4 @@
+# Document Types Table
 
 | [UUID]                               | [CBOR]                                    | Type Description             | Payload Type                      | Specification Link                                                         |
 | ------------------------------------ | ----------------------------------------- | ---------------------------- | --------------------------------- | -------------------------------------------------------------------------- |
@@ -17,9 +18,8 @@
 | 8de5586c-e998-4b95-8742-7be3c8592803 | `37(h'8DE5586CE9984B9587427BE3C8592803')` | Public Vote Tx V2            | [Brotli] Compressed [CBOR]        | [Public Vote Tx V2 Spec](./../catalyst_voting/v2.md#public-vote)           |
 | e78ee18d-f380-44c1-a852-80aa6ecb07fe | `37(h'E78EE18DF38044C1A85280AA6ECB07FE')` | Private Vote Tx V2           | [Brotli] Compressed [CBOR]        | [Private Vote Tx V2 Spec](./../catalyst_voting/v2.md#private-vote)         |
 
-
 [JSON Schema]: https://json-schema.org/draft-07
 [JSON]: https://datatracker.ietf.org/doc/html/rfc7159
 [Brotli]: https://datatracker.ietf.org/doc/html/rfc7932
 [CBOR]: https://datatracker.ietf.org/doc/html/rfc8610
-[UUID]: https://www.rfc-editor.org/rfc/rfc9562.html
+[UUID]: https://www.rfc-editor.org/rfc/rfc9562.html