Updated README with book overview and build instructions

Author: michael-borck

README.md

@@ -1,2 +1,69 @@
-# python-dev-book
-A comprehensive guide to Python development practices from zero to production.
+# From Zero to Production: A Practical Python Development Pipeline
+
+This repository contains the source for the book "From Zero to Production: A Practical Python Development Pipeline" - a comprehensive guide to professional Python development practices.
+
+## About the Book
+
+Modern Python development demands more than just writing functional code. This book presents a complete development pipeline that balances simplicity with professional practices, helping developers at all levels build maintainable, production-ready Python projects.
+
+### Key Topics
+
+- Setting up proper project structure and version control
+- Managing dependencies effectively
+- Using code quality tools (linting, formatting, static analysis)
+- Implementing testing strategies with pytest
+- Adding type checking to Python projects
+- Creating effective documentation
+- Implementing CI/CD pipelines
+- Packaging and distribution
+
+The book follows a "crawl-walk-run" approach, starting with essential practices and progressively introducing more advanced techniques.
+
+## Book Website
+
+The rendered book is available at: https://book-repositories.github.io/python-dev-book/
+
+## Related Resources
+
+- **Case Study Repository**: The book includes a case study building "SimpleBot". The complete implementation can be found at [simplebot-repo-url].
+
+## Building the Book Locally
+
+This book is built using [Quarto](https://quarto.org/), a scientific and technical publishing system.
+
+### Prerequisites
+
+- Install [Quarto](https://quarto.org/docs/get-started/)
+- (Optional) Install [TinyTeX](https://quarto.org/docs/output-formats/pdf-basics.html) for PDF rendering
+
+### Commands
+
+```bash
+# Preview the book with live reloading
+quarto preview
+
+# Render the book to HTML, PDF, and EPUB
+quarto render
+
+# Publish to GitHub Pages
+quarto publish gh-pages
+```
+
+## Contributing
+
+While this book is primarily maintained by Michael Borck, suggestions and corrections are welcome:
+
+1. File an issue describing the problem or enhancement
+2. For minor corrections, feel free to submit a pull request
+
+## License
+
+The content of this book is licensed under [license details here], which means you are free to [permissions based on your chosen license].
+
+## About the Author
+
+Michael Borck is [brief bio or link to personal site].
+
+## Acknowledgments
+
+- [Any people or organizations you'd like to thank]