Merge pull request #7455 from rapenne-s/documentation_fix

Add anchors and links to definition

src/libcmd/common-eval-args.cc

@@ -77,7 +77,7 @@ MixEvalArgs::MixEvalArgs()
   branch in the `nixpkgs` repository.
 
   The URLs of the tarballs from the official `nixos.org` channels
-  (see [the manual page for `nix-channel`](nix-channel.md)) can be
+  (see [the manual page for `nix-channel`](../nix-channel.md)) can be
   abbreviated as `channel:<channel-name>`.  For instance, the
   following two flags are equivalent:
 
@@ -86,7 +86,7 @@ MixEvalArgs::MixEvalArgs()
   -I nixpkgs=https://nixos.org/channels/nixos-21.05/nixexprs.tar.xz
   ```
 
-  You can also fetch source trees using flake URLs and add them to the
+  You can also fetch source trees using [flake URLs](./nix3-flake.md#url-like-syntax) and add them to the
   search path. For instance,
 
   ```

src/nix/flake.md

@@ -18,7 +18,10 @@ values such as packages or NixOS modules provided by the flake).
 Flake references (*flakerefs*) are a way to specify the location of a
 flake. These have two different forms:
 
-* An attribute set representation, e.g.
+
+## Attribute set representation
+
+Example:
 
 ```nix
 {
@@ -31,7 +34,9 @@ flake. These have two different forms:
 The only required attribute is `type`. The supported types are
 listed below.
 
-* A URL-like syntax, e.g.
+## URL-like syntax
+
+Example:
 
 ```
 github:NixOS/nixpkgs
@@ -62,7 +67,7 @@ flake. These have two different forms:
 };
 ```
 
-## Examples
+### Examples
 
 Here are some examples of flake references in their URL-like representation: