Deltas Between Versions

General Information

This section provides information about added, removed and deprecated environment variables between two major/minor versions.

To create the changed envvar tables, you must proceed the following steps in order:

Install, if not already done, the converter for adoc to markdown tables: npm install -g downdoc
This is only required when converting adoc to markdown tables but highly recommended!
Run make -C docs docs-generate from the ocis root.
A file named env_vars.yaml is generated. Check for validity. If issues are found, fix them in the service sources first which need to be merged before you rerun make. When the changes are fine, create a PR and merge it. Any delta information is based on an actual env_vars.yaml file which is pull from master by the python script described below!
Configure the Python script docs/helpers/changed_envvars.py variables for the new version.
Note that you must use semver and not code names!
Run the python script from the ocis root such as python3 docs/helpers/changed_envvars.py.
Note that the script pulls data from the master branch only, therefore the env_vars.yaml file MUST be up to date.
adoc tables will be generated which are used for the admin docs and are the basis for markdown.
Because the script can not determine the link target in the Service column, you must manually adapt them in the generated adoc files with respect to the name and target. Only one entry per identical service block is required, delete the cell content for the rest for ease of readability.
Run npx downdoc <filename.adoc> for each of the newly generated added, removed and deprecated files.
Add in each markdown file on top the following sentence:
Note that the links provided in the service column are non functional when clicked. including a newline.
Create a PR and merge it.