Skip to content

docs: overhaul module guides and remove temporary markdownlintignore#82

Open
asim29 wants to merge 1 commit intopr/5-examplesfrom
pr/6-docs
Open

docs: overhaul module guides and remove temporary markdownlintignore#82
asim29 wants to merge 1 commit intopr/5-examplesfrom
pr/6-docs

Conversation

@asim29
Copy link
Copy Markdown
Collaborator

@asim29 asim29 commented Apr 21, 2026

Context

Final PR in the refactor/risk-modules stack. Stacked on #81 (examples). Purely documentation — no source code changes.

Changes

docs/module_guide/ (all nine guides updated)

  • Reflect new attack/defense APIs throughout: poison_train/poison_test split, prepare_model_populations lifecycle for distribution inference, load_or_train pattern in examples.
  • AmuletDataset schema (modality, sensitive_columns) documented.
  • Code snippets updated to match current class signatures.

docs/CONTRIBUTING.md

  • Updated contribution guide to cover new ABC base class pattern and lifecycle conventions.

docs/GETTING_STARTED.md

  • Refreshed quickstart to match the new get_started.py script.

.markdownlintignore (deleted)

  • Was added in PR 1 as a scoping workaround to defer doc fixes. All docs now pass markdownlint cleanly, so the ignore file is removed.

Test plan

  • uv run pre-commit run --all-files (markdownlint passes without the ignore file)
  • CI passes on this branch
  • Spot-check that code snippets in module guides match the current source

All nine module-guide docs updated to reflect the new attack/defense
API (poison_train/poison_test split, prepare_model_populations lifecycle,
load_or_train pattern, AmuletDataset schema). CONTRIBUTING.md and
GETTING_STARTED.md refreshed accordingly. Removes .markdownlintignore,
which was added in PR 1 as a scoping workaround; docs now pass
markdownlint cleanly.
@asim29 asim29 self-assigned this Apr 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant