[TASK] Add Permissions Synchronization chapter to Permissions Management docs

[soee]

No description provided.

[garvinhicking]

Looks good to me! :-)

(Would phrase a few sentences differently, but then again I'm also no native writer)

[garvinhicking]

@linawolf You worked on this with Marcin mainly, can you check if this can be merged?

[linawolf]

@soee we should backport this to TYPO3 v12 and maybe 11?

[linawolf]

@soee please resolve conflicts

[github-actions]

The backport to 11.5 failed:

The process '/usr/bin/git' failed with exit code 1

stderr

error: could not apply c218073... [TASK] Add Permissions Synchronization chapter to Permissions Management docs
hint: After resolving the conflicts, mark them with
hint: "git add/rm <pathspec>", then run
hint: "git cherry-pick --continue".
hint: You can instead skip this commit with "git cherry-pick --skip".
hint: To abort and get back to the state before "git cherry-pick",
hint: run "git cherry-pick --abort".

stdout

Auto-merging Documentation/PermissionsManagement/Index.rst
CONFLICT (content): Merge conflict in Documentation/PermissionsManagement/Index.rst

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-11.5 11.5
# Navigate to the new working tree
cd .worktrees/backport-11.5
# Create a new branch
git switch --create backport-339-to-11.5
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick c2180734093b1275aa8761b727b4bf930c02e102,77b756fb93d16803fc2d5ee4be3a95fb578e8afa
# Push it to GitHub
git push --set-upstream origin backport-339-to-11.5
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-11.5

Then, create a pull request where the base branch is 11.5 and the compare/head branch is backport-339-to-11.5.

[github-actions]

The backport to 12.4 failed:

The process '/usr/bin/git' failed with exit code 1

stderr

error: could not apply c218073... [TASK] Add Permissions Synchronization chapter to Permissions Management docs
hint: After resolving the conflicts, mark them with
hint: "git add/rm <pathspec>", then run
hint: "git cherry-pick --continue".
hint: You can instead skip this commit with "git cherry-pick --skip".
hint: To abort and get back to the state before "git cherry-pick",
hint: run "git cherry-pick --abort".

stdout

Auto-merging Documentation/PermissionsManagement/Index.rst
CONFLICT (content): Merge conflict in Documentation/PermissionsManagement/Index.rst

To backport manually, run these commands in your terminal:

# Fetch latest updates from GitHub
git fetch
# Create a new working tree
git worktree add .worktrees/backport-12.4 12.4
# Navigate to the new working tree
cd .worktrees/backport-12.4
# Create a new branch
git switch --create backport-339-to-12.4
# Cherry-pick the merged commit of this pull request and resolve the conflicts
git cherry-pick c2180734093b1275aa8761b727b4bf930c02e102,77b756fb93d16803fc2d5ee4be3a95fb578e8afa
# Push it to GitHub
git push --set-upstream origin backport-339-to-12.4
# Go back to the original working tree
cd ../..
# Delete the working tree
git worktree remove .worktrees/backport-12.4

Then, create a pull request where the base branch is 12.4 and the compare/head branch is backport-339-to-12.4.