Starting content descriptions in readme

README.md

@@ -86,16 +86,52 @@ This website is designed for ease of maintenance and content authoring, with a g
 Content for the Hero Carousel is sourced from `YAML` files located in `/src/data/hero`. Each slide has a dedicated file.
 
 ```yaml
-name: Platform One
-title: Platform One
-subtitle: 'Fast, Secure, Streamlined'
-slug: '/services/cloud-one'
-image: '../../images/clouds-19.jpg'
-index: 2
+name: Cloud One
+title: Cloud One
+subtitle: "USAF's preeminent cloud hosting platform"
+core: true
+cta: 'Learn More'
+slug: '/services/cloud-one/'
+image: '../../images/hero/2-hero-cloud-one.png'
+logo: '../../images/hero/logo-cloud-one.png'
+thumb: '../../images/hero/thumb-cloud-one.png'
+thumblogo: '../../images/hero/logo-cloud-one.png'
+index: 1
 ```
 
+- `name`: Unique name for the slide, keep same as `title`
+- `title`: Used for largest text on slide. Will be replaced with `logo` image, if present.
+- `subtitle`: Optional. Text under title
+- `core`: Optional, true or false. Adds "Core Transformation Service" text above slide title.
+- `cta`: Optional. Text for the slide button.
+- `slug`: Optional. Link for slide button.
+- `image`: Main background image for slide.
+- `logo`: Optional. Main slide graphic logo. Slide will default to displaying `title` text if not present.
+- `thumb`: Background image for slide controls. Scaled and cropped version of `image`
+- `thumbLogo`: Optional. Graphic to display in slide controls. Will default to `title` text if not present.
+
 ## Service Category Pages
 
+The Service Category page contains a list of links to services, related to a parent category. The
+content is controlled by a markdown file in `/src/content/service-category`. Each file has a 
+header section with metadata in yaml format. The body section of the file is the description of
+the service, and appears in the pages header.
+
+```yaml
+slug: '/networking-connectivity/'
+title: 'Networking & Connectivity'
+categories:
+  - Global Connectivity / WAN
+  - Local Connectivity / BAN
+  - Transport
+  - Cloud Access
+  - Reference Architectures
+image: '../../images/cat-header.png'
+share: '../../images/share/ogimage-networking_and_connectivity.png'
+icon: DtNetConn
+```
+`
+
 ## Service Detail Pages
 
 ## Solutions Pages