split the docs for better create cross page links

.gitignore

@@ -2,3 +2,4 @@ site
 
 .github/styles/*
 !.github/styles/.keep
+.task

README.md

@@ -88,9 +88,12 @@ Use [go-task/task](https://github.com/go-task/task) as pre-configured command se
 task -l  
 
 task: Available tasks for this project:
-* mkdocs:       Start the Mkdocs, for development
-* pre-commit:   Start Precommit
+* mkdocs:start:             mkdocs serve docs
+* pre-commit:install:       install pre-commit into current project
+* pre-commit:start:         run pre-commit with all files
+
 ```
+shared tasks from [nolte/taskfiles](https://github.com/nolte/taskfiles)
 
 ## Links
 

Taskfile.yml

@@ -3,26 +3,14 @@
 version: '3'
 
 vars:
-  PYTHON_VENVS_BASEDIR: ~/.venvs/
-
-  PYTHON_BIN: python3
-  VENVS: .venvs/
+  TASK_COLLECTION_BASE: https://raw.githubusercontent.com/nolte/taskfiles/fix/py-var-names/src
 
 includes:
-  py-dev: ./taskfiles/py-venv-dev.yaml
+  mkdocs: "{{.TASK_COLLECTION_BASE}}/taskfile-include-mkdocs.yaml"
+  pre-commit: "{{.TASK_COLLECTION_BASE}}/taskfile-include-pre-commit.yaml"
 
 tasks:
-  pre-commit:
-    desc: Start Precommit
-    deps: ["py-dev:venv-usage"]
+  default:
     cmds:
-      - pre-commit run -a
+    - task -l
     silent: true
-
-  mkdocs:
-    desc: Start the Mkdocs, for development
-    #deps: ["py-dev:venv-usage"]
-    cmds:
-        - task: py-dev:venv-usage
-      #- mkdocs serve -a localhost:8001
-    silent: false

docs/features/labelling.md

@@ -0,0 +1,33 @@
+
+# Labelling
+
+For Handle PR and Issue Labels use [boring-cyborg](https://probot.github.io/apps/boring-cyborg/) for setting labels by Existing roles, like changes at `./docs` always get the Label `documentations`.
+
+## Usage
+
+```yaml
+{%
+   include "../../.github/boring-cyborg.yml"
+%}
+```
+
+## Labelling rules
+
+```yaml
+{%
+   include "../../.github/commons-boring-cyborg.yml"
+   start="# <!--td-commons-settings-labels-start-->"
+   end="# <!--td-commons-settings-labels-end-->"
+%}
+```
+
+## Existing labels
+
+```yaml
+{%
+   include "../../.github/commons-settings.yml"
+   start="# <!--td-commons-settings-labels-start-->"
+   end="# <!--td-commons-settings-labels-end-->"
+%}
+```
+The labels will be pre-configured by use the [Settings](#project-settings) GitHub Application.

docs/features/mkdocs.md

@@ -0,0 +1,18 @@
+# Publish Docs (mkdocs)
+
+This Action is part of the template Project [nolte/cookiecutter-gh-project](https://github.com/nolte/cookiecutter-gh-project).
+
+## Usage
+
+**TBD**
+
+## Central Configuration
+
+The full Action configuration will be used from a central place.
+
+```yaml
+{%
+   include "../../.github/workflows/reusable-mkdocs.yaml"
+%}
+```
+from `.github/workflows/reusable-mkdocs.yaml`.

docs/features/release.md

@@ -0,0 +1,66 @@
+# Release Process
+
+using [release-drafter/release-drafter](https://github.com/release-drafter/release-drafter) for generate tagged release and generated release artefacts. This Action is part of the template Project [nolte/cookiecutter-gh-project](https://github.com/nolte/cookiecutter-gh-project).
+
+## Usage
+
+
+Two configurations must be created for use. The **GitHub Workflow**, and the **Probot** settings.
+
+### Workflow
+
+```yaml
+---
+name: Release Drafter
+
+on:
+  push:
+    branches:
+      - develop
+
+jobs:
+  update_release_draft:
+    uses: nolte/gh-plumbing/.github/workflows/reusable-release-drafter.yml@v1.1.8
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}
+
+```
+*(from `.github/workflows/release-drafter.yml`)*
+
+### Probot
+
+```sh
+---
+# These settings are synced to GitHub by https://probot.github.io/apps/release-drafter/
+
+_extends: gh-plumbing:.github/commons-release-drafter.yml
+
+```
+*(from `.github/release-drafter.yml`)*
+
+take a look to the release draft from this project:
+
+[![.github/workflows/release-drafter.yml](https://github.com/nolte/gh-plumbing/actions/workflows/release-drafter.yml/badge.svg)](https://github.com/nolte/gh-plumbing/actions/workflows/release-drafter.yml)
+
+## Central Configuration
+
+### Workflow
+
+The full Action configuration will be used from a central place.
+
+```yaml
+{%
+   include "../../.github/workflows/reusable-release-drafter.yml"
+%}
+```
+from `.github/workflows/reusable-release-drafter.yml`.
+
+
+### Probot
+
+```yaml
+{%
+   include "../../.github/commons-release-drafter.yml"
+%}
+```
+from `.github/commons-release-drafter.yml`.

docs/features/settings.md

@@ -0,0 +1,33 @@
+# Project settings
+
+For Central Project Configuration use the [settings](https://probot.github.io/apps/settings/) GitHub App.
+
+This Applications will be handle:
+
+* Default Branch Configuration
+* Project Description, topic etc.
+* Label Colors
+
+
+## Usage
+
+### Probot
+
+```yaml
+_extends: gh-plumbing:.github/commons-settings.yml
+repository:
+  name: cookiecutter-gh-project
+  description: Template for Create Github Workflows and Projects
+  homepage: https://nolte.github.io/cookiecutter-gh-project
+  topics: templating, cookiecutter, github
+```
+
+## Central Configuration¶
+
+### Probot
+
+```yaml
+{%
+   include "../../.github/commons-settings.yml"
+%}
+```

docs/features/static-tests.md

@@ -0,0 +1,10 @@
+# Static Tests (linting)
+
+Generate a base set of workflows for execute Static Tests, like linting.
+
+* [pre-commit/action](https://github.com/pre-commit/action)
+* [zbeekman/EditorConfig-Action](https://github.com/zbeekman/EditorConfig-Action)
+
+## Usage
+
+## Central Configuration

docs/probot.md

@@ -22,58 +22,3 @@ The Reusable configurations prefixed with ```.github/commons-*.yml```.
    start="<!--td-probot-apps-start-->"
    end="<!--td-probot-apps-end-->"
 %}
-
-#### Project settings
-
-For Central Project Configuration use the [settings](https://probot.github.io/apps/settings/) GitHub App.
-
-This Applications will be handle:
-
-* Default Branch Configuration
-* Project Description, topic etc.
-* Label Colors
-
-
-##### Usage
-
-```yaml
-_extends: gh-plumbing:.github/commons-settings.yml
-repository:
-  name: cookiecutter-gh-project
-  description: Template for Create Github Workflows and Projects
-  homepage: https://nolte.github.io/cookiecutter-gh-project
-  topics: templating, cookiecutter, github
-```
-
-#### Labelling
-
-For Handle PR and Issue Labels use [boring-cyborg](https://probot.github.io/apps/boring-cyborg/) for setting labels by Existing roles, like changes at `./docs` always get the Label `documentations`.
-
-##### Usage
-
-```yaml
-{%
-   include "../.github/boring-cyborg.yml"
-%}
-```
-
-##### Labelling rules
-
-```yaml
-{%
-   include "../.github/commons-boring-cyborg.yml"
-   start="# <!--td-commons-settings-labels-start-->"
-   end="# <!--td-commons-settings-labels-end-->"
-%}
-```
-
-##### Existing labels
-
-```yaml
-{%
-   include "../.github/commons-settings.yml"
-   start="# <!--td-commons-settings-labels-start-->"
-   end="# <!--td-commons-settings-labels-end-->"
-%}
-```
-The labels will be pre-configured by use the [Settings](#project-settings) GitHub Application.