Deployed 9bae9f2 with MkDocs version: 1.6.1

404.html

@@ -221,7 +221,7 @@
 
 
 
-  Home
+  Principles
 
       </a>
     </li>
@@ -247,6 +247,25 @@
 
 
 
+        
+  
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="/tooling/" class="md-tabs__link">
+        
+  
+  
+    
+  
+  Tooling
+
+      </a>
+    </li>
+  
+
+      
     </ul>
   </div>
 </nav>
@@ -306,7 +325,7 @@
 
 
   <span class="md-ellipsis">
-    Home
+    Principles
 
   </span>
 
@@ -338,6 +357,28 @@
 
 
 
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/tooling/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Tooling
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>

benefits/index.html

@@ -16,6 +16,8 @@
         <link rel="prev" href="..">
 
 
+        <link rel="next" href="../tooling/">
+      
 
       <link rel="icon" href="../assets/images/favicon.png">
       <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.6.22">
@@ -230,7 +232,7 @@
 
 
 
-  Home
+  Principles
 
       </a>
     </li>
@@ -258,6 +260,25 @@
 
 
 
+        
+  
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../tooling/" class="md-tabs__link">
+        
+  
+  
+    
+  
+  Tooling
+
+      </a>
+    </li>
+  
+
+      
     </ul>
   </div>
 </nav>
@@ -317,7 +338,7 @@
 
 
   <span class="md-ellipsis">
-    Home
+    Principles
 
   </span>
 
@@ -436,6 +457,28 @@
 
 
 
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../tooling/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    Tooling
+    
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
   </ul>
 </nav>
                   </div>

index.html

@@ -74,7 +74,7 @@
     <div data-md-component="skip">
 
 
-        <a href="#codebase-interface" class="md-skip">
+        <a href="#principles" class="md-skip">
           Skip to content
         </a>
 
@@ -108,7 +108,7 @@
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">
 
-              Home
+              Principles
 
           </span>
         </div>
@@ -232,7 +232,7 @@
 
 
 
-  Home
+  Principles
 
       </a>
     </li>
@@ -258,6 +258,25 @@
 
 
 
+        
+  
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="tooling/" class="md-tabs__link">
+        
+  
+  
+    
+  
+  Tooling
+
+      </a>
+    </li>
+  
+
+      
     </ul>
   </div>
 </nav>
@@ -321,59 +340,40 @@
 
 
 
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  
-  <span class="md-ellipsis">
-    Home
-    
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
       <a href="." class="md-nav__link md-nav__link--active">
 
 
 
   <span class="md-ellipsis">
-    Home
+    Principles
 
   </span>
 
 
       </a>
 
-        
+    </li>
+  
 
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+    
+      
+      
 
 
 
-    
 
+    <li class="md-nav__item">
+      <a href="benefits/" class="md-nav__link">
+        
 
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#principles" class="md-nav__link">
-    <span class="md-ellipsis">
-      Principles
-    </span>
-  </a>
 
-</li>
-      
-    </ul>
+  <span class="md-ellipsis">
+    Benefits
+    
+  </span>
 
-</nav>
-      
+
+      </a>
     </li>
 
 
@@ -385,12 +385,12 @@
 
 
     <li class="md-nav__item">
-      <a href="benefits/" class="md-nav__link">
+      <a href="tooling/" class="md-nav__link">
 
 
 
   <span class="md-ellipsis">
-    Benefits
+    Tooling
 
   </span>
 
@@ -424,8 +424,7 @@
 
 
 
-<h1 id="codebase-interface">Codebase Interface<a class="headerlink" href="#codebase-interface" title="Permanent link">&para;</a></h1>
-<h2 id="principles">Principles<a class="headerlink" href="#principles" title="Permanent link">&para;</a></h2>
+<h1 id="principles">Principles<a class="headerlink" href="#principles" title="Permanent link">&para;</a></h1>
 <ol>
 <li>Identify and empathise with all audience perspectives on the codebase - contributors, users, operators, AI agents, Build agents.</li>
 <li>Provide specific interfaces for each audience perspective.</li>
@@ -456,7 +455,7 @@ <h2 id="principles">Principles<a class="headerlink" href="#principles" title="Pe
     <span class="md-icon" title="Last update">
       <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
     </span>
-    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="October 15, 2025 20:01:28 UTC">October 15, 2025</span>
+    <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="October 15, 2025 20:05:23 UTC">October 15, 2025</span>
   </span>
 
 

search/search_index.json

