Zernit/docs
Kreyren d256ff6c67
Master init (#40)
* fdjfgjdfg

* jghkfghkf

* fgdfjfghj

* sgassg

* jksdhgjkasdnh

* Adapted code

* add vlang

* hkghkgh

* sdgasdg

* sagsdag

* gjghfj

* hjfghkf

* dgsghafh

* gjfgjfd

* fdhfhfgj

* Update gitpod.Dockerfile

* fixes

* fixes

* gjhfhghk

* xdgad

* dsgasdg

* shebang test

* sagaga

* shash

* jfhjgh

* hfgdj

* dgsdfhsdf

* Update gitpod.Dockerfile

* dshsfd

* hgkgk

* ffhdfgj

* Update vlang_init.sh

* Update vlang_init.sh

* agsah

* ffgjghjfgh

* jghkfg

* jghjfh

* hdhsfdh

* fdhfgj

* fdhsfdh

* fghdfgh

* sdgag

* dshas

* vcmvmvb

* sdagasdg

* shfdh

* sdagsdag

* dfhfgd

* Update cargo-make requirement from 0.26.2 to 0.27.0

Updates the requirements on [cargo-make](https://github.com/sagiegurari/cargo-make) to permit the latest version.
- [Release notes](https://github.com/sagiegurari/cargo-make/releases)
- [Changelog](https://github.com/sagiegurari/cargo-make/blob/master/CHANGELOG.md)
- [Commits](https://github.com/sagiegurari/cargo-make/compare/0.26.2...0.27.0)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>

* test

* Bump termcolor from 1.0.0 to 1.1.0

Bumps [termcolor](http://pypi.python.org/pypi/termcolor) from 1.0.0 to 1.1.0.

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>

* fdhsfh

* Create jekyll.yml

* dsadsh

* fdhgj

* sagsag

* sagag

* hfgj

* sdgsdag

* dgasdga

* hghkh

* sagas

* gjkghkf

* safsaf

* gjfkf

* stub

* djknsfdjknh

* sdgasdg

* asasg

* safsa

* gagsd

* IT'S YOUR TURN TRAVIS MUHAHAH

* shfdhsfd

* gfgj

* dfhfgdj

* fgkfhg

* fdhhsf

* fghkjgh

* fhdfjh

* safsa

* sagasga

* sdgdsfh

* saagsga

* gjhlghl

* jklhj

* gfghkg

* gfjdfgj

* nm,;n

* kljlk'j

* jk'jkl'

* saasga

* sdgasdg

* gjghk

* dhsfh

* fdhsfdj

* hkgjkgh

* asgsa

* fhfgjfg

* RUNALISA!

* asgas

* sasgd

* fdfgj

* dsfhdsf

* fhdfhs

* sagasg

* sagasg

* Fix C and adapt more sanity checks

* shdfh

* sagsag

* safasf

* sag

* hgjl

* asgasg

* sgagsa

* asfasf

* safasf

* sasag

* fdjfgj

* fjdgj

* sagasg

* Why can't i see the hugging source for this GUI? #ThanksMicrosoft

* saksdakhla

* jhlgj

* hjglh

* sdgdasg

* saga

* safsaf

* sagag

* fdhsfdh

* safasf

* fdhjsfdh

* PLEASE JUST FUCKING WORK

* SAGSAG

* sagasg

* agaahds

* end my suffering

* hgkkfkg

* all hail twofifths the savior

* sagasga

* fdhfgh

* dgsgh

* khgk

* asgasg

* ddfjhfg

* asgagasg

* fhdshfd

* asasgsagas

* hgkg

* saasg

* saagg

* ffdjgf

* hlj

* vbbghkk

* safasf

* safsaf

* sdhdfh

* fdhsdh

* saag

* sagag

* safasf

* asgasg

* ffgjfg

* f54hs6f5d4h

* sagasg

* dsgasg

* sgasdg

* gfjfgj

* cfghd

* fhddfgj

* dsgsagd

* shsadh

* fhdf

* fdjhfg

* asgasga

* sdgag

* fjfdgjdf

* fdhsfdh

* asgsa

* sagasg

* sagasg

* sagasg

* dsgsdha

* fdhsfhd

* YoU cAnT dO tHiS iN ShElL kReY

* tetats

* gfjdfgj

* sagsag

* fgj

* bvghkf

* gfhdfghfg

* sdagsadg

* sdgasdg

* agaas

* dassfd

* vbghf

* jghkgh

* hfgdj

* gjkjlg

* sdgfdg

* asgag

* fgkgkh

* fdhsfdh

* dsgasdg

* dsgsg

* fgj

* safsaf

* agsgd

* Finally we have theia config

Relevant: https://github.com/gitpod-io/gitpod/issues/800#issuecomment-587381366

* agsdgh

* kjghkgg

* vjfgjfgd

* add dia

* flowchart: init

* adgasdg

* Update Zernit.drawio

* Update Zernit.drawio

* Update Zernit.drawio

* asdgsdag

* fddfhs

* saasg

* sasag

* dgasdgasd

* dsgasdg

* Create question.md

* Update labels.yml

* do not bother bug wranglers with questions

* sasaasgd

* dhfdh

* safasf

* dsgasdg

* Update debian.Dockerfile

* dsagasdg

* Update debian.Dockerfile

* sdghsdf

* agasd

* Update cargo-make requirement from 0.27.0 to 0.28.0 (#58)

Updates the requirements on [cargo-make](https://github.com/sagiegurari/cargo-make) to permit the latest version.
- [Release notes](https://github.com/sagiegurari/cargo-make/releases)
- [Changelog](https://github.com/sagiegurari/cargo-make/blob/master/CHANGELOG.md)
- [Commits](https://github.com/sagiegurari/cargo-make/compare/0.27.0...0.28.0)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>

* stub for RXT ownership

* Create other.md

* Create legal-request.yml

* Rename legal-request.yml to legal-request.md

* Update bug_report.md

* sgsfdh

* saga

* stub license

* Initial configuration

Co-authored-by: @Klairm <ivangardis@hotmail.com>
- Thanks for C contrib!
Co-authored-by: @Uniminin <uniminin@zoho.com> 
- Thanks for the contribution of annoyance and python!
Co-authored-by: @JesterOrNot <seanhellum45@gmail.com>
- Thanks for gitpod contrib! https://github.com/RXT0112/Zernit/pull/32
- Thanks for issue-meggage in https://github.com/RXT0112/Zernit/pull/23!
Co-authored-by: dependabot-preview[bot] <27856297+dependabot-preview[bot]@users.noreply.github.com>
2020-03-18 07:23:24 +01:00
..
_includes Master init (#40) 2020-03-18 07:23:24 +01:00
_layouts Master init (#40) 2020-03-18 07:23:24 +01:00
_posts Master init (#40) 2020-03-18 07:23:24 +01:00
gitpod Master init (#40) 2020-03-18 07:23:24 +01:00
lib Master init (#40) 2020-03-18 07:23:24 +01:00
_config.yml Master init (#40) 2020-03-18 07:23:24 +01:00
.gitignore Master init (#40) 2020-03-18 07:23:24 +01:00
.gitpod.yml Master init (#40) 2020-03-18 07:23:24 +01:00
assets.css Master init (#40) 2020-03-18 07:23:24 +01:00
assets.js Master init (#40) 2020-03-18 07:23:24 +01:00
component.json Master init (#40) 2020-03-18 07:23:24 +01:00
index.html Master init (#40) 2020-03-18 07:23:24 +01:00
LICENSE.md Master init (#40) 2020-03-18 07:23:24 +01:00
Makefile Master init (#40) 2020-03-18 07:23:24 +01:00
README.md Master init (#40) 2020-03-18 07:23:24 +01:00
robots.txt Master init (#40) 2020-03-18 07:23:24 +01:00

The "What ?" and the "Why ?"

Carte is a simple Jekyll based documentation website for APIs. It is designed as a boilerplate to build your own documentation and is heavily inspired from Swagger and I/O docs. Fork it, add specifications for your APIs calls and customize the theme. Go ahead, see if we care.

We built Carte because the existing options (Swagger and the likes) were trying to do too much and did not match our needs:

  1. Most of our API calls are sending JSON objects, as opposed to a series of parameters,
  2. Being able to query the real API is nice, but running anything but GET calls can get tricky ("What do you mean I deleted my stuff? I was just trying out the API calls!"),
  3. Overall, setting up a separate server for what really requires a good static documentation seemed overkill.

The real value of Carte is its structure for describing APIs, not its underlying technical stack (or lack-thereof). In a nutshell; we built a static template for your API documentation, feel free to re-use it.

Install

It' Jekyll god dammit:

  1. Clone this repository on your local,
  2. Install Jekyll,
  3. Go at the root of the repository and run jekyll serve --watch,
  4. Go to http://localhost:4000,
  5. Great success! High five!

How to...

Adding a new API call

You can add a new API call by simply adding a new post in the _posts folder. Jekyll by default forces you to specify a date in the file path: it makes us sad pandas too, but you'll have to stick to this format. You can use dates to control the order in which API calls are displayed in the interface.

Each API call can define a few values in its YAML header:

Variable Mandatory Default Description
title Y - A short description of what that calls does.
path N - The URL for the API call, including potential parameters.
type N - Set it to PUT, GET, POST, DELETE or nothing (for parts of your documentation that do not relate to an actual API call).

A typical header:

---
path: '/stuff/:id'
title: 'Delete a thing'
type: 'DELETE'

layout: nil
---

We then describe the request and response (or whatever else you wish to talk about) in the body of our post. Check the placeholders present in the _posts folder to get an idea of what it can look like.

Grouping calls

Adding a category to your YAML header will allows you to group methods in the navigation. It is particularly helpful as you start having a lot of methods and need to organize them. For example:

---
category: Stuff
path: '/stuff/:id'
title: 'Delete a thing'
type: 'DELETE'

layout: nil
---

Edit the design

The default UI is mostly described through the css/style.css file and a couple short jQuery scripts in the /_layouts/default.html layout. Hack it to oblivion.