From 5af7dc8d208ed7f6fc61fef13b81d636e6e0dfcd Mon Sep 17 00:00:00 2001
From: Bryan Newbold <bnewbold@robocracy.org>
Date: Wed, 9 May 2018 11:12:04 -0700
Subject: README updates

---
 notes/golang.txt | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

(limited to 'notes')

diff --git a/notes/golang.txt b/notes/golang.txt
index 090a5942..0730f409 100644
--- a/notes/golang.txt
+++ b/notes/golang.txt
@@ -1,8 +1,9 @@
 
+## Database Schema / ORM / Generation
+
 - pq: basic postgres driver and ORM (similar to sqlalchemy?)
 - sqlx: small extensions to builtin sql; row to struct mapping
 
-
 code generation from SQL schema:
 - https://github.com/xo/xo
 - https://github.com/volatiletech/sqlboiler
@@ -20,6 +21,17 @@ for auth, start with oauth2... orcid?
 
 debug postgres with gocmdpev
 
+## OpenAPI/Swagger
+
+go-swagger (OpenAPI 2.0):
+- generate initial API server skeleton from a yaml definition
+- export updated yaml from code after changes
+- web UI for documentation
+- templating/references
+- auto-generate client (in golang)
+
+also look at ReDoc as a UI; all in-brower generated from JSON (react)
+
 ## Non-API stuff
 
 - logrus structured logging (or zap?)
-- 
cgit v1.2.3