SLING-7167 Adjust READMEs
add uniform header linking to Sling project
git-svn-id: https://svn.apache.org/repos/asf/sling/trunk@1810937 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/htlblog/readme.md b/htlblog/README.md
similarity index 89%
rename from htlblog/readme.md
rename to htlblog/README.md
index 5dac3cb..2e0c79d 100644
--- a/htlblog/readme.md
+++ b/htlblog/README.md
@@ -1,30 +1,34 @@
-# About
+# Apache Sling HTL Blog Sample
+
+This module is part of the [Apache Sling](https://sling.apache.org) project.
+
+## About
This sample is designed as an introduction to Sling and HTL.
-# Features
+## Features
* Create, update, delete posts with featured images.
* List posts, read posts.
-# Requirements
+## Requirements
* [Java 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
* [Sling 8](http://sling.apache.org/downloads.cgi)
* [Maven 3+](http://maven.apache.org/download.cgi)
-# Installation
-## 1. Run Sling
+## Installation
+### 1. Run Sling
java -jar org.apache.sling.launchpad-8.jar
-## 2. Install HTLBlog
+### 2. Install HTLBlog
mvn clean install -PautoInstallBundle
-## 3. Explore
+### 3. Explore
http://localhost:8080/content/htlblog.html
-# Parts of the Application
-## Java
+## Parts of the Application
+### Java
HTL Blog uses Sling Models extensively. You can read about them [here](https://sling.apache.org/documentation/bundles/models.html).
* `Author.java` - This model detects if our user is logged in or not.
@@ -32,7 +36,7 @@
* `List.java` - This is used to iterate through our posts, reverse their order, and adapt them to our post model.
* `Post.java` - This model injects our post properties, finds the featured image, and lists any children (comments).
-## Apps (HTL)
+### Apps (HTL)
* Admin
* Page - The base admin page.
@@ -45,7 +49,7 @@
* Clientlibs
* Mostly Bootstrap and some basic custom styles.
-## Content
+### Content
The content is built using a single JSON file called `htlblog.json`. It maps to the following nodes:
* `/content/htlblog` - Our homepage. Currently lists our posts.
@@ -55,7 +59,7 @@
* `/content/htlblog/posts/hello-world` - Used to scaffold a placeholder post.
* `/content/htlblog/posts/hola-mundo` - Used to scaffold a 2nd placeholder post.
-# Additional Reading
+## Additional Reading
* The [SlingPostServet](https://sling.apache.org/documentation/bundles/manipulating-content-the-slingpostservlet-servlets-post.html) and [Sling CRUD](https://sling.apache.org/documentation/the-sling-engine/sling-api-crud-support.html) docs. Everything in this sample uses these concepts extensively.
* The [HTL Specification](https://github.com/Adobe-Marketing-Cloud/htl-spec/blob/master/SPECIFICATION.md). If you have a question about HTL, it will likely be answered here. Note: The spec and the current release in Sling can be out of sync.