doc: Move docs to doc for brevity

Author: jhf

.aider.conf.yml

@@ -1,7 +1,7 @@
 # Allow editing of tmp files that are ignored by git.
 add-gitignore-files: true
 
-read: [README.md,CONVENTIONS.md,src/01_schema.sql,docs/api.md,docs/semantical_principles.md]
+read: [README.md,CONVENTIONS.md,src/01_schema.sql,doc/api.md,doc/semantical_principles.md]
 file: [todo.md,tmp/journal.md]
 
 # The code quality for large SQL file edits is not great,

README.md

@@ -265,7 +265,7 @@ This validation is implemented using a `CHECK` constraint on the regular table,
 
 ### Level 3: The Deep Dive - Complete API Reference
 
-For a complete, auto-generated reference of all functions and procedures, please see the [API Documentation](./docs/api.md).
+For a complete, auto-generated reference of all functions and procedures, please see the [API Documentation](./doc/api.md).
 
 ## Usage
 

docs/api.md doc/api.mddocs/api.md renamed to doc/api.md

@@ -29,7 +29,7 @@ GRANT CREATE ON SCHEMA public TO PUBLIC;
 \t
 \a
 -- Redirect output to the API documentation file
-\o docs/api.md
+\o doc/api.md
 -- Generate the header for the documentation file
 SELECT '# sql_saga API Reference
 
@@ -166,10 +166,10 @@ FROM (
 \t
 \a
 -- A simple select to confirm the script ran
-SELECT 'API documentation generated in docs/api.md' AS result;
-                   result                   
---------------------------------------------
- API documentation generated in docs/api.md
+SELECT 'API documentation generated in doc/api.md' AS result;
+                  result                   
+-------------------------------------------
+ API documentation generated in doc/api.md
 (1 row)
 
 -- Check for any public functions that have not been assigned to a category

docs/decision-log.md doc/decision-log.mddocs/decision-log.md renamed to doc/decision-log.md

@@ -8,7 +8,7 @@
 \a
 
 -- Redirect output to the API documentation file
-\o docs/api.md
+\o doc/api.md
 
 -- Generate the header for the documentation file
 SELECT '# sql_saga API Reference
@@ -156,7 +156,7 @@ FROM (
 \a
 
 -- A simple select to confirm the script ran
-SELECT 'API documentation generated in docs/api.md' AS result;
+SELECT 'API documentation generated in doc/api.md' AS result;
 
 -- Check for any public functions that have not been assigned to a category
 SELECT 'Uncategorized API functions found. Please add them to a category in `sql/80_generate_api_docs.sql`:' AS " ",