jamierevans / appsignal-docs

The AppSignal documentation website!

AppSignal Documentation

This repository contains the source for the AppSignal documentation website.

• AppSignal.com website
• Documentation
• Support

Setup

Run the following commands:

git submodule init
git submodule update

Usage

bundle install
bundle exec middleman

Open the browser at localhost:4567 and click around.

Deployment

bundle exec rake build_deploy

Content

Markdown customizations

To render notices we've added a custom markdown tag. Use it like so:

!> This is a warning!
-> This is a notice!

# I'm a heading
#^prefix I'm a heading

Which will render the following:

<div class="warning">
  <p>This is a warning!</p>
</div>
<div class="notice">
  <p>This is a notice!</p>
</div>

<h1><span class="anchor" id="im-a-heading"></span><a href="#im-a-heading">I'm a heading</a></h1>
<h1><span class="anchor" id="prefix-im-a-heading"></span><a href="#prefix-im-a-heading">I'm a heading</a></h1>

For more information (and code) about these customizations, please see the appsignal_markdown.rb file.

Contributing

Thinking of contributing to our documentation? Awesome! 🚀

Please follow our Contributing guide in our documentation.

Also, we would be very happy to send you Stroopwaffles. Have look at everyone we send a package to so far on our Stroopwaffles page.