NINA Astrophotography Automation
This repository contains the current proof-of-concept work for automating NINA-based astrophotography workflows.
Project Layout
- nina-hosts/README.md - Infrastructure-as-code for machines that run NINA
- nina-hosts/aws/README.md - Build and run the Windows AWS staging environment with NINA and the API plugin
- guide/README.md - Narrative documentation, research, and background material
- agent-context/README.md - Shareable agent memory for engineering and project context
Documentation Approach
Documentation is structured to work well both on GitHub and in mdBook:
- the book starts at this file
- code-related documentation lives next to the code it describes
- narrative-only chapters live under
guide/withREADME.mdas the entry point - shareable agent memory also lives in the repo and is included in the book under
agent-context/
Documentation Deployment
Build publishable documentation with scripts/build-docs.sh, not raw mdbook build.
The repository keeps Markdown close to the code it documents, while the build script creates a temporary mdBook source tree from SUMMARY.md. This avoids publishing unrelated repository files such as secrets, infrastructure state, local environment files, and CI configuration.
scripts/build-docs.sh latest main
scripts/build-docs.sh release hagen-web-v0.5.0
The generated artifact is checked by scripts/check-book-artifact.sh before deployment.
Current Status
- NINA host infrastructure exists in
nina-hosts/ - Research and implementation notes live in
guide/