diff --git a/atom-extensions/atom-boot-java/README.MD b/atom-extensions/atom-boot-java/README.md
similarity index 100%
rename from atom-extensions/atom-boot-java/README.MD
rename to atom-extensions/atom-boot-java/README.md
diff --git a/atom-extensions/atom-boot-properties/README.MD b/atom-extensions/atom-boot-properties/DEVELOPER-NOTES.md
similarity index 100%
rename from atom-extensions/atom-boot-properties/README.MD
rename to atom-extensions/atom-boot-properties/DEVELOPER-NOTES.md
diff --git a/atom-extensions/atom-boot-properties/README.md b/atom-extensions/atom-boot-properties/README.md
new file mode 100644
index 000000000..c2bf453d1
--- /dev/null
+++ b/atom-extensions/atom-boot-properties/README.md
@@ -0,0 +1,58 @@
+# VS Code Language Server for Spring Boot Application Properties
+
+Atom package and Language Server providing support for working with Spring Boot 
+`application.properties` and `application.yml` files.
+
+# Usage:
+
+The package will automatically activate when you edit files with the following
+name patterns:
+
+ - `application.properties` => activates support for Spring Boot properties in `.properties`format.
+ - `application.yml` =>  activates support for Spring Boot properties in `.yml` format.
+
+For all other files select grammar to be `Spring-Boot-Properties` for `properties` file format or `Spring-Boot-Properties-YAML` for 'YAML' file format
+
+# Functionality
+
+This package analyzes your project's classpath and parses and indexes any [Spring Boot
+Properties Metadata](https://docs.spring.io/spring-boot/docs/current/reference/html/configuration-metadata.html) it finds. Both Maven and Gradle projects are supported.
+
+The data in the index is used to provide validation, code completions and information
+hovers while editing Spring Boot Properties in either `.properties` or `.yml` format.
+
+## Validation
+
+![application-yaml-validation][yaml-validation]
+![application-properties-validation][properties-validation]
+
+## Code Completions
+
+![application-yaml-completions][yaml-completion]
+
+![application-properties-completions][properties-completion]
+
+## Information Hovers
+
+![application-yaml-hovers][yaml-hovers]
+
+## Issues and Feature Requests
+
+Please report bugs, issues and feature requests on the [Github STS4 issue tracker](https://github.com/spring-projects/sts4/issues). 
+
+# Releases:
+
+Released versions of this extension can be installed directly from the vscode marketplace.
+
+There are also development snapshots available with the latest fixes and improvements as a `.tgz` file 
+that can be donwloaded from 
+[here](http://dist.springsource.com/snapshot/STS4/nightly-distributions.html). To install it:
+1. Unpack into a folder `<package>` (this folder should have `package.json` file)
+2. Execute `apm link .` from that folder
+3. Execute `Window Reload` (Package -> Command Palette -> Toggle then search for it) command in the opened Atom instance or open an Atom instance
+
+[yaml-completion]: https://github.com/spring-projects/sts4/raw/5360ae4fabf9245da58f5897c54e9a14786d0622/vscode-extensions/vscode-boot-properties/readme-imgs/yaml-completion.png
+[properties-completion]: https://github.com/spring-projects/sts4/raw/5360ae4fabf9245da58f5897c54e9a14786d0622/vscode-extensions/vscode-boot-properties/readme-imgs/properties-completion.png
+[yaml-validation]: https://github.com/spring-projects/sts4/raw/5360ae4fabf9245da58f5897c54e9a14786d0622/vscode-extensions/vscode-boot-properties/readme-imgs/yaml-validation.png
+[properties-validation]: https://github.com/spring-projects/sts4/raw/5360ae4fabf9245da58f5897c54e9a14786d0622/vscode-extensions/vscode-boot-properties/readme-imgs/properties-validation.png
+[yaml-hovers]: https://github.com/spring-projects/sts4/raw/5360ae4fabf9245da58f5897c54e9a14786d0622/vscode-extensions/vscode-boot-properties/readme-imgs/yaml-hovers.png
diff --git a/atom-extensions/atom-boot-properties/readme-imgs/properties-completion.png b/atom-extensions/atom-boot-properties/readme-imgs/properties-completion.png
new file mode 100644
index 000000000..6bcfe6872
Binary files /dev/null and b/atom-extensions/atom-boot-properties/readme-imgs/properties-completion.png differ
diff --git a/atom-extensions/atom-boot-properties/readme-imgs/properties-validation.png b/atom-extensions/atom-boot-properties/readme-imgs/properties-validation.png
new file mode 100644
index 000000000..9c94f4e67
Binary files /dev/null and b/atom-extensions/atom-boot-properties/readme-imgs/properties-validation.png differ
diff --git a/atom-extensions/atom-boot-properties/readme-imgs/yaml-completion.png b/atom-extensions/atom-boot-properties/readme-imgs/yaml-completion.png
new file mode 100644
index 000000000..c393531c6
Binary files /dev/null and b/atom-extensions/atom-boot-properties/readme-imgs/yaml-completion.png differ
diff --git a/atom-extensions/atom-boot-properties/readme-imgs/yaml-hovers.png b/atom-extensions/atom-boot-properties/readme-imgs/yaml-hovers.png
new file mode 100644
index 000000000..576492f25
Binary files /dev/null and b/atom-extensions/atom-boot-properties/readme-imgs/yaml-hovers.png differ
diff --git a/atom-extensions/atom-boot-properties/readme-imgs/yaml-validation.png b/atom-extensions/atom-boot-properties/readme-imgs/yaml-validation.png
new file mode 100644
index 000000000..c774e240d
Binary files /dev/null and b/atom-extensions/atom-boot-properties/readme-imgs/yaml-validation.png differ
diff --git a/atom-extensions/atom-bosh/README.MD b/atom-extensions/atom-bosh/README.md
similarity index 100%
rename from atom-extensions/atom-bosh/README.MD
rename to atom-extensions/atom-bosh/README.md
diff --git a/atom-extensions/atom-cf-manifest-yaml/README.MD b/atom-extensions/atom-cf-manifest-yaml/README.md
similarity index 100%
rename from atom-extensions/atom-cf-manifest-yaml/README.MD
rename to atom-extensions/atom-cf-manifest-yaml/README.md
diff --git a/atom-extensions/atom-concourse/README.MD b/atom-extensions/atom-concourse/README.md
similarity index 100%
rename from atom-extensions/atom-concourse/README.MD
rename to atom-extensions/atom-concourse/README.md