lighter dependencies in devtools

.github/workflows/codeql.yaml

@@ -23,7 +23,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        language: [ "javascript-typescript", "python" ]
+        language: [ "python" ]
     steps:
     - uses: actions/checkout@v5
       with:

mkdocs.yaml

@@ -2,6 +2,7 @@ site_name: rats
 repo_url: "https://github.com/microsoft/rats"
 repo_name: "rats"
 docs_dir: "docs"
+site_dir: "rats-devtools/dist/site"
 theme:
   name: material
   logo: images/logo.png

rats-apps/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "rats-apps"
 description = "research analysis tools for building applications"
-version = "0.14.2"
+version = "0.15.0"
 readme = "README.md"
 requires-python = ">=3.10,<4.0"
 authors = [

rats-devtools/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "rats-devtools"
 description = "Rats Development Tools"
-version = "0.14.2"
+version = "0.15.0"
 readme = "README.md"
 requires-python = ">=3.10,<4.0"
 authors = [
@@ -15,19 +15,9 @@ dependencies = [
     "rats-apps",
     "click",
     "toml",
-    "twine",
     # workflowing
     "azure-ai-ml",
     "azure-identity",
-    # documentation tooling
-    "mkdocs",
-    "mkdocs-awesome-pages-plugin",
-    "mkdocs-material",
-    "mkdocs-video",
-    "mkdocs-glightbox",
-    "mdx-truly-sane-lists",
-    "mkdocstrings",
-    "mkdocstrings-python",
 ]
 
 [project.urls]
@@ -43,6 +33,15 @@ dev = [
     "pytest-nunit",
     "setuptools",
     "ruff",
+    # documentation tooling
+    "mkdocs",
+    "mkdocs-awesome-pages-plugin",
+    "mkdocs-material",
+    "mkdocs-video",
+    "mkdocs-glightbox",
+    "mdx-truly-sane-lists",
+    "mkdocstrings",
+    "mkdocstrings-python",
 ]
 
 [build-system]

rats-devtools/src/rats/docs/__init__.py

@@ -13,11 +13,26 @@
 accomplish this as a small command proxy that inserts default arguments to the underlying `mkdocs`
 command.
 
-!!! note
-    Previously, this module would copy original markdown files, and symlink directories during the
-    build process to unify the docs across components. However, over time, we've found solutions
-    that eliminate these custom operations, making the `rats-docs` commands much simpler, and
-    making it easy to get the same output when using `mkdocs` commands directly.
+## Dependencies
+
+We don't define the `mkdocs` dependencies as part of our library because we expect you to choose
+them based on your configured `mkdocs.yaml` file. This means that the `rats-docs` commands will
+fail until you've added the needed dependencies to your `pyproject.toml`. If using a tool like
+`uv`, they might look something like the ones below:
+
+```toml
+[dependency-groups]
+dev = [
+    "mkdocs",
+    "mkdocs-awesome-pages-plugin",
+    "mkdocs-material",
+    "mkdocs-video",
+    "mkdocs-glightbox",
+    "mdx-truly-sane-lists",
+    "mkdocstrings",
+    "mkdocstrings-python",
+]
+```
 
 ## Structure
 

rats/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "rats"
 description = "bundled research analysis tools"
-version = "0.14.2"
+version = "0.15.0"
 readme = "README.md"
 requires-python = ">=3.10,<4.0"
 authors = [