Skip to content

Latest commit

 

History

History
35 lines (17 loc) · 1.73 KB

README.md

File metadata and controls

35 lines (17 loc) · 1.73 KB

Here-Be-Pythons!

Documentation Status

Here-Be-Pythons!™ holds opinionated best practices & ideas to help you build your next Python project.

The goal is to gather the sweetest & most impactful nuggets of wisdom relating to Python ventures and make them accessible from a single place. Because a little investment in automation and knowledge makes your snake-projects fly, following the famous equation: 🐍 + 💚 = 🚀

Hopefully, Here-Be-Pythons! will inspire you to code your awesome projects faster and to make them even better.

Ahoy, Captain! Thar’s opinions ahead!

The content of this repo is based on the research, experience, but also pure opinions of the authors. And opinions do differ!

Still, we are more than happy to hear your feedback. All for the glory of this repo and to grow as programmers ⚔️

The Content

You may find Here-Be-Pythons! content graciously hosted on Read the Docs.

Contribution Guide

  • After cloning the repo, install dev dependencies by calling pipenv install --dev.

  • There are two Invoke tasks that are helpful during development:

    • docs.build - build Sphinx HTML docs and save them in $PROJECT_ROOT/docs/build/html/.

    • docs.develop - build Sphinx HTML docs and open them in the browser with hot reloading.

  • Once you are good-to-go, propose your changes via a Pull Request.

    • Before you make a PR, remember to build the docs and manually review if Here-Be-Pythons! still renders correctly!