From 4b71f1cd5e7dabaa1fbef27b3740fcda81294717 Mon Sep 17 00:00:00 2001
From: asanvaq <anna.sanchovaquer@canonical.com>
Date: Fri, 9 Jan 2026 14:35:33 +0100
Subject: [PATCH 1/2] docs: updating reference landing page

---
 docs/reference/index.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/reference/index.md b/docs/reference/index.md
index bdd96f1..0e2c303 100644
--- a/docs/reference/index.md
+++ b/docs/reference/index.md
@@ -1,10 +1,38 @@
 # Reference
 
+This section provides concise references on available commands, package slices, and security.
+
+## Commands
+
+The `chisel` command has several subcommands.
+
 ```{toctree}
 :maxdepth: 1
 
 cmd/index
+```
+
+## Package slices
+Chisel relies on package slices.
+
+```{toctree}
+:maxdepth: 1
+
 chisel-releases/index
+```
+## Security
+Chisel records package, slice, and file metadata to ensure file-level integrity and traceability of the slices.
+
+```{toctree}
+:maxdepth: 1
+
 Manifest <manifest>
+```
+
+Cryptographic verification ensures the integrity and autenticity of the files.
+
+```{toctree}
+:maxdepth: 1
+
 Security Documentation <security>
 ```

From cc48452b1f9dde5e3a1670d819bd9dc08f7d7d43 Mon Sep 17 00:00:00 2001
From: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Date: Fri, 9 Jan 2026 14:53:49 +0100
Subject: [PATCH 2/2] docs: fixing spelling

Signed-off-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
---
 docs/reference/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/index.md b/docs/reference/index.md
index 0e2c303..7731233 100644
--- a/docs/reference/index.md
+++ b/docs/reference/index.md
@@ -29,7 +29,7 @@ Chisel records package, slice, and file metadata to ensure file-level integrity
 Manifest <manifest>
 ```
 
-Cryptographic verification ensures the integrity and autenticity of the files.
+Cryptographic verification ensures the integrity and authenticity of the files.
 
 ```{toctree}
 :maxdepth: 1