diff --git a/docs/spec/v1alpha1/alert.md b/docs/spec/v1alpha1/alerts.md
similarity index 100%
rename from docs/spec/v1alpha1/alert.md
rename to docs/spec/v1alpha1/alerts.md
diff --git a/docs/spec/v1alpha1/event.md b/docs/spec/v1alpha1/events.md
similarity index 100%
rename from docs/spec/v1alpha1/event.md
rename to docs/spec/v1alpha1/events.md
diff --git a/docs/spec/v1alpha1/provider.md b/docs/spec/v1alpha1/providers.md
similarity index 100%
rename from docs/spec/v1alpha1/provider.md
rename to docs/spec/v1alpha1/providers.md
diff --git a/docs/spec/v1alpha1/receiver.md b/docs/spec/v1alpha1/receivers.md
similarity index 100%
rename from docs/spec/v1alpha1/receiver.md
rename to docs/spec/v1alpha1/receivers.md
diff --git a/docs/spec/v1beta1/alert.md b/docs/spec/v1beta1/alerts.md
similarity index 100%
rename from docs/spec/v1beta1/alert.md
rename to docs/spec/v1beta1/alerts.md
diff --git a/docs/spec/v1beta1/event.md b/docs/spec/v1beta1/events.md
similarity index 100%
rename from docs/spec/v1beta1/event.md
rename to docs/spec/v1beta1/events.md
diff --git a/docs/spec/v1beta1/provider.md b/docs/spec/v1beta1/providers.md
similarity index 100%
rename from docs/spec/v1beta1/provider.md
rename to docs/spec/v1beta1/providers.md
diff --git a/docs/spec/v1beta1/receiver.md b/docs/spec/v1beta1/receivers.md
similarity index 100%
rename from docs/spec/v1beta1/receiver.md
rename to docs/spec/v1beta1/receivers.md