ryandle / Documentation

Wilderness Labs Docs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Documentation

Hello, and welcome to the Documentation repo for Wilderness Labs! These docs are probably best viewed at the developer.wildernesslabs.co, but they should be readable here, as well. You'll also find all the source code to the samples here.

Running Locally

This repo is also a Ruby site powered by jekyll (which is how it's hosted by GitHub Pages). You can run and browse this site locally, which is especially useful if you're contributing documentation, or you just want an offline experience.

To browse locally:

1. Install Homebrew (if not already installed)

2. Install prerequisites: Ruby, Jekyll, Bundler, and various gems

Open a terminal and navigate to the Documentation/docs folder and run:

$ brew install ruby

Once you have Ruby, you'll need Jekyll and Bundler to build and host the site locally:

$ gem install jekyll bundler

With the Bundler installed to manage the Ruby gems, you can run a command to install all the prerequisite gems for the site:

$ bundle install

3. Launch local server

Change your terminal working folder to Documentation/docs (if it's not aleady) and run:

bundle exec jekyll serve

The site should be available locally at: http://127.0.0.1:4001/. You can verify the IP address and port from the jekyll output in terminal.

Changes should automatically be picked up and displayed on the site.

Wilderness Labs welcomes and encourages constrictive contributions. We believe that documentation is best when a diverse community of folks with a variety of perspectives and experience share their wisdom and findings with others. Additionally, documentation contributions are a great way to capture learnings that you may even reference yourself.

For more information, please see the Contributing page.

License

Copyright

Content copyright Wilderness Labs.

Electronics tutorial copyright Bryan Costanich.

Documentation Prose

All the documentation prose is released under a Creative Commons Attribution + Noncommercial + NoDerivatives (CC BY-NC-ND) license. Feel free to share verbatim in non-commercial usage and provide attribution. Commercial usage may be granted in certain use cases. If you need a more permissive license, please contact us at hello@wildernesslabs.co.

Creative Commons BY-NC-ND Logo

Human Readable Version of the License

Code Samples and Code Snippets

All code samples and code snippets, whether they be full applications, or embedded snippets within the documentation are released under the Apache 2 license. Feel free to use and distribute the code as you see fit, under the very permissive terms of the license.

About

Wilderness Labs Docs


Languages

Language:HTML 89.9%Language:CSS 6.3%Language:JavaScript 3.2%Language:Liquid 0.4%Language:Ruby 0.2%Language:Shell 0.0%