docs: finish Package Management section

Author: softwareentrepreneer

afterpython/cli/main.py

@@ -50,6 +50,7 @@ def afterpython_group(ctx):
 afterpython_group.add_command(dev)
 afterpython_group.add_command(update)
 afterpython_group.add_command(check)
+afterpython_group.add_command(check, name="lint")
 afterpython_group.add_command(format)
 afterpython_group.add_command(sync)
 afterpython_group.add_command(start)

afterpython/doc/myst.md

@@ -29,6 +29,11 @@ This section serves as a quick guide to MyST. Quotes below are sourced from the
 ## Jupyter Notebook
 The [MyST Document Engine][MyST Overview] can parse [Jupyter Notebook]s and render them as HTML. This means you can write content in both MyST Markdown and Jupyter Notebooks—`afterpython` will organize and render them together as part of your project website.
 
+### Notebook Cell Tags
+You can add tags to notebook cells to control their behavior. For example, you can add the `hide-input` tag to a cell to hide the input of the cell.
+
+*See [Notebook Cell Tags](https://mystmd.org/guide/notebook-configuration#tbl-notebook-cell-tags) for more details.*
+
 ### Molab Badge
 
 If the [environment variable](references/environment_variables.md) `AP_MOLAB_BADGE` is set to `1`, `afterpython` automatically adds [molab] badges to Jupyter Notebooks during the build process.
@@ -88,3 +93,12 @@ authors:
 :::{tip}
 This entire documentation is written in MyST Markdown. You can click the "Edit this page" button in the top right corner to see the source code as an example of how to write content in MyST Markdown.
 :::
+
+
+---
+## Synchronization
+`ap sync` copies corresponding values from `pyproject.toml` and `afterpython.toml` into `authors.yml` and `myst.yml`.
+
+For example, after updating authors in `pyproject.toml`, run `ap sync` to update `authors.yml` and your `myst.yml` files automatically.
+
+You can also change `[company.name]` in `afterpython.toml` and run `ap sync` to update `venue.title` (set to the company name) in your `myst.yml` files.

afterpython/doc/myst.yml

@@ -41,6 +41,7 @@ project:
   - title: Package Maintenance
     children:
     - file: package_maintenance/package_management.md
+    - file: package_maintenance/release_management.md
     - file: package_maintenance/ci_cd.md
   - title: References
     children:

afterpython/doc/package_maintenance/ci_cd.md

@@ -1,3 +1,5 @@
+[pre-commit]: https://github.com/pre-commit/pre-commit
+
 # CI/CD Pipelines
 
 ## `pre-commit`
@@ -7,6 +9,4 @@
 
 ## GitHub Actions
 
-## GitHub Dependabots
-
-## PyPI and GitHub Releases
+## GitHub Dependabots 🚧

afterpython/doc/package_maintenance/package_management.md

@@ -1,23 +1,51 @@
-# Package Management
+[uv]: https://github.com/astral-sh/uv
+[poetry]: https://github.com/python-poetry/poetry
+[pdm]: https://github.com/pdm-project/pdm
+[ruff]: https://github.com/astral-sh/ruff
+[pixi]: https://github.com/prefix-dev/pixi
 
-## Integrations
-- uv
-- ruff
-- pre-commit
+# Package Management
 
 ## Dependency Management
-- uv
-- pcu
+`afterpython` doesn’t manage your dependencies or lock you into a tool. Choose what you prefer:
+- [uv] (what `afterpython`’s wrapper commands call)
+- [pdm]
+- [poetry]
+
+Example wrapper:
+- `ap install` runs `uv sync --all-extras --all-groups`.
+
+
+---
+## Linting and Formatting
+`afterpython` uses [ruff] for linting and formatting, configured in `afterpython/ruff.toml`.
+
+Example wrapper:
+- `ap check` (alias: `ap lint`) runs `ruff check --config ./afterpython/ruff.toml`.
+
+Or you can just directly use `ruff` command as usual since it will automatically find the config file in `afterpython/ruff.toml`.
+
+
+---
+## Python Check Updates (`pcu`)
+As a package maintainer, you face a dilemma: your dependencies (e.g. `pandas`) release new versions with bug fixes and features, but updating the minimum versions (e.g. `pandas>=2.0.0`) in your `pyproject.toml` means dropping support for users with older versions.
+
+This is why minimum version updates are usually done manually—it's up to the package maintainer to decide when to require newer dependency versions.
+
+`pcu` (similar to `ncu` in Node.js) helps automate this process:
+- `pcu` shows the latest available versions of your dependencies
+- `pcu -u` updates the minimum versions in your `pyproject.toml`
+- `pcu -u --all` also updates the versions in your `.pre-commit-config.yaml`
+
 
-## Release Management
-- `ap bump`
-- `ap publish`
-- `ap release`
+You can also run `ap update deps` (`pcu` is an alias for this) to achieve the same effect.
 
 
-## pixi
+:::{warning}
+Only update minimum versions when you have a good reason—such as needing bug fixes, new features, or addressing breaking changes you've adapted to. Otherwise, you're forcing users to upgrade their environments unnecessarily, creating installation barriers without providing any actual benefits.
+:::
 
 
-```{seealso}
-See Also:
-```
+---
+## pixi 🚧
+[pixi] manages both your package dependencies and your environment. For example, if your project installs `pyspark` and you need to lock Java to version 17, `pixi` handles that for you.

afterpython/doc/package_maintenance/release_management.md

@@ -0,0 +1,11 @@
+# Release Management
+
+- `ap commit`
+- `ap pc` / `ap pre-commit`
+- `ap cz` / `ap commitizen`
+- `ap bump`
+- `ap publish`
+- `ap release`
+
+
+## PyPI and GitHub Releases

afterpython/doc/references/roadmap.md

@@ -8,6 +8,7 @@ This roadmap is tentative and subject to change
 - AI chatbot like kapa.ai using WebLLM
 - full-text search engine using pagefind
 - incremental build, only build changed content (for `ap dev`)
+- github dependabots
 - integrate with `git-cliff` for changelog generation
 - integrate with `pixi`, supports `conda install`
 - supports docs built by different engines? e.g. Sphix, MkDocs

pyproject.toml

@@ -82,6 +82,8 @@ source-exclude = [
     "afterpython/static",
     "afterpython/_website",
     "afterpython/_build",
+    "afterpython/cz.toml",
+    "afterpython/.pre-commit-config.yaml",
     "afterpython/ruff.toml",
     "afterpython/afterpython.toml",
     "afterpython/authors.yml",
@@ -96,6 +98,8 @@ wheel-exclude = [
     "afterpython/static",
     "afterpython/_website",
     "afterpython/_build",
+    "afterpython/cz.toml",
+    "afterpython/.pre-commit-config.yaml",
     "afterpython/ruff.toml",
     "afterpython/afterpython.toml",
     "afterpython/authors.yml",