chore(documentation-base): Initial commit with Hugo devcontainer and RELEARN theme installed - just open the devconatiner and start editing!

This commit is contained in:
Stephan Lo (WSL) 2024-07-30 10:10:18 +02:00 committed by Stephan Lo
commit fabab52d8d
202 changed files with 21553 additions and 0 deletions

33
README.md Normal file
View file

@ -0,0 +1,33 @@
# IPCEICIS-DeveloperFramework Documentation
This repo contains business and architectural design and documentation of the DeveloperFramework subproject of IPCEI-CIS.
## How to read and contribute to this documentation locally
The documentation is done in [Hugo-format](https://gohugo.io).
The repo contains a [Hugo `.devcontainer`-defintion](https://containers.dev/) so that you just have to run locally an IDE which is devcontainer aware, e.g. Visual Studio code.
### Installation
To get a locally running documentation editing and presentation environment, follow these steps:
1. open a terminal on your local box
1. Set `REPO=ipceicis-developerframework`
1. Clone this repo: `git clone --recurse-submodules https://bitbucket.telekom-mms.com/scm/ipceicis/${REPO}.git `
1. Change to the repo working dir: `cd ${REPO}`
1. Open the repo in an [Devcontainer-aware tool/IDE](https://containers.dev/supporting) (e.g. `code .`)
1. Start the `devcontainer` (in VSC it's `F1 + Reopen in Devcontainer`)
1. When the container is up & running just open your browser with `http://localhost:1313/`
### Editing
#### Documentation language
The documentation is done in [Releran]-Syntax](https://mcshelby.github.io/hugo-theme-relearn/index.html).
So for editing content just goto the `content`-folder and edit content arrording to the [documentation language spec](https://mcshelby.github.io/hugo-theme-relearn/cont/index.html)
### Commiting
After having finished a unit of work commit and push.