feat: restructure documentation navigation and add tooling section

Author: dataGriff

docs/index.md

@@ -1,6 +1,4 @@
-# Codebase Interface
-
-## Principles
+# Principles
 
 1. Identify and empathise with all audience perspectives on the codebase - contributors, users, operators, AI agents, Build agents.
 2. Provide specific interfaces for each audience perspective.

docs/tooling.md

@@ -0,0 +1,13 @@
+# Tooling
+
+## Abstractions
+
+- [Taskfile](https://taskfile.dev/) - A simple and easy to use task runner / build tool that aims to be a simpler and more powerful Make alternative. It is written in Go and uses a YAML file to define tasks. It is cross platform and works on Windows, MacOS and Linux. It is also IDE agnostic as it can be run from the command line.
+
+## IDE Agnostic Files
+
+- [EditorConfig](https://editorconfig.org/) - A file format and collection of text editor plugins for maintaining consistent coding styles between different editors and IDEs. It is cross platform and works on Windows, MacOS and Linux. It is also IDE agnostic as it can be used with any text editor or IDE that supports the EditorConfig file format.
+- [`.gitignore`](https://git-scm.com/docs/gitignore) - A plain text file that tells Git which files and directories to ignore in a project. It is cross platform and works on Windows, MacOS and Linux. It is also IDE agnostic as it can be used with any text editor or IDE that supports Git.
+- [`.gitattributes`](https://git-scm.com/docs/gitattributes) - A plain text file that tells Git how to handle certain files in a project. It is cross platform and works on Windows, MacOS and Linux. It is also IDE agnostic as it can be used with any text editor or IDE that supports Git.
+- [`.dockerignore`](https://docs.docker.com/engine/reference/builder/#dockerignore-file) - A plain text file that tells Docker which files and directories to ignore when building an image. It is cross platform and works on Windows, MacOS and Linux. It is also IDE agnostic as it can be used with any text editor or IDE that supports Docker.
+- [`.env`](https://12factor.net/config) - A plain text file that contains environment variables for a project. It is cross platform and works on Windows, MacOS and Linux. It is also IDE agnostic as it can be used with any text editor or IDE that supports environment variables.

mkdocs.yml

@@ -32,8 +32,9 @@ theme:
         name: Switch to light mode
 
 nav:
-  - Home: index.md
+  - Principles: index.md
   - Benefits: benefits.md
+  - Tooling: tooling.md
 
 
 plugins: