diff --git a/docs/src/main/paradox/release-notes.md b/docs/src/main/paradox/release-notes.md
index 49dbdafa005..8c6d6a38061 100644
--- a/docs/src/main/paradox/release-notes.md
+++ b/docs/src/main/paradox/release-notes.md
@@ -29,18 +29,18 @@ previous behavior so we are listing them here to bring attention to potential is
 
 ##### akka-http-core:
 
- * optimize frame creation for streamed WS messages ([#748](https://github.com/akka/akka-http/issues/748))
+ * Optimize frame creation for streamed WS messages ([#748](https://github.com/akka/akka-http/issues/748))
 
 ##### akka-http:
 
  * Provide HttpApp API for Scala and Java ([#156](https://github.com/akka/akka-http/issues/156))
- * add Java-side mapRejectionResponse ([#593](https://github.com/akka/akka-http/issues/593))
+ * Add Java-side mapRejectionResponse ([#593](https://github.com/akka/akka-http/issues/593))
  * Add Composing directives java (`anyOf`, `allOf`). ([#620](https://github.com/akka/akka-http/issues/620))
- * add Unmarshaller.andThen to combine two Unmarshallers ([#691](https://github.com/akka/akka-http/issues/691))
+ * Add Unmarshaller.andThen to combine two Unmarshallers ([#691](https://github.com/akka/akka-http/issues/691))
 
 ##### akka-http2-support:
 
- * lots of larger and smaller improvements to Http2 support
+ * Lots of larger and smaller improvements to Http2 support
 
 #### Bugfixes
 
@@ -48,18 +48,18 @@ previous behavior so we are listing them here to bring attention to potential is
 
  * Allow Java bind API to specify port zero ([#660](https://github.com/akka/akka-http/issues/660))
  * Fix ConnectHttp.toHostHttps when no scheme is given
- * exclude leading double slash from Uri.Authority.toString ([#784](https://github.com/akka/akka-http/issues/784))
+ * Exclude leading double slash from Uri.Authority.toString ([#784](https://github.com/akka/akka-http/issues/784))
  * Basic auth fix according to rfc7617 - 'charset' auth-param ([#716](https://github.com/akka/akka-http/issues/716))
- * provide correct scheme in request URI for TLS connections ([#658](https://github.com/akka/akka-http/issues/658))
- * prevent "Connection closed by peer" errors during connection closure ([#459](https://github.com/akka/akka-http/issues/459))
+ * Provide correct scheme in request URI for TLS connections ([#658](https://github.com/akka/akka-http/issues/658))
+ * Prevent "Connection closed by peer" errors during connection closure ([#459](https://github.com/akka/akka-http/issues/459))
 
 ##### akka-http:
 
- * fix stream marshalling, better errors, more examples ([#424](https://github.com/akka/akka-http/issues/424))
- * don't ignore failed future for NoContent responses ([#589](https://github.com/akka/akka-http/issues/589))
- * deprecate wrongly spelled method `Unmarshaller.unmarshall`
+ * Fix stream marshalling, better errors, more examples ([#424](https://github.com/akka/akka-http/issues/424))
+ * Don't ignore failed future for NoContent responses ([#589](https://github.com/akka/akka-http/issues/589))
+ * Deprecate wrongly spelled method `Unmarshaller.unmarshall`
  * Match path maps in order of longest matching key prefix ([#394](https://github.com/akka/akka-http/issues/394))
- * don't leak Scala classes in java Unmarshaller ([#604](https://github.com/akka/akka-http/issues/604))
+ * Don't leak Scala classes in java Unmarshaller ([#604](https://github.com/akka/akka-http/issues/604))
 
 ##### akka-http-testkit:
 
@@ -67,14 +67,14 @@ previous behavior so we are listing them here to bring attention to potential is
 
 ##### akka-http-spray-json:
 
- * fix spray-json unmarshalling of 4-byte UTF-8 characters AKA "the 😁 fix" ([#691](https://github.com/akka/akka-http/issues/691))
- * updated spray-json dependency to 1.3.3
+ * Fix spray-json unmarshalling of 4-byte UTF-8 characters AKA "the 😁 fix" ([#691](https://github.com/akka/akka-http/issues/691))
+ * Updated spray-json dependency to 1.3.3
 
 ####  Documentation
 
- * a huge amount of bigger and smaller contributions from the community
- * add link to sources to every documentation page to simplify contributing small fixes
- * add search thanks to algolia ([#726](https://github.com/akka/akka-http/issues/726))
+ * A huge amount of bigger and smaller contributions from the community
+ * Add link to sources to every documentation page to simplify contributing small fixes
+ * Add search thanks to algolia ([#726](https://github.com/akka/akka-http/issues/726))
 
 
 ## 10.0.2