docs: Restructure to developer-focused documentation

- Update index.md to point users to docs.datajoint.com
- Create architecture/ section with transpilation docs
- Archive user-facing content (now in datajoint-docs)
- Simplify mkdocs.yaml for developer documentation
- Update docstring style to numpy in mkdocs config

User documentation is now at docs.datajoint.com.
This site focuses on contributing, architecture, and API reference.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: dimitri-yatsenko

DOCSTRING_STYLE.md

@@ -1,82 +1,17 @@
 # ---------------------- PROJECT SPECIFIC ---------------------------
 
-site_name: DataJoint Documentation
+site_name: DataJoint Python - Developer Documentation
+site_description: Developer documentation for DataJoint Python contributors
 repo_url: https://github.com/datajoint/datajoint-python
 repo_name: datajoint/datajoint-python
 nav:
-  - DataJoint Python: index.md
-  - Quick Start Guide: quick-start.md
-  - Concepts:
-    - Principles: concepts/principles.md
-    - Data Model: concepts/data-model.md
-    - Data Pipelines: concepts/data-pipelines.md
-    - Teamwork: concepts/teamwork.md
-    - Terminology: concepts/terminology.md
-  - System Administration:
-    - Database Administration: sysadmin/database-admin.md
-    - Bulk Storage Systems: sysadmin/bulk-storage.md
-    - External Store: sysadmin/external-store.md
-  - Client Configuration:
-    - Install: client/install.md
-    - Credentials: client/credentials.md
-    - Settings: client/settings.md
-    - File Stores: client/stores.md
-  - Schema Design:
-    - Schema Creation: design/schema.md
-    - Table Definition:
-      - Table Tiers: design/tables/tiers.md
-      - Declaration Syntax: design/tables/declare.md
-      - Primary Key: design/tables/primary.md
-      - Attributes: design/tables/attributes.md
-      - Lookup Tables: design/tables/lookup.md
-      - Manual Tables: design/tables/manual.md
-      - Blobs: design/tables/blobs.md
-      - Attachments: design/tables/attach.md
-      - Filepaths: design/tables/filepath.md
-      - Custom Codecs: design/tables/codecs.md
-      - Dependencies: design/tables/dependencies.md
-      - Indexes: design/tables/indexes.md
-      - Master-Part Relationships: design/tables/master-part.md
-    - Schema Diagrams: design/diagrams.md
-    - Entity Normalization: design/normalization.md
-    - Data Integrity: design/integrity.md
-    - Schema Recall: design/recall.md
-    - Schema Drop: design/drop.md
-    - Schema Modification: design/alter.md
-  - Data Manipulations:
-    - manipulation/index.md
-    - Insert: manipulation/insert.md
-    - Delete: manipulation/delete.md
-    - Update: manipulation/update.md
-    - Transactions: manipulation/transactions.md
-  - Data Queries:
-    - Principles: query/principles.md
-    - Example Schema: query/example-schema.md
-    - Fetch: query/fetch.md
-    - Iteration: query/iteration.md
-    - Operators: query/operators.md
-    - Restrict: query/restrict.md
-    - Projection: query/project.md
-    - Join: query/join.md
-    - Aggregation: query/aggregation.md
-    - Union: query/union.md
-    - Universal Sets: query/universals.md
-    - Query Caching: query/query-caching.md
-  - Computations:
-    - Make Method: compute/make.md
-    - Populate: compute/populate.md
-    - Key Source: compute/key-source.md
-    - Distributed Computing: compute/distributed.md
-  - Publish Data: publish-data.md
-  - Internals:
-    - SQL Transpilation: internal/transpilation.md
-  - Tutorials:
-      - JSON Datatype: tutorials/json.ipynb
-  - FAQ: faq.md
-  - Developer Guide: develop.md
-  - Citation: citation.md
+  - Home: index.md
+  - Contributing: develop.md
+  - Architecture:
+    - architecture/index.md
+    - SQL Transpilation: architecture/transpilation.md
   - Changelog: changelog.md
-  - API: api/ # defer to gen-files + literate-nav
+  - API Reference: api/ # defer to gen-files + literate-nav
 
 # ---------------------------- STANDARD -----------------------------
 
@@ -93,7 +28,7 @@ theme:
   favicon: assets/images/company-logo-blue.png
   features:
     - toc.integrate
-    - content.code.annotate # Add codeblock annotations
+    - content.code.annotate
   palette:
     - media: "(prefers-color-scheme: light)"
       scheme: datajoint
@@ -113,26 +48,18 @@ plugins:
       handlers:
         python:
           paths:
-            - "."
-            - /main/
+            - "../src"
           options:
-            filters:
-              - "!^_"
-            docstring_style: sphinx # Replaces google default pending docstring updates
+            docstring_style: numpy
             members_order: source
             group_by_category: false
             line_length: 88
+            show_source: false
   - gen-files:
       scripts:
         - ./src/api/make_pages.py
   - literate-nav:
       nav_file: navigation.md
-  - exclude-search:
-      exclude:
-        - "*/navigation.md"
-        - "*/archive/*md"
-  - mkdocs-jupyter:
-      include: ["*.ipynb"]
   - section-index
 markdown_extensions:
   - attr_list
@@ -154,41 +81,23 @@ markdown_extensions:
         - name: mermaid
           class: mermaid
           format: !!python/name:pymdownx.superfences.fence_code_format
-  - pymdownx.magiclink # Displays bare URLs as links
-  - pymdownx.tasklist: # Renders check boxes in tasks lists
+  - pymdownx.magiclink
+  - pymdownx.tasklist:
       custom_checkbox: true
   - md_in_html
 extra:
-  generator: false # Disable watermark
+  generator: false
   version:
     provider: mike
   social:
     - icon: main/company-logo
       link: https://www.datajoint.com
       name: DataJoint
-    - icon: fontawesome/brands/slack
-      link: https://datajoint.slack.com
-      name: Slack
-    - icon: fontawesome/brands/linkedin
-      link: https://www.linkedin.com/company/datajoint
-      name: LinkedIn
-    - icon: fontawesome/brands/twitter
-      link: https://twitter.com/datajoint
-      name: Twitter
     - icon: fontawesome/brands/github
       link: https://github.com/datajoint
       name: GitHub
-    - icon: fontawesome/brands/docker
-      link: https://hub.docker.com/u/datajoint
-      name: DockerHub
-    - icon: fontawesome/brands/python
-      link: https://pypi.org/user/datajointbot
-      name: PyPI
-    - icon: fontawesome/brands/stack-overflow
-      link: https://stackoverflow.com/questions/tagged/datajoint
-      name: StackOverflow
-    - icon: fontawesome/brands/youtube
-      link: https://www.youtube.com/channel/UCdeCuFOTCXlVMRzh6Wk-lGg
-      name: YouTube
+    - icon: fontawesome/brands/slack
+      link: https://datajoint.slack.com
+      name: Slack
 extra_css:
   - assets/stylesheets/extra.css