This is hackdoc, a documentation rendering tool for monorepos. This is the first code iteration, that can only serve from a local git checkout. The code is incomplete, and is WIP. Change-Id: I68ef7a991191c1bb1b0fdd2a8d8353aba642e28f
1.4 KiB
hscloud
hscloud
is the main monorepo of the Warsaw Hackerspace infrastructure code.
Any time you see a //path/like/this
, it refers to the root of hscloud, ie. the path path/like/this
in this repository. Perforce and/or Bazel users should feel right at home.
Viewing this documentation
For a please web viewing experience, see this documentation in hackdoc. This will allow you to read this markdown file (and others) in a pretty, linkable view.
Getting started
You will need Bash and Bazel (1.2.0+). Clone this repo, cd into it and:
. ./env.sh # setup PATH and hscloud_root
tools/install.sh # build tools
A bunch of common tools will appearify in your $PATH
. You should now be ready to follow other documentation.
This does not pollute your system, and you can work on multiple hscloud checkouts independently.
What now?
If you want to use our Kubernetes cluster to run some stuff, see //cluster/doc/user.
If you're looking for administrative docs about cluster maintenance, see //cluster/doc/admin.
If you want to browse the source of hscloud
in a web browser, use gerrit's gitiles.
If you want to learn how to contribute to this repository, see //doc/codelab/gerrit.