feat: update documentation structure and add language interface section

Author: dataGriff

docs/index.md

@@ -1,4 +1,12 @@
-# Principles
+# Home
+
+Welcome to the codebase interface documentation!
+
+The codebase interface is a set of principles and practices that allow us to identify and understand all perspectives of interacting with a codebase, including contributors, users, operators, AI agents, and build agents.
+
+By providing specific interfaces for each audience perspective, we can ensure that everyone has a clean and maintainable experience when interacting with a codebase.
+
+## 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/interfaces/agents.md

@@ -1,3 +1,3 @@
 # Agents
 
-**Primary Audience**: AI Agents
+- **Primary Audience**: AI Agents

docs/interfaces/changelog.md

@@ -1,4 +1,4 @@
 # Changelog
 
-**Primary Audience**: Users
-**Secondary Audience**: Contributors, Operators
+- **Primary Audience**: Users
+- **Secondary Audience**: Contributors, Operators

docs/interfaces/contributing.md

@@ -1,3 +1,3 @@
 # Contributing
 
-**Primary Audience**: Contributors
+- **Primary Audience**: Contributors

docs/interfaces/language.md

@@ -0,0 +1,3 @@
+# Language
+
+- **Primary Audience**: All Audiences

docs/interfaces/readme.md

@@ -1,4 +1,4 @@
 # Readme
 
-**Primary Audience**: Users
-**Secondary Audience**: Contributors, Operators
+- **Primary Audience**: Users
+- **Secondary Audience**: Contributors, Operators

docs/interfaces/runbook.md

@@ -1,3 +1,3 @@
 # Runbook
 
-**Primary Audience**: Operators
+- **Primary Audience**: Operators