Add intro to developer documentation

input-output-hk · May 8, 2024 · 4f77271 · 4f77271
1 parent d9d0f62
commit 4f77271
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 4 deletions.
diff --git a/docs/docs/dev/index.md b/docs/docs/dev/index.md
@@ -4,8 +4,8 @@ sidebar_position: 1
 
 # About Hydra
 
-So you read already the [User Manual](../index.md) and still want to learn more about the Hydra protocol, its inner workings and how it is implemented?
+So you already read the [User Manual](../index.md) and still want to learn more about the Hydra protocol, its inner workings and how it is implemented?
 
-Look no further...
+The developer documentation can help you with that. It is a collection of materials expanding on _using_ into _understanding_ Hydra. It is aimed anyone wanting to get a deeper understanding of the Hydra protocol, protocol architects who want to build their own variants and of course developers who contribute to the [reference implementation](https://github.com/input-output-hk/hydra) of Hydra itself.
 
-<!-- TODO: complete intro -->
+Consequently, the following sections are more technical and maybe not as cohesive as the user manual, but the [architecture](./architecture) or the [specification](./specification) should be a good starting point. 
diff --git a/docs/docs/dev/specification.md b/docs/docs/dev/specification.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 6
+sidebar_position: 2
 custom_edit_url: https://github.com/input-output-hk/hydra/tree/master/spec
 ---