Add README and update Makefile

Author: nkantar

Makefile

@@ -1,12 +1,9 @@
 .DEFAULT_GOAL := help
-.PHONY: help install html css build serve netlify
+.PHONY: help html css build serve netlify
 
 help: ## this help dialog
 	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
 
-install: ## install all dependencies, including Poetry
-	python3 -m pip install poetry && poetry env use 3 && poetry install
-
 html: ## build HTML with corvid
 	poetry run corvid
 
@@ -17,7 +14,7 @@ build: ## build site in output/
 	make html && make css
 
 serve: ## serve site from output/
-	poetry run python -m http.server 8000 -d output
+	poetry run python -m http.server 8765 -d output
 
 netlify: ## publish on Netlify
-	make install && make build
+	python3 -m pip install poetry && poetry env use 3 && poetry install && make build

README.md

@@ -0,0 +1,45 @@
+# SoCalPython.org
+
+
+This is the source repo for [SoCalPython.org], the official SoCal Python website. 🐍
+
+It's built using [corvid] and below instructions rely on [Poetry].
+
+
+## Setup
+
+1. Install [Poetry]
+2. Run `poetry install`
+
+
+## Developing
+
+1. Run `make serve` in a terminal window continuously
+2. Go to [http://localhost:8765]
+3. Make changes
+4. Run `make build` in another terminal window
+5. Refresh to see changes
+6. Repeat steps 3, 4, and 5 as needed
+
+
+## Infrastructure
+
+The site is deployed on [Netlify] from the `main` branch of this repository.
+The domain is registered by [@nkantar] through [Hover], and SSL is provided by [Let's Encrypt].
+
+
+## Code of Conduct
+
+The SoCal Python community has a [Code of Conduct], which covers contributing to this codebase as well as participating in the community in any way.
+Doing so implies you agree to abide by its terms.
+
+
+[SoCalPython.org]: https://socalpython.org/ "SoCalPython.org | The official site of the Los Angeles Python programming language community."
+[corvid]: https://github.com/di/corvid/ "GitHub - di/corvid: An opinionated simple static site generator"
+[Poetry]: https://python-poetry.org/ "Poetry - Python dependency management and packaging made easy"
+[http://localhost:8765]: http://localhost:8765
+[Netlify]: https://netlify.com "Netlify: Develop & deploy the best web experiences in record time"
+[@nkantar]: https://github.com/nkantar "nkantar (Nik Kantar) · GitHub"
+[Hover]: https://hover.com "Domain Names | Buy Domains & Email At Hover.com"
+[Let's Encrypt]: https://letsencrypt.org/ " Let's Encrypt"
+[Code of Conduct]: https://socalpython.org/conduct/ "SoCalPython.org | Code of Conduct"