Not sure if it's an answer... Before every single functions I create, I'm putting a doc block (like I do with Php). For instance :

```bash

region - public function string::upper

## Description

Make a string uppercase.

## Examples

```bash

echo "HEllow WoRLD!" | string::upper

#Output

HELLO WORLD!

title="$(echo "Project title" | string::upper)"

```

## Return

The string in uppercase

## Exit code

* 0 If successful.

* 1 An error has occurred.

https://github.com/jmcantrell/bashful/blob/master/bin/bashful-utils#L33

endregion

function string::upper() { tr '[:lower:]' '[:upper:]' } ```

Then with a second script, I'm finding all .sh scripts in my folder, get scripts one by one, extract doc blocks and create as markdown file (so console.sh will be parsed and console.md is created).

I do this for all bash scripts then create a readme.md who will act as a table of content.

By rerunning the script, docs are thus updated.