Add documentation for git_data_dir change in Gitlab 18

Author: yakatz

REFERENCE.md

@@ -351,6 +351,36 @@ Default value: `undef`
 Data type: `Optional[Hash]`
 
 Hash of git data directories
+**Deprecated**: This option was removed in Gitlab 18.
+
+To configure the storage location for a Gitaly node:
+```patch
+-        git_data_dirs           => {
+-            'default' => { 'path' => '/mnt/example/git-data'},
+-        },
++        gitaly                  => {
++            configuration => {
++                'storage' => [
++                    {
++                        'name' => 'default',
++                        'path' => '/mnt/example/git-data/repositories',
++                    },
++                ],
++            },
++        },
+```
+
+To configure the storage location for other nodes:
+```patch
+-        git_data_dirs           => {
+-            'default' => { 'gitaly_address' => 'tcp://gitaly1.internal:8075'},
+-        },
++        gitlab_rails            => {
++            repositories_storages => {
++                'default' => { 'gitaly_address' => 'tcp://gitaly1.internal:8075'},
++            },
++        },
+```
 
 Default value: `undef`
 

manifests/init.pp

@@ -27,6 +27,37 @@
 # @param git Hash of 'omnibus_gitconfig' config parameters.
 # @param gitaly Hash of 'omnibus_gitconfig' config parameters.
 # @param git_data_dirs Hash of git data directories
+#
+#        **Deprecated**: This option was removed in Gitlab 18.
+#
+#        To configure the storage location for a Gitaly node:
+#        ```patch
+#        -        git_data_dirs           => {
+#        -            'default' => { 'path' => '/mnt/example/git-data'},
+#        -        },
+#        +        gitaly                  => {
+#        +            configuration => {
+#        +                'storage' => [
+#        +                    {
+#        +                        'name' => 'default',
+#        +                        'path' => '/mnt/example/git-data/repositories',
+#        +                    },
+#        +                ],
+#        +            },
+#        +        },
+#        ```
+#
+#        To configure the storage location for other nodes:
+#        ```patch
+#        -        git_data_dirs           => {
+#        -            'default' => { 'gitaly_address' => 'tcp://gitaly1.internal:8075'},
+#        -        },
+#        +        gitlab_rails            => {
+#        +            repositories_storages => {
+#        +                'default' => { 'gitaly_address' => 'tcp://gitaly1.internal:8075'},
+#        +            },
+#        +        },
+#        ```
 # @param gitlab_git_http_server Hash of 'gitlab_git_http_server' config parameters.
 # @param gitlab_ci Hash of 'gitlab_ci' config parameters.
 # @param gitlab_kas Hash of 'gitlab_kas' config parameters.