exploded
diff --git a/‎docs/README.md‎
Lines changed: 0 additions & 504 deletions b/‎docs/README.md‎
Lines changed: 0 additions & 504 deletions
diff --git a/‎docs/guides/development.md‎
Lines changed: 67 additions & 0 deletions b/‎docs/guides/development.md‎
Lines changed: 67 additions & 0 deletions
diff --git a/‎docs/privacy.md‎ ‎docs/guides/privacy.md‎docs/privacy.md renamed to docs/guides/privacy.md b/‎docs/privacy.md‎ ‎docs/guides/privacy.md‎docs/privacy.md renamed to docs/guides/privacy.md
diff --git a/‎docs/alter_table.md‎ ‎docs/howto/alter_table.md‎docs/alter_table.md renamed to docs/howto/alter_table.md b/‎docs/alter_table.md‎ ‎docs/howto/alter_table.md‎docs/alter_table.md renamed to docs/howto/alter_table.md
diff --git a/‎docs/annotations.md‎ ‎docs/howto/annotations.md‎docs/annotations.md renamed to docs/howto/annotations.md b/‎docs/annotations.md‎ ‎docs/howto/annotations.md‎docs/annotations.md renamed to docs/howto/annotations.md
diff --git a/‎docs/any.md‎ ‎docs/howto/any.md‎docs/any.md renamed to docs/howto/any.md b/‎docs/any.md‎ ‎docs/howto/any.md‎docs/any.md renamed to docs/howto/any.md
diff --git a/‎docs/arrays.md‎ ‎docs/howto/arrays.md‎docs/arrays.md renamed to docs/howto/arrays.md b/‎docs/arrays.md‎ ‎docs/howto/arrays.md‎docs/arrays.md renamed to docs/howto/arrays.md
diff --git a/‎docs/delete.md‎ ‎docs/howto/delete.md‎docs/delete.md renamed to docs/howto/delete.md b/‎docs/delete.md‎ ‎docs/howto/delete.md‎docs/delete.md renamed to docs/howto/delete.md
diff --git a/‎docs/enums.md‎ ‎docs/howto/enums.md‎docs/enums.md renamed to docs/howto/enums.md b/‎docs/enums.md‎ ‎docs/howto/enums.md‎docs/enums.md renamed to docs/howto/enums.md
diff --git a/‎docs/insert.md‎ ‎docs/howto/insert.md‎docs/insert.md renamed to docs/howto/insert.md b/‎docs/insert.md‎ ‎docs/howto/insert.md‎docs/insert.md renamed to docs/howto/insert.md
@@ -0,0 +1,67 @@
+# Developing sqlc
+
+## Building
+
+For local development, install `sqlc` under an alias. We suggest `sqlc-dev`.
+
+```
+go build -o ~/go/bin/sqlc-dev ./cmd/sqlc
+```
+
+## Running Tests
+
+```
+go test ./...
+```
+
+To run the tests in the examples folder, use the `examples` tag.
+
+```
+go test --tags=examples ./...
+```
+
+These tests require locally-running database instances. Run these databases
+using [Docker Compose](https://docs.docker.com/compose/).
+
+```
+docker-compose up -d
+```
+
+The tests use the following environment variables to connect to the
+database
+
+### For PostgreSQL
+
+```
+Variable     Default Value
+-------------------------
+PG_HOST      127.0.0.1
+PG_PORT      5432
+PG_USER      postgres
+PG_PASSWORD  mysecretpassword
+PG_DATABASE  dinotest
+```
+
+### For MySQL
+
+```
+Variable     Default Value
+-------------------------
+MYSQL_HOST      127.0.0.1
+MYSQL_PORT      3306
+MYSQL_USER      root
+MYSQL_ROOT_PASSWORD  mysecretpassword
+MYSQL_DATABASE  dinotest
+```
+
+## Regenerate expected test output
+
+If you need to update a large number of expected test output in the
+`internal/endtoend/testdata` directory, run the `regenerate.sh` script.
+
+```
+make regen
+```
+
+Note that this uses the `sqlc-dev` binary, not `sqlc` so make sure you have an
+up to date `sqlc-dev` binary.