AllenNeuralDynamics
diff --git a/‎.github/workflows/link-issues-by-milestone.yml‎
Lines changed: 56 additions & 0 deletions b/‎.github/workflows/link-issues-by-milestone.yml‎
Lines changed: 56 additions & 0 deletions
diff --git a/‎.github/workflows/run_dev_tests.yml‎
Lines changed: 0 additions & 1 deletion b/‎.github/workflows/run_dev_tests.yml‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎.github/workflows/run_main_tests.yml‎
Lines changed: 0 additions & 1 deletion b/‎.github/workflows/run_main_tests.yml‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎.github/workflows/update_dev_docs.yml‎
Lines changed: 34 additions & 0 deletions b/‎.github/workflows/update_dev_docs.yml‎
Lines changed: 34 additions & 0 deletions
diff --git a/‎.github/workflows/update_docs.yml‎
Lines changed: 0 additions & 1 deletion b/‎.github/workflows/update_docs.yml‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎CHANGELOG.md‎
Lines changed: 0 additions & 186 deletions b/‎CHANGELOG.md‎
Lines changed: 0 additions & 186 deletions
diff --git a/‎CONTRIBUTING.md‎
Lines changed: 3 additions & 1 deletion b/‎CONTRIBUTING.md‎
Lines changed: 3 additions & 1 deletion
diff --git a/‎docs/base/core/acquisition.md‎
Lines changed: 2 additions & 2 deletions b/‎docs/base/core/acquisition.md‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎docs/base/core/quality_control.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/base/core/quality_control.md‎
Lines changed: 1 addition & 1 deletion
@@ -0,0 +1,56 @@
+name: Link issue to cross-repo milestone parent
+
+on:
+  issues:
+    types: [milestoned]
+
+jobs:
+  link:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Link to parent issue in aind-scientific-computing
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.SERVICE_TOKEN }}
+          script: |
+            const issue = context.payload.issue;
+            const milestone = issue.milestone;
+
+            if (!milestone) return;
+
+            const targetOwner = "AllenNeuralDynamics";
+            const targetRepo = "aind-scientific-computing";
+
+            const url = milestone.description;
+            const match = url?.match(/\/issues\/(\d+)$/);
+
+            if (!match) {
+              console.log(`Milestone description is not a roadmap URL: ${url}`);
+              return;
+            }
+
+            const parentNumber = parseInt(match[1]);
+
+            const { data: parent } = await github.rest.issues.get({
+              owner: targetOwner,
+              repo: targetRepo,
+              issue_number: parentNumber
+            });
+
+            if (!parent) {
+              console.log(`No issue found at ${url}`);
+              return;
+            }
+
+            await github.request("POST /repos/{owner}/{repo}/issues/{issue_number}/sub_issues", {
+              owner: targetOwner,
+              repo: targetRepo,
+              issue_number: parentNumber,
+              sub_issue_id: issue.id,
+              headers: {
+                "X-GitHub-Api-Version": "2022-11-28"
+              }
+            });
+
+            console.log(`Linked issue #${issue.number} as sub-issue of ${targetRepo}#${parentNumber}`);
@@ -38,7 +38,6 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
-        sudo apt install graphviz libgraphviz-dev -y
         python -m pip install -e .[dev] -e .[docs] --no-cache-dir
     - name: Run tests and coverage
       run: coverage run -m unittest discover && coverage report
@@ -40,7 +40,6 @@ jobs:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
-        sudo apt install graphviz libgraphviz-dev -y
         python -m pip install -e .[dev] -e .[docs] --no-cache-dir
     - name: Run tests and coverage
       run: coverage run -m unittest discover && coverage report
 
@@ -0,0 +1,34 @@
+name: Update docs for dev PR
+
+on:
+  pull_request:
+    branches:
+      - dev
+
+jobs:
+  update_docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          token: ${{ secrets.SERVICE_TOKEN }}
+          ref: ${{ github.head_ref }}
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.10'
+      - name: Install dependencies
+        run: |
+          python -m pip install -e .[dev] -e .[docs] --no-cache-dir
+      - name: Generate docs
+        run: |
+          python src/aind_data_schema/utils/docs/model_generator.py
+          python src/aind_data_schema/utils/docs/registries_generator.py
+          python src/aind_data_schema/utils/docs/doc_generator.py
+          sphinx-build -b html docs/source/ docs/build/html
+      - name: Commit changes
+        uses: EndBug/add-and-commit@v9
+        with:
+          default_author: github_actions
+          message: "update docs"
+          add: '["docs"]'
@@ -60,7 +60,6 @@ jobs:
           python-version: '3.10'
       - name: Install dependencies
         run: |
-          sudo apt install graphviz libgraphviz-dev -y
           python -m pip install -e .[dev] -e .[docs] --no-cache-dir
       - name: Commit changes
         uses: EndBug/add-and-commit@v9
 
@@ -39,7 +39,9 @@ Starting with the v2.0 release all changes must be accompanied by an [upgrader](
 
 ### Documentation
 
-**Note**: The core files (`docs/source/acquisition.md`, etc) are auto-generated from the base files in the folder `docs/base/core` with the model definitions appended. You must modify the **base** file or your changes will be overwritten when you run the documentation generators.
+Documentation is automatically built when you open a PR into the aind-data-schema repository. For **core files, please make sure that you modify the base file**, these are used to construct the source files: i.e. `docs/base/core/acquisition.md` will over-write any changes made to `docs/source/acquisition.md`. 
+
+#### Manually build documentation
 
 To generate the source files for the documentation and model class links, run:
 
 
@@ -19,9 +19,9 @@ Because the start and stop times are independent for data streams and stimulus e
 
 ## Uniqueness
 
-You can uniquely identify acquisition sessions (and therefore a specific data asset) by their acquisition datetime (`Acquisition.acquisition_end_time`). In addition, the `Acquisition.acquisition_type` is an open `str` field where you can put conceptual information that groups similar acquisitions together. This should not be completely redundant with project names, modalities, stimulus names, or any other fields in the metadata.
+You can uniquely identify acquisition sessions (and therefore a specific data asset) by their acquisition datetime (`Acquisition.acquisition_start_time`). In addition, the `Acquisition.acquisition_type` is an open `str` field where you can put conceptual information that groups similar acquisitions together. This should not be completely redundant with project names, modalities, stimulus names, or any other fields in the metadata.
 
-For example, in the `"Brain Computer Interface"` project name, good acquisition types would be strings like: `"BCI: Single neuron stim"` and `"BCI: Group neuron stim"`. These phrases clearly identify what part of a project these acquisitions belong to, without being overly redundant with controlled fields in the metadata.
+For example, in the `"Brain Computer Interface"` project name, good acquisition types would be strings like: `"Single neuron stim"` and `"Group neuron stim"`. These phrases clearly identify what part of a project these acquisitions belong to, without being overly redundant with controlled fields in the metadata.
 
 ## Stimulus parameters
 
 
@@ -26,7 +26,7 @@ If you find yourself computing a value for something smaller than an entire moda
 
 `tags` are groups of descriptors that define how metrics are organized hierarchically, making it easier to visualize metrics. Good tag keys (groups) are things like "probe" and good tag values are things like "Probe A" or just "A".
 
-```{python}
+```python
 # For an electrophysiology metric
 tags = {
     "probe": "A",