diff --git a/docs/dev-guide/index-definitions.md b/docs/dev-guide/index-definitions.md
index 9fcee84..1a1fd5f 100644
--- a/docs/dev-guide/index-definitions.md
+++ b/docs/dev-guide/index-definitions.md
@@ -1,4 +1,4 @@
-# Defining indexes
+# Index definitions
 
 You can list, retrieve, create and delete index definitions in cbft
 using its REST API or using its web admin UI.
diff --git a/docs/dev-guide/index-querying.md b/docs/dev-guide/index-queries.md
similarity index 87%
rename from docs/dev-guide/index-querying.md
rename to docs/dev-guide/index-queries.md
index cc96bc3..f180fb3 100644
--- a/docs/dev-guide/index-querying.md
+++ b/docs/dev-guide/index-queries.md
@@ -1,4 +1,4 @@
-# Querying indexes
+# Index queries
 
 tbd
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 07b086b..f753a42 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -4,8 +4,8 @@ pages:
 - ['index.md', 'Home']
 - ['dev-guide/concepts.md', "Developer's Guide", "Key concepts"]
 - ['dev-guide/command.md', "Developer's Guide", "cbft command-line"]
-- ['dev-guide/index-definitions.md', "Developer's Guide", "Index Definitions"]
-- ['dev-guide/index-querying.md', "Developer's Guide", "Index Querying"]
+- ['dev-guide/index-definitions.md', "Developer's Guide", "Index definitions"]
+- ['dev-guide/index-queries.md', "Developer's Guide", "Index queries"]
 - ['dev-guide/performance.md', "Developer's Guide", "Performance"]
 - ['dev-guide/advanced.md', "Developer's Guide", "Advanced topics"]
 - ['dev-guide/samples.md', "Developer's Guide", "Sample apps"]