[docs-only] Update envvar description

Author: mmattel

Makefile

@@ -169,7 +169,9 @@ docs-generate:
     done
 
 	$(MAKE) --no-print-directory -C docs docs-generate || exit 1
-	cp docs/services/general-info/env-var-deltas/*.adoc docs/services/_includes/adoc/env-var-deltas/
+	# .adoc for admin docs, .md for dev docs
+	cp docs/services/general-info/envvars/env-var-deltas/*.adoc docs/services/_includes/adoc/env-var-deltas/
+	cp docs/services/general-info/envvars/env-var-deltas/*.md docs/services/_includes/adoc/env-var-deltas/
 
 .PHONY: check-env-var-annotations
 check-env-var-annotations:

docs/helpers/README.md

@@ -9,5 +9,5 @@ geekdocFilePath: envvars.md
 
 Environment variables are an essential part of configuring services.
 
-If you are going to create new ones or deprecate existing ones, you must read the [Envvar Naming Scope]({{< ref "services/general-info/envvar-scopes.md" >}}) and the 
-[Deprecating Variables]({{< ref "services/general-info/deprecating-variables.md" >}}) documentation for more details first before doing so.
+If you are going to create new ones or deprecate existing ones, you must read the [Envvar Naming Scope]({{< ref "services/general-info/envvars/envvar-naming-scopes.md" >}}) and the 
+[Deprecating Variables]({{< ref "services/general-info/envvars/deprecating-variables.md" >}}) documentation for more details first before doing so.

docs/helpers/env_vars.yaml

@@ -0,0 +1,2 @@
+!**/_index.md
+

docs/ocis/development/envvars.md

@@ -0,0 +1,15 @@
+---
+title: Environment Variables
+date: 2025-07-03T00:00:00+00:00
+weight: 10
+geekdocRepo: https://github.com/owncloud/ocis
+geekdocEditPath: edit/master/docs/services/general-info/envvars
+geekdocFilePath: _index.md
+geekdocCollapseSection: true
+---
+
+## General Information
+
+This section provides general information how to manage environment variables.
+
+Additionally read the [helper README](https://github.com/owncloud/ocis/tree/master/docs/helpers#readme) for internal details how envvars are managed.

docs/services/general-info/.gitignore

@@ -1,9 +1,9 @@
 ---
 title: "Envvar Deprecation"
 date: 2024-08-22T15:41:00+01:00
-weight: 20
+weight: 15
 geekdocRepo: https://github.com/owncloud/ocis
-geekdocEditPath: edit/master/docs/services/general-info
+geekdocEditPath: edit/master/docs/services/general-info/envvars
 geekdocFilePath: deprecating-variables.md
 ---