diff --git a/README.md b/README.md
index 9c9f2492..32f6d9c6 100644
--- a/README.md
+++ b/README.md
@@ -3,25 +3,47 @@
 
 The header-only part of the Lol Engine framework.
 
-| header | category | description |
-|--------|:--------:|-------------|
-| `<lol/cli>`       | system | command-line parsing |
-| `<lol/dialogs>`   | system | portable file dialogs (imported from [here](https://github.com/samhocevar/portable-file-dialogs)) |
-| `<lol/file>`      | system | file reading utilities |
-| `<lol/msg>`       | system | simple message logging |
-| `<lol/thread>`    | system | threading and timers |
-| `<lol/unit_test>` | system | unit test framework |
-| `<lol/utils>`     | system | various utilities: environment variables, string formatting, std::map and std::vector extensions… |
-| `<lol/narray>` | containers | n-dimensional dynamic array container |
-| `<lol/pegtl>`             | text | the PEGTL parsing library (imported from [here](https://github.com/taocpp/PEGTL) |
-| `<lol/algo/suffix_array>` | text | suffix array library (imported from [here](https://github.com/storm-ptr/step) |
-| `<lol/color>` | graphics | color conversions |
-| `<lol/image>` | graphics | image loading, saving, and processing |
-| `<lol/bigint>`    | math | big integer calculations |
-| `<lol/half>`      | math | half-precision (16-bit) floating point numbers |
-| `<lol/math>`      | math | math constants, functions, random number generators, polynomials |
-| `<lol/noise>`     | math | Perlin and simplex noise |
-| `<lol/real>`      | math | arbitrary precision floating point numbers |
-| `<lol/transform>` | math | quaternion, matrix and SQT transformation utilities |
-| `<lol/vector>`    | math | GLSL-compatible vector classes |
+## Sytem headers
+
+| header | description | examples |
+|--------|-------------|----------|
+| `<lol/cli>`       | command-line parsing (imported from [cliutils/cli11](https://github.com/CLIUtils/CLI11)) | |
+| `<lol/dialogs>`   | portable file dialogs (imported from [samhocevar/portable-file-dialogs](https://github.com/samhocevar/portable-file-dialogs)) | |
+| `<lol/file>`      | file reading utilities | |
+| `<lol/msg>`       | simple message logging | |
+| `<lol/thread>`    | threading and timers | |
+| `<lol/unit_test>` | unit test framework | |
+| `<lol/utils>`     | various utilities: environment variables, string formatting, std::map and std::vector extensions… | |
+
+## Containers
+
+| header | description | examples |
+|--------|-------------|----------|
+| `<lol/narray>` | n-dimensional dynamic array containers | ● `lol::narray<T, dimensions>`<br>● `lol::array2d<T>` and `lol::array3d<T>`<br>● `lol::narray_view<T, dimensions>`<br>● `lol::array2d_view<T>` and `lol::array3d_view<T>` |
+
+## Text utilities
+
+| header | description | examples |
+|--------|-------------|----------|
+| `<lol/pegtl>`             | the PEGTL parsing library (imported from [taocpp/pegtl](https://github.com/taocpp/PEGTL)) | |
+| `<lol/algo/suffix_array>` | suffix array library (imported from [storm-ptr/step](https://github.com/storm-ptr/step)) | |
+
+## Graphics
+
+| header | description | examples |
+|--------|-------------|----------|
+| `<lol/color>` | colorspace conversions (RGB, sRGB, HSV…) | |
+| `<lol/image>` | image loading, saving, and processing | |
+
+## Math
+
+| header | description | examples |
+|--------|-------------|----------|
+| `<lol/bigint>`    | big integer calculations | |
+| `<lol/half>`      | half-precision (16-bit) floating point numbers | |
+| `<lol/math>`      | math constants, functions, random number generators, polynomials | |
+| `<lol/noise>`     | Perlin and simplex noise | |
+| `<lol/real>`      | arbitrary precision floating point numbers | |
+| `<lol/transform>` | quaternion, matrix and SQT transformation utilities | |
+| `<lol/vector>`    | GLSL-compatible vector classes | |