Skip to content

Documentation

This directory contains user documentation for working with the Postman PyPNMApps API repository.

Documents

  • docs/postman-install.md - Postman Desktop download/install steps for Ubuntu and Windows.
  • docs/postman-import-and-navigation.md - Import Postman files, configure globals, and navigate collections.
  • docs/postman-collection-format.md - Format Postman collection JSON consistently on Windows/Linux.
  • docs/user-guide.md - End-user setup and Postman import/use instructions.
  • docs/tools.md - Local developer tooling (sanitize, bump_version, release, git-save, git-push).
  • docs/visual-workflow.md - Simple workflow for editing visuals and syncing Postman visualizer scripts.
  • docs/release.md - Versioning and release workflow (VERSION source of truth).
  • docs/visual/index.md - Generated visual examples catalog (from visual/).
  • docs/visual-mkdocs-plan.md - MkDocs visual catalog source-of-truth plan.

Quick Start

  1. Create the local Python virtual environment:
  2. ./install.sh (Windows command examples by default)
  3. ./install.sh --os-linux (Linux/macOS command examples)
  4. Activate the virtual environment:
  5. source .venv/bin/activate
  6. Run sanitization checks:
  7. tools/sanitize.py --check
  8. Review version state:
  9. cat VERSION
  10. Run tests:
  11. pytest -q
  12. Generate visual docs pages:
  13. tools/docs/build_visual_docs.py
  14. Serve docs locally:
  15. mkdocs serve -a 127.0.0.1:8030