DRAFT: F permission docs

Summary

For https://gitlab.indiscale.com/caosdb/internal/all/-/issues/598. Extends and improves the explanation on permissions.

Focus

Check whether the new/updated explanations make sense. Also make sure that the link to the new code-gallery example in pylib is updated correctly after caosdb-pylib!64 (merged) has been merged.

Test Environment

make doc

Check List for the Author

Please, prepare your MR for a review. Be sure to write a summary and a focus and create gitlab comments for the reviewer. They should guide the reviewer through the changes, explain your changes and also point out open questions. For further good practices have a look at our review guidelines

• All automated tests pass
• Reference related issues
• Up-to-date CHANGELOG.md (or not necessary)
• Annotations in code (Gitlab comments)
  • Intent of new code
  • Problems with old code
  • Why this implementation?

Check List for the Reviewer

• I understand the intent of this MR
• All automated tests pass
• Up-to-date CHANGELOG.md (or not necessary)
• The test environment setup works and the intended behavior is reproducible in the test environment
• In-code documentation and comments are up-to-date.
• Check: Are there specifications? Are they satisfied?

For further good practices have a look at our review guidelines.