diff --git a/.gitignore b/.gitignore
index 4103f0c..11704f0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,14 @@
-/target
+# The `target` directory is generated by Cargo.
+# It will contain mostly compiled files and executables.
+target/*
+
+# But the API documentation eventually gets published, so we want to
+# make sure these files are also included in commits for downstream
+# services to consume, and these are by default output to `target/doc`.
+!target/doc
+target/doc/*
+!target/doc/index.html
+
+# Other ignores go here.
node_modules
/Cargo.lock
diff --git a/target/doc/index.html b/target/doc/index.html
new file mode 100644
index 0000000..b8654da
--- /dev/null
+++ b/target/doc/index.html
@@ -0,0 +1,12 @@
+
+
+
+
+
+
+ Redirecting….
+
+
+ Redirecting to this repository's API documentation….
+
+