@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Codebase Interface","text":""},{"location":"#principles","title":"Principles","text":"<ol> <li>Identify and empathise with all audience perspectives on the codebase - contributors, users, operators, AI agents, Build agents.</li> <li>Provide specific interfaces for each audience perspective.</li> <li>Ensure each audience interface is clean and remains maintainable.</li> <li>Provide a consistent abstraction over languages and frameworks.</li> <li>Provide a codebase experience that can be replicated by any audience, anywhere and on any platform.</li> <li>Do not be constrained by current technology and tools - provoke change to how we would like to interact with codebases over current constraints.</li> <li>Utilise cross platform and cross IDE tools and technologies to provide the interfaces.</li> <li>Empathise with your own future self who could become any of the audience perspectives at any time.</li> </ol>"},{"location":"benefits/","title":"Benefits","text":"<p>Benefits can be broken down per codebase audience type as they have been defined up-front. This is a benefit in itself as it allows to be considerate and then specific about the needs of each audience.</p>"},{"location":"benefits/#users","title":"Users","text":"<ul> <li>Users expect to interact with the codebase via a specific entry point that is the README.</li> <li>Users get a consistent experience across codebases and have expectations that can either be met or missed.</li> <li>Users understanding when expectations are missed promotes feedback and improvement.</li> <li>Users should be able to interact with the service based on the good user interface provided by the codebase.</li> </ul>"},{"location":"benefits/#contributors","title":"Contributors","text":"<ul> <li>Contributors expect to interact with the codebase via a specific entry point that is the README.</li> <li>Contributors get a consistent experience across codebases and have expectations that can either be met or missed.</li> <li>Contributors understanding when expectations are missed promotes feedback and improvement.</li> <li>Contributors should be able to make changes to the code base based on the good contributor interface provided by the codebase.</li> </ul>"},{"location":"benefits/#operators","title":"Operators","text":""},{"location":"benefits/#ai-agents","title":"AI Agents","text":""},{"location":"benefits/#build-agents","title":"Build Agents","text":""}]}
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Principles","text":"<ol> <li>Identify and empathise with all audience perspectives on the codebase - contributors, users, operators, AI agents, Build agents.</li> <li>Provide specific interfaces for each audience perspective.</li> <li>Ensure each audience interface is clean and remains maintainable.</li> <li>Provide a consistent abstraction over languages and frameworks.</li> <li>Provide a codebase experience that can be replicated by any audience, anywhere and on any platform.</li> <li>Do not be constrained by current technology and tools - provoke change to how we would like to interact with codebases over current constraints.</li> <li>Utilise cross platform and cross IDE tools and technologies to provide the interfaces.</li> <li>Empathise with your own future self who could become any of the audience perspectives at any time.</li> </ol>"},{"location":"benefits/","title":"Benefits","text":"<p>Benefits can be broken down per codebase audience type as they have been defined up-front. This is a benefit in itself as it allows to be considerate and then specific about the needs of each audience.</p>"},{"location":"benefits/#users","title":"Users","text":"<ul> <li>Users expect to interact with the codebase via a specific entry point that is the README.</li> <li>Users get a consistent experience across codebases and have expectations that can either be met or missed.</li> <li>Users understanding when expectations are missed promotes feedback and improvement.</li> <li>Users should be able to interact with the service based on the good user interface provided by the codebase.</li> </ul>"},{"location":"benefits/#contributors","title":"Contributors","text":"<ul> <li>Contributors expect to interact with the codebase via a specific entry point that is the README.</li> <li>Contributors get a consistent experience across codebases and have expectations that can either be met or missed.</li> <li>Contributors understanding when expectations are missed promotes feedback and improvement.</li> <li>Contributors should be able to make changes to the code base based on the good contributor interface provided by the codebase.</li> </ul>"},{"location":"benefits/#operators","title":"Operators","text":""},{"location":"benefits/#ai-agents","title":"AI Agents","text":""},{"location":"benefits/#build-agents","title":"Build Agents","text":""},{"location":"tooling/","title":"Tooling","text":""},{"location":"tooling/#abstractions","title":"Abstractions","text":"<ul> <li>Taskfile - 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.</li> </ul>"},{"location":"tooling/#ide-agnostic-files","title":"IDE Agnostic Files","text":"<ul> <li>EditorConfig - 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.</li> <li><code>.gitignore</code> - 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.</li> <li><code>.gitattributes</code> - 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.</li> <li><code>.dockerignore</code> - 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.</li> <li><code>.env</code> - 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.</li> </ul>"}]}

sitemap.xml

@@ -8,4 +8,8 @@
          <loc>https://codebaseinterface.org/benefits/</loc>
          <lastmod>2025-10-15</lastmod>
     </url>
+    <url>
+         <loc>https://codebaseinterface.org/tooling/</loc>
+         <lastmod>2025-10-15</lastmod>
+    </url>
 </urlset>