edit-this-documentation.md

Edit this Documentation

Find the table of contents for this documentation on GitHub and navigate to the file you need to update.

Click on the edit pencil on the right side directly above the text to edit this file on your fork of Human Connection (HC).

You can see a preview of your changes by clicking the Preview changes tab aside the Edit file tab.

If you are ready, fill in the Propose file change at the end of the webpage.

After that you have to send your change to the HC basis with a pull request. Here make a comment which issue you have fixed. (If you are working on one of our open issues please include the number.)

Markdown your documentation

To design your documentation see the syntax description at GitBook:

https://toolchain.gitbook.com/syntax/markdown.html

Some quick Examples

Headlines

# Main headline
## Smaller headlines
### Small headlines

Tabs

{% tabs %}
{% tab title="XXX" %}
XXX
{% endtab %}
{% tab title="XXX" %}
XXX
{% endtab %}
…
{% endtabs %}

Commands

```LANGUAGE (for text highlighting)
XXX

#### Links

```text
[https://XXX](XXX)

Screenshots or other Images

![XXX](https://XXX)

Hints for ToDos

{% hint style="info" %} TODO: XXX {% endhint %}

Host the screenshots

Host on Human Connection

{% hint style="info" %} TODO: How to host on Human Connection (GitHub) ... {% endhint %}

Quick Solution

To quickly host the screenshots go to:

https://imgur.com.

There click the green button New post.

Drag the image into the appropriate area.

Right click on it and choose kind of Open link in new tab.

Copy the URL and paste it were you need it.

Screenshot modification

Add an arrow or some other marking stuff

{% tabs %} {% tab title="macOS" %}

In the Preview App

Got to: Menu + Tools (GER: Werkzeuge) + Annotate (GER: Anmerkungen) + etc. {% endtab %}

{% tab title="Windows" %} {% hint style="info" %} TODO: How to modify screenshots in Windows ... {% endhint %} {% endtab %}

{% tab title="Linux" %} {% hint style="info" %} TODO: How to modify screenshots in Linux ... {% endhint %} {% endtab %} {% endtabs %}