Merge pull request #26 from 21TORR/rad

Document RAD bundle and doctrine change checker

blog/2023-11-21-rad-updates.mdx

@@ -0,0 +1,11 @@
+---
+slug: rad-updates
+title: RAD Bundle Updates
+authors: [jannik]
+tags: [rad]
+---
+
+The [RAD bundle docs] were restructured and the [doctrine change checker] was documented.
+
+[RAD bundle docs]:  /docs/php/symfony/rad
+[doctrine change checker]:  /docs/php/symfony/rad/doctrine#change-checker

blog/authors.yml

@@ -1,5 +1,5 @@
 jannik:
   name: Jannik Zschiesche
-  title: Head of Web
+  title: Tech Lead Web
   url: https://github.com/apfelbox
   image_url: https://github.com/apfelbox.png

docs/php/symfony/rad/doctrine.mdx

@@ -0,0 +1,20 @@
+# Doctrine
+
+
+## Change Checker
+
+The `DoctrineChangeChecker` heuristically checks the current `UnitOfWork` whether any entity updates are scheduled, that are not just `timeModified` updates.
+
+If only time modified updates are scheduled, you can decide to skip the next update steps, like deployments:
+
+```php
+use Torr\Rad\Doctrine\DoctrineChangeChecker;
+
+function test (DoctrineChangeChecker $changeChecker)
+{
+	if ($changeChecker->hasContentChanged())
+	{
+		$this->triggerDeployment();
+	}
+}
+```

docs/php/symfony/rad/index.mdx

@@ -9,6 +9,9 @@ import {LinkList} from "../../../../src/components/Link/LinkList";
 
 The RAD bundle is a Symfony bundle and implements defaults and often used functionality.
 
-## Security
 
-- Automatic integration of security voters to support `CAN_` abilities.
+**Doctrine**
+- [Change Checker](./doctrine#change-checker)
+
+**Security**
+- [Abilities](./security#abilities) (`CAN_` roles)

docs/php/symfony/rad/security.mdx

@@ -0,0 +1,8 @@
+# Security
+
+## Abilities
+
+Abilities act liker roles, but start with a `CAN_` prefix.
+The main idea is that the app only checks abilities and roles (`ROLE_*`) only combine abilities and other roles (via the role hierarchy).
+
+The RAD bundle provides automatic integration of security voters to support `CAN_` abilities.