docs

site/using/go.md

@@ -1,5 +1,7 @@
 # Using `sqlite-vec` in Go
 
+[![Go Reference](https://pkg.go.dev/badge/github.com/asg017/sqlite-vec-go-bindings/cgo.svg)](https://pkg.go.dev/github.com/asg017/sqlite-vec-go-bindings/cgo) [![Go Reference](https://pkg.go.dev/badge/github.com/asg017/sqlite-vec-go-bindings/ncruces.svg)](https://pkg.go.dev/github.com/asg017/sqlite-vec-go-bindings/ncruces)
+
 There are two ways you can embed `sqlite-vec` into Go applications: a CGO option
 for libraries like
 [`github.com/mattn/go-sqlite3`](https://github.com/mattn/go-sqlite3), or a
@@ -8,14 +10,87 @@ WASM-based option with
 
 ## Option 1: CGO
 
+If using [`github.com/mattn/go-sqlite3`](https://github.com/mattn/go-sqlite3) or another CGO-based SQLite library, then use the `github.com/asg017/sqlite-vec-go-bindings/cgo` module to embed `sqlite-vec` into your Go application.
+
 ```bash
-go get -u github.com/asg017/sqlite-vec/bindings/go/cgo
+go get -u github.com/asg017/sqlite-vec-go-bindings/cgo
+```
+
+This will compile and statically link `sqlite-vec` into your project. The initial build will be slow, but later builds will be cached and much faster.
+
+Use `sqlite_vec.Auto()` to enable `sqlite-vec` functions in all future database connections. Also `sqlite_vec.Cancel()` is available to undo `Auto()`.
+
+```go
+package main
+
+import (
+	"database/sql"
+	"log"
+
+	sqlite_vec "github.com/asg017/sqlite-vec-go-bindings/cgo"
+	_ "github.com/mattn/go-sqlite3"
+)
+
+func main() {
+	sqlite_vec.Auto()
+	db, err := sql.Open("sqlite3", ":memory:")
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer db.Close()
+
+	var vecVersion string
+	err = db.QueryRow("select vec_version()").Scan(&vecVersion)
+	if err != nil {
+		log.Fatal(err)
+	}
+	log.Printf("sqlite_version=%s, vec_version=%s\n",vecVersion)
+}
 ```
 
 ## Option 2: WASM based with `ncruces/go-sqlite3`
 
-```
-go
+[`github.com/ncruces/go-sqlite3`](https://github.com/ncruces/go-sqlite3) is an alternative SQLite Go driver that avoids CGO by using a custom WASM build of SQLite. To use `sqlite-vec` from this library, use the specicial WASM binary provided in `github.com/asg017/sqlite-vec-go-bindings/ncruces`.
+
+```bash
+go get -u github.com/asg017/sqlite-vec-go-bindings/ncruces
 ```
 
+```go
+package main
+
+import (
+	_ "embed"
+	"log"
+
+	_ "github.com/asg017/sqlite-vec-go-bindings/ncruces"
+	"github.com/ncruces/go-sqlite3"
+)
+
+func main() {
+	db, err := sqlite3.Open(":memory:")
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	stmt, _, err := db.Prepare(`SELECT sqlite_version(), vec_version()`)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	stmt.Step()
+	log.Printf("vec_version=%s\n", stmt.ColumnText(0))
+	stmt.Close()
+}
+```
+
+The `github.com/asg017/sqlite-vec-go-bindings/ncruces` package embeds a custom WASM build of SQLite, so there's no need to use `github.com/ncruces/go-sqlite3/embed`.
+
 ## Working with vectors in Go
+
+
+If vectors are provided as a list of floats, use `SerializeFloat32(list)` to serialize them into the compact BLOB format that `sqlite-vec` expects.
+
+```go
+TODO
+```