Currently, there seems to to be very little instruction on how/why certain combinations of _sidebar.md files and folder structures make the sidebar navigation and pagination work.

For example, if my _sidebar.md file contains this:

- **Services**
    - [Getting Started](services/getting-started.md)
    - [Running Service Locally](services/running-services.md)

and my folder

Motivation

I have a site where the staging location has a site.baseurl and the live version has not. While working with inline images I found - by looking at the mmistakes codebase, could not discover instruction in the docs - that instead of this:

Hi;

I hope it's a feature request and not a bug report
I try to apply design.background but at the item level
and the code won't let me add more than one [design.background]

this is work

widget = "slider"
weight = 11
[[item]]
  title = "Left"
  content = "I am left aligned :smile:"
  [design.background]
    gradient_start = "#0000F9"
    gradient_end = "#86007D"

Looks like this feature may have been renamed; the Auxiliary Navigation section

https://pmarsceill.github.io/just-the-docs/docs/navigation-structure/#auxiliary-navigation

talks about aux_nav but the example uses aux_links.

Additionally the section has a broken link to

https://pmarsceill.github.io/just-the-docs/docs/configuration/#aux-nav

which also should be aux-links.

Before submitting an issue, please be sure to

• Read the contributing instructions
• Update to the latest Gem version (run bundle update github-pages)

This issue affects

• The site generated by GitHub Pages
• Building sites locally

What did you

各位朋友，你们好。

如果你们使用 doocs/md 工具进行图文排版，欢迎在下方留言。后续我考虑在 README 首页中展示你们的公众号。谢谢你们 :D

I just choose cayman theme on github setting. I already designed a logo (favicon) for my webpage, where should I put it?

Thanks!

Describe the solution you'd like
Add status to right of category. The category can often represent many systems so it would be awesome to see which category is operational, degraded or down.

This is in addition to the system status.
Some like the following: https://status.python.org/

i think the readme needs some refactoring now. It doesn't make sense anymore to instruct users to edit the variables in the script itself, especially considering how deeply buried those default values have gotten with the recent changes.

i'm thinking we merge the configuration and options sections, and the run section can be simplified, or maybe even mixed somewhere in with the rest, too.

overal

Generally, the following works as expacted:

• List IS-A Collection<E>

But for this particular case, it doesn't:
![screen shot 2018-01-08 at 13 37 43](https://user-images.githubusercontent.com/5684688/34671077-4a62ca22-f479-11e7-98db-e85d06280b98.

when you navigate to another page example "About" the menu feels like it is closed too fast and without progressive transition