From 32cf48122ff912f2620e3c38dbb0f55566fc797d Mon Sep 17 00:00:00 2001 From: Chris McCormick Date: Tue, 26 Nov 2019 15:32:08 +0800 Subject: [PATCH 1/3] First pass at contributor docs. --- README.md | 17 +++++++++++++++-- docs/CONTRIBUTING.md | 9 +++++++++ 2 files changed, 24 insertions(+), 2 deletions(-) create mode 100644 docs/CONTRIBUTING.md diff --git a/README.md b/README.md index 343898a..f233acb 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,23 @@ The tiniest Heroku/CloudFoundry-like PaaS you've ever seen. ## Goals and Motivation -(New text being summarized and drafted in #134, soon to find its way here) - I kept finding myself wanting an Heroku/CloudFoundry-like way to deploy stuff on a few remote ARM boards and [my Raspberry Pi cluster][raspi-cluster], but since [dokku][dokku] didn't work on ARM at the time and even `docker` can be overkill sometimes, I decided to roll my own. +### Core values + + * Runs on low end devices. + * Accessible to hobbyists and K-12 schools. + * ~1000 lines readable code. + * Functional code style. + * Few (single?) dependencies. + * [12 factor app](https://12factor.net). + * Simplify user experience. + * Cover 80% of common use cases. + * Sensible defaults. + * Leverage distro packages. + * Leverage standard tooling (git, ssh, uwsgi). + * Preserve backwards compatibility where possible. + ## Using `piku` `piku` supports a Heroku-like workflow, like so: diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md new file mode 100644 index 0000000..685f2dc --- /dev/null +++ b/docs/CONTRIBUTING.md @@ -0,0 +1,9 @@ +We welcome contributions! + +### Guidelines + + * Small and focused PRs. Please don't include changes that don't address the subject of your PR. + * Follow the style of importing functions directly e.g. `from os.path import abspath`. + * Check out the [core values of Piku](../README.md#guidelines). + * PEP8. + From c508239976795f5ee1b5b7f61eef2515edfa1cbc Mon Sep 17 00:00:00 2001 From: Chris McCormick Date: Tue, 26 Nov 2019 15:36:04 +0800 Subject: [PATCH 2/3] Update quick links. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f233acb..7140ee5 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ The tiniest Heroku/CloudFoundry-like PaaS you've ever seen. [![asciicast](https://asciinema.org/a/Ar31IoTkzsZmWWvlJll6p7haS.svg)](https://asciinema.org/a/Ar31IoTkzsZmWWvlJll6p7haS) -### Documentation: [Procfile](docs/DESIGN.md#procfile-format) | [ENV](./docs/ENV.md) | [Examples](./examples/README.md) | [Roadmap](https://github.com/piku/piku/projects/2) +### Documentation: [Using](#using-piku) | [Install](#install) | [Procfile](docs/DESIGN.md#procfile-format) | [ENV](./docs/ENV.md) | [Examples](./examples/README.md) | [Roadmap](https://github.com/piku/piku/projects/2) | [Contributing](./docs/CONTRIBUTING.md) ## Goals and Motivation From 08a507dd838b24c78364ac7f7d61d39c602d13a0 Mon Sep 17 00:00:00 2001 From: Chris McCormick Date: Tue, 26 Nov 2019 15:38:17 +0800 Subject: [PATCH 3/3] Fixed anchor link. --- docs/CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 685f2dc..1bb3ada 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -4,6 +4,6 @@ We welcome contributions! * Small and focused PRs. Please don't include changes that don't address the subject of your PR. * Follow the style of importing functions directly e.g. `from os.path import abspath`. - * Check out the [core values of Piku](../README.md#guidelines). + * Check out the [core values of Piku](../README.md#core-values). * PEP8.