bigbadgoose/okta.github.io — pull request #1 by lorncheung (2014-04-14 09:53:02+00:00)
Title: [WIP] [Do not merge] Sidebar refactor using front-matter spanning multiple doc pages

Work in the PR is all sidebar related. Will update details here as work progresses. Most of this work uses native Liquid and Jeckyll syntax.

![screen shot 2014-04-14 at 2 45 32 am](https://cloud.githubusercontent.com/assets/304541/2693765/9b242f68-c3b9-11e3-8f38-0daf190c5dfe.png)

Renamed the markdown files, prefixed with order numbers so we can control the order of the list (Defaults alphabetically)

The front-matter looks like this:

```
---
layout: docs
title: Users
group: Endpoints
description: "Okta developers"
permalink: "users.html"
anchor_links:
- Overview
- User Model
- Related Resources
- Lifecycle Operations
- Crediential Operations
---
```

See pages-list for how the anchor links are generated.

The order of the major nav items are set in config.yml:

```
docs_categories:
- dir: introduction_to_okta
label: Introduction to Okta
-
dir: getting_started
label: Getting Started
-
dir: endpoints
label: Endpoints
-
dir: examples
label: Examples
```