diff --git a/docs/spec/v1alpha1/README.md b/docs/spec/v1alpha1/README.md
index f1e49e62..eb9bf58b 100644
--- a/docs/spec/v1alpha1/README.md
+++ b/docs/spec/v1alpha1/README.md
@@ -2,6 +2,7 @@
 
 The is the v1alpha1 API specification for defining the desired state sources of Kubernetes clusters.
 
+## Specification
 
 * [Common](common.md)
 * Source kinds:
@@ -9,5 +10,6 @@ The is the v1alpha1 API specification for defining the desired state sources of
   + [HelmRepository](helmrepositories.md)
     - [HelmChart](helmrepositories.md)
 
-Implementations:
+## Implementation
+
 * source-controller [v0.0.1-alpha.1](https://github.com/fluxcd/source-controller/releases)
diff --git a/docs/spec/v1alpha1/common.md b/docs/spec/v1alpha1/common.md
index 1b6d44e1..092bcec0 100644
--- a/docs/spec/v1alpha1/common.md
+++ b/docs/spec/v1alpha1/common.md
@@ -22,7 +22,7 @@ The controller can be told to check for updates right away by setting an annotat
 
 ```go
 const (
-    // ForceSyncAnnotation is the timestamp corresponding to an on-demand source sync.
+	// ForceSyncAnnotation is the timestamp corresponding to an on-demand source sync.
 	ForceSyncAnnotation string = "source.fluxcd.io/syncAt"
 )
 ```
diff --git a/docs/spec/v1alpha1/helmrepositories.md b/docs/spec/v1alpha1/helmrepositories.md
index 9ab550fb..a52b0265 100644
--- a/docs/spec/v1alpha1/helmrepositories.md
+++ b/docs/spec/v1alpha1/helmrepositories.md
@@ -160,7 +160,6 @@ data:
   certFile:              <BASE64>
   keyFile:               <BASE64>
   caFile:                <BASE64>
-  insecureSkipTLSVerify: <base64>
 ```
 
 ### Helm chart