Merge branch 'main' of github.com:abcdesktopio/docs

Author: alexandredevely

opsdocs/docs/4.0/setup/changelog.md

@@ -3,43 +3,31 @@
 
 The prominent changes for this release are:
 
-* The native KDE Plasma inteface with [Win11OS](https://github.com/yeyushengfan258/Win11OS-kde) theme. This change removes the HTML dock and search text area. 
+* The native KDE Plasma inteface with [Win11OS](https://github.com/yeyushengfan258/Win11OS-kde) theme. KDE Plasmashell application replaces the HTML dock and search text area. 
 * Supports hardware accelerated OpenGL and Vulkan on drivers that supports GBM (FOSS drivers and newer Nvidia drivers) with [TigerVNC](https://github.com/TigerVNC/) 1.15.0
-* [abcdesktop.yaml](https://github.com/abcdesktopio/conf/blob/main/kubernetes/abcdesktop-4.0.yaml) file include ConfigMap to customize user's local account files [ '/etc/passwd', '/etc/group', '/etc/shadow', '/etc/gshadow' ]. change file permissions to [ '/etc/shadow', '/etc/gshadow' ]
+* The registry is hosted by gitHub container registry ghcr.io. All images start this this prefix ```ghcr.io/abcdesktopio```. The [abcdesktop.yaml](https://github.com/abcdesktopio/conf/blob/main/kubernetes/abcdesktop-4.0.yaml) yaml file and [od.config](https://github.com/abcdesktopio/conf/blob/main/reference/od.config.4.0) are updated with the prefix.
+* [abcdesktop.yaml](https://github.com/abcdesktopio/conf/blob/main/kubernetes/abcdesktop-4.0.yaml) file include ConfigMap to customize user's local account files [ '/etc/passwd', '/etc/group', '/etc/shadow', '/etc/gshadow' ]
 * [network policies](https://github.com/abcdesktopio/conf/blob/main/kubernetes/netpol-default-4.0.yaml) support Pod application
+* [oc.user](https://raw.githubusercontent.com/abcdesktopio/oc.user/refs/heads/4.0/Dockerfile.ubuntu) image uses ```ubuntu:24.04``` as based image.
 
+## Compatibily support
 
+The abcdesktop applications in format `3.X` (including 3.4) are compatible with abcdesktop application in format `4.0`.
 
-## Compatibily support
+The `4.0` format includes a change for the files `/etc/shadow` and `/etc/gshadow`.
 
-3.4 abcdesktop application format are compatible with 4.0 abcdesktop application.
+- /etc/shadow  -> /etc/localaccount.shadow/shadow
+- /etc/gshadow -> /etc/localaccount.shadow/gshadow
 
-From oc.user.4.0 Dockerfile 
+The symbolic links are linked to the `/etc/localaccount.shadow` volume. Some commands or programs (e.g., su, passwd, adduser and others) access to the shadow file.
+
+If your application need an access to the file '/etc/shadow' or the file '/etc/gshadow', then you have to add this line to your Dockerfile.
 
 ```
-# change passwd shadow group gshadow files
-# create a symlink for each files
-# target are provisioned in dedicated volumes to support ReadOnly, 
-# we can't update files /etc/passwd /etc/group /etc/shadow /etc/gshadow 
-# Note: SubPath is not supported in ephemeral 
-containers
-# Default value :
-# ABCDESKTOP_LOCALACCOUNT_DIR = /etc/localaccount
-
-RUN mkdir -p ${ABCDESKTOP_LOCALACCOUNT_DIR} ${ABCDESKTOP_LOCALACCOUNT_DIR}.shadow && \
-    for f in passwd group ; do \
-	cp /etc/${f} ${ABCDESKTOP_LOCALACCOUNT_DIR} ; \
-	rm -f /etc/${f}; \
-        ln -s ${ABCDESKTOP_LOCALACCOUNT_DIR}/${f} /etc/${f}; \
-    done && \
-    for f in shadow gshadow ; do \
-        cp /etc/${f} ${ABCDESKTOP_LOCALACCOUNT_DIR}.shadow ; \
-        rm -f /etc/${f}; \
-        ln -s ${ABCDESKTOP_LOCALACCOUNT_DIR}.shadow/${f} /etc/${f}; \
-    done
+RUN for f in shadow gshadow ; do if [ -f /etc/$f ] ; then  cp /etc/$f /etc/localaccount.shadow; rm -f /etc/$f; ln -s /etc/localaccount.shadow/$f /etc/$f; fi; done
 ```
 
-If your application need a access to file '/etc/shadow' or '/etc/gshadow', you have to add this line to your Dockerfile 
+The complete lines for a users support with ( passwd, group ) and ( shadow, gshadow ) 
 
 ```
 # Create links for local acccounts