Giter VIP home page Giter VIP logo

docs's Introduction

Accelo API Documentation

Powering the documentation at api.accelo.com/docs/

Getting Started

Prerequisites

You're going to need:

  • Linux or macOS โ€” Windows may work, but is unsupported.
  • Ruby, version 2.3.1 or newer
  • Bundler โ€” If Ruby is already installed, but the bundle command doesn't work, just run gem install bundler in a terminal.

Running Preview

# either run this to run locally
bundle install
bundle exec middleman server

# OR run this to run with vagrant
vagrant up

You can now see the docs at http://localhost:4567.

Deploying

The Accelo Public API Docs are now automatically deployed via a github action .github/workflows/deploy.yml which triggers when changes are applied to main.

If you wish to manually deploy the documentation, it can be done via the deploy.sh script.

Note on JavaScript Runtime

For those who don't have JavaScript runtime or are experiencing JavaScript runtime issues with ExecJS, it is recommended to add the rubyracer gem to your gemfile and run bundle again.

Need help?

To report problems or ask questions please post to our community forum and someone will be happy to help ๐Ÿ˜ƒ

If you see issues or would like to make an improvement in the documentation please don't hesitate to contribute with a pull request.

Special Thanks

  • A big thanks to all the contributors and maintainers of Slate โค๏ธ ; and
  • Even bigger thanks to Matthew H - the primary author of these docs! ๐ŸŽ‰

Maintenance

Upgrading Slate

To upgrade slate, please merge the upstream main into a new branch off of main. As this process may result in conflicts and breaking changes, it should go through the usual pull request process before being deployed on main.

git checkout main
git checkout -b slate-upgrade
git fetch upstream
git merge upstream/main

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.