diff --git a/docs/index.md b/docs/index.md
index 2482a8b1ab3990eada914d00735ef2a3edbbfe41..c1b16ff1ec09b0d7bc396d95870bd17e16dd0399 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -15,10 +15,10 @@ poked, prodded, twisted, and hacked. It can be customized, extended, and
 collaboratively developed. This documentation tells you how to do that.
 
 It starts with a high level introduction to get you familiar
-with CiviCRM development. It covers setting up your developer environment,
-ensuring that you really need to start coding (i.e. you can't achieve what you
-want thought configuration or installing an already existing extension), best
-practice ways to extend CiviCRM (aka how to write an extensions), things you
+with CiviCRM development. It covers setting up your development environment,
+checking whether or not you actually need to implement your own custom code (i.e. you can't achieve what you
+want through configuration or installing an already existing extension), best
+practice ways to extend CiviCRM (a.k.a. how to write an extension), things you
 should know before you start hacking on core, and best practice for testing.
 
 The guide also includes detailed references for tools and subsystems