srid · srid · Feb 9, 2024 · Feb 9, 2024 · Feb 9, 2024 · Feb 9, 2024
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 # haskell-flake - Manage Haskell projects conveniently with Nix
 
-<img src="./doc/haskell-flake/haskell-flake.webp" width=100 />
+<img src="./doc/haskell-flake.webp" width=100 />
 
 There are [several ways](https://nixos.asia/en/haskell) to manage Haskell packages using [Nix](https://nixos.asia/en/nix) with varying degrees of integration.  `haskell-flake` makes Haskell development, packaging and deployment with Nix flakes a lot [simpler](https://community.flake.parts/haskell-flake/start#under-the-hood) than other existing approaches.  This project is set up as a modern [`flake-parts`](https://flake.parts/) module to integrate easily into other Nix projects and shell development environments in a lightweight and modular way.
 

diff --git a/doc/haskell-flake/debugging.md → doc/debugging.md b/doc/haskell-flake/debugging.md → doc/debugging.md
diff --git a/doc/haskell-flake/dependency.md → doc/dependency.md b/doc/haskell-flake/dependency.md → doc/dependency.md
diff --git a/doc/haskell-flake/devshell.md → doc/devshell.md b/doc/haskell-flake/devshell.md → doc/devshell.md
diff --git a/doc/haskell-flake/docker.md → doc/docker.md b/doc/haskell-flake/docker.md → doc/docker.md
diff --git a/doc/haskell-flake/examples.md → doc/examples.md b/doc/haskell-flake/examples.md → doc/examples.md
diff --git a/doc/flake.lock b/doc/flake.lock
diff --git a/doc/haskell-flake/guide.md → doc/guide.md b/doc/haskell-flake/guide.md → doc/guide.md
diff --git a/doc/haskell-flake/haskell-flake.webp → doc/haskell-flake.webp b/doc/haskell-flake/haskell-flake.webp → doc/haskell-flake.webp
diff --git a/doc/haskell-flake/test.sh b/doc/haskell-flake/test.sh
diff --git a/doc/haskell-flake.md → doc/index.md b/doc/haskell-flake.md → doc/index.md
@@ -9,9 +9,7 @@ emanote:
 
 # Haskell development using `haskell-flake`
 
-
-[haskell-flake](https://github.com/srid/haskell-flake) is a [flake-parts](https://flake.parts/) module to make Haskell development [simpler](haskell-flake/start.md#under-the-hood) with [Nix](https://nixos.asia/en/nix).
-
+[haskell-flake](https://github.com/srid/haskell-flake) is a [flake-parts](https://flake.parts/) module to make Haskell development [[under-the-hood|simpler]] with [Nix](https://nixos.asia/en/nix).
 
 To get started, see [[start]]# and thereon see [[guide]]#. To get inspired, see [[examples]]#. For reference, see [[ref]]#.
 

diff --git a/doc/haskell-flake.yaml → doc/index.yaml b/doc/haskell-flake.yaml → doc/index.yaml
diff --git a/doc/haskell-flake/modules.md → doc/modules.md b/doc/haskell-flake/modules.md → doc/modules.md
diff --git a/doc/haskell-flake/package-set.md → doc/package-set.md b/doc/haskell-flake/package-set.md → doc/package-set.md
diff --git a/doc/haskell-flake/ref.md → doc/ref.md b/doc/haskell-flake/ref.md → doc/ref.md
diff --git a/doc/haskell-flake/size.md → doc/size.md b/doc/haskell-flake/size.md → doc/size.md
diff --git a/doc/start.md b/doc/start.md
@@ -0,0 +1,38 @@
+---
+order: -10
+---
+
+# Getting Started
+
+Before using `haskell-flake` you must first [install Nix](https://flakular.in/install).
+
+## Existing projects
+
+To use `haskell-flake` in an *existing* Haskell project, run:
+
+```bash
+nix flake init -t github:srid/haskell-flake
+```
+
+Open the generated `flake.nix` and change `self'.packages.example` to use your package name. For example, if your package is named `my-package` (with a `my-package.cabal` file), change `example` to `my-package`. Follow the comments along the `flake.nix` to make any necessary changes to the project configuration.
+
+## New projects
+
+To create a *new* Haskell project, instead, run:
+
+```bash
+mkdir example && cd ./example
+nix flake init -t github:srid/haskell-flake#example
+```
+
+### Template
+
+You may also use https://github.com/srid/haskell-template which already uses `haskell-flake` along with other opinionated defaults.
+
+## Under the hood
+
+![[under-the-hood]]
+
+## Next steps
+
+Visit [[guide]] for more details, and [[ref]] for module options.
diff --git a/doc/haskell-flake/start.md → doc/under-the-hood.md b/doc/haskell-flake/start.md → doc/under-the-hood.md
@@ -1,35 +1,5 @@
----
-order: -10
----
 
-# Getting Started
-
-Before using `haskell-flake` you must first [install Nix](https://flakular.in/install).
-
-## Existing projects
-
-To use `haskell-flake` in an *existing* Haskell project, run:
-
-```bash
-nix flake init -t github:srid/haskell-flake
-```
-
-Open the generated `flake.nix` and change `self'.packages.example` to use your package name. For example, if your package is named `my-package` (with a `my-package.cabal` file), change `example` to `my-package`. Follow the comments along the `flake.nix` to make any necessary changes to the project configuration.
-
-## New projects
-
-To create a *new* Haskell project, instead, run:
-
-```bash
-mkdir example && cd ./example
-nix flake init -t github:srid/haskell-flake#example
-```
-
-### Template
-
-You may also use https://github.com/srid/haskell-template which already uses `haskell-flake` along with other opinionated defaults.
-
-## Under the hood
+# Under the hood
 
 >[!tip] Under the hood
 > See [this tutorial](https://nixos.asia/en/nixify-haskell-nixpkgs) to understand what it takes to package a Haskell application without haskell-flake.
@@ -43,6 +13,4 @@ In addition, compared to using plain nixpkgs, haskell-flake supports:
 - Modular interface to `pkgs.haskell.lib.compose.*` (via `packages` and `settings` submodules)
 - Composition of dependency overrides, and other project settings, via [[modules]]
 
-## Next steps
-
-Visit [[guide]] for more details, and [[ref]] for module options.
+See #[[start]] for getting started with haskell-flake.