Guides and Documentation developed by and for Tilde Black
Go to file
James Tomasino 17f5e45984 Merge pull request 'ssh-config' (#4) from styan/docs:ssh-config into master 2020-06-11 07:52:31 -04:00
docs Actually add `Configuring SSH' 2020-06-11 08:25:30 +00:00
.gitignore ignore virtualenv directory 2019-07-30 22:55:27 +00:00
README.md contribution updates 2019-07-30 23:47:05 +00:00
activate adding virtualenv and easy-installer 2019-07-30 22:54:52 +00:00
favicon.ico added favicon to docs 2019-08-01 12:59:13 +00:00
mkdocs.yml Add `Configuring SSH' 2020-06-11 08:23:42 +00:00
requirements.txt updated theme 2019-07-30 23:04:32 +00:00

README.md

Tilde Black Documentation

This repository holds the outward facing guides built by users of https://tilde.black.

Local Development

Running the docs

  1. You should have python3 pip3 and virtualenv installed on your system.

  2. Fork this repository & clone it to your system.

  3. Change to the repository directory and run source ./activate to install all the dependencies and activate your virtual environment for python.

  4. Finally, run:

    $ mkdocs serve

This will launch a local running version of the documentation on https://localhost:8000. As you make changes to the documentation your changes will appear in your local server.

To quit your virtual environment just run the command "deactivate" in your shell.

Submitting changes

If you would like to contribute to these guides you do not need an account on tilde.black, but you may benefit from discussion in the private forums on that platform. To contribute, clone this repository, make any desired changes, and submit a pull-request.

If you are a member of tilde.black you can create an ssh key on the system, an account on tildegit.org, and maintain your anonymity by performing the pull-request with that account.

Finally, if you would like to send a patch via email or even just content in markdown via email, you can send that content to fox.