The federal developer portal bundles developer resources (documentation, API specifications and code samples) about German government IT systems.
The developer portal bundles developer resources (documentation, API specifications and code samples) about German government IT systems.
The live version is available here: [https://docs.fitko.de](https://docs.fitko.de)
The live version is available here: [https://docs.fitko.de](https://docs.fitko.de)
## How to build
## How to build
To build the federal developer portal locally [yarn package manager](https://yarnpkg.com/) is recommended.
To build the developer portal locally [yarn package manager](https://yarnpkg.com/) is recommended.
### Preconditions
### Preconditions
To install yarn:
To install yarn:
...
@@ -14,7 +14,7 @@ To install yarn:
...
@@ -14,7 +14,7 @@ To install yarn:
npm install--global yarn
npm install--global yarn
```
```
Before proceeding double check if yarn is installed correctly:
Before proceeding, double check if yarn is installed correctly:
```sh
```sh
yarn --version
yarn --version
```
```
...
@@ -25,7 +25,7 @@ yarn install
...
@@ -25,7 +25,7 @@ yarn install
yarn dev
yarn dev
```
```
By default the server provides the portal on [http://localhost:3000](http://localhost:3000)
By default, the server runs on [http://localhost:3000](http://localhost:3000)
### Deployable build
### Deployable build
Build a fully deployable export with:
Build a fully deployable export with:
...
@@ -36,7 +36,7 @@ yarn export
...
@@ -36,7 +36,7 @@ yarn export
The result is stored in a sub folder of project root called `out`.
The result is stored in a sub folder of project root called `out`.
## Continous Integration
## Continous Integration
Every incomming commit triggers our gitlab pipeline. For details check the configuration in the YAML file: `ci/gitlab-ci.yml`. In order to ensure a high code quality, static code analysis are triggert before deployment.
Every incomming commit triggers our gitlab pipeline. For details check the configuration in the YAML file: `ci/gitlab-ci.yml`. In order to ensure a high code quality, static code analysis are triggered before deployment.
Licensing of the files works with a tool called Reuse. As soon as new files are added, the Reuse configuration(`.reuse/dep5`) must be extended accordingly.
Licensing of the files works with a tool called Reuse. As soon as new files are added, the Reuse configuration(`.reuse/dep5`) must be extended accordingly.