[ADF-4152] Updated folder structure of core docs (#4415)

* [ADF-4152] Moved core library docs into subfolders

* [ADF-4152] Moved core library docs into subfolders

* [ADF-4152] Manual fixes to core doc file links

* [ADF-4152] Further automatic + manual link tidying

docs/core/services/auth-guard-sso-role.service.md

@@ -0,0 +1,56 @@
+---
+Title: Auth Guard SSO Role service
+Added: v3.1.0
+Status: Active
+---
+
+# [Auth Guard SSO role service](../../../lib/core/services/auth-guard-sso-role.service.ts "Defined in auth-guard-sso-role.service.ts")
+
+Allow to check the user roles of a user
+
+## Details
+
+The [Auth Guard SSO role service](../../core/services/auth-guard-sso-role.service.md) implements an Angular
+[route guard](https://angular.io/guide/router#milestone-5-route-guards)
+to check the user has the right role permission. This is typically used with the
+`canActivate` guard check in the route definition. The roles that user needs to have in order to access the route has to be specified in the roles array as in the example below:
+
+```ts
+const appRoutes: Routes = [
+    ...
+    {
+        path: 'examplepath',
+        component: ExampleComponent,
+        canActivate: [ AuthGuardSsoRoleService ],
+        data: { roles: ['USER_ROLE1', 'USER_ROLE2']}
+    },
+    ...
+]
+```
+
+If the user now clicks on a link or button that follows this route, they will be not able to access to this content if the user does not have the roles.
+
+## Redirect over forbidden
+
+If the you want to redirect the user to a different page over a forbidden error you can use the **redirectUrl** as the example below:
+
+```ts
+const appRoutes: Routes = [
+    ...
+    {
+        path: 'examplepath',
+        component: ExampleComponent,
+        canActivate: [ AuthGuardSsoRoleService ],
+        data: { roles: ['ACTIVITI_USER'], redirectUrl: '/error/403'}
+    },
+    ...
+]
+```
+
+Note: you can use this Guard in and with the other ADF auth guard.
+
+## See also
+
+-   [Auth guard ecm service](auth-guard-ecm.service.md)
+-   [Auth guard bpm service](auth-guard-bpm.service.md)
+-   [Auth guard service](auth-guard.service.md)