Published
Add the missing step screenshots to "Select the Authenticator"
Apply Diataxis asks that the steps of a How-to be accompanied by suggestive screenshots whenever they help guide the reader through the procedure. Select the Authenticator only carried one, on its result step, while the two steps that move through the interface carried none.
Added:
- Step 2, "Go to Administration then Users & Rights then Authentication" — the administration menu with the "Authentication" entry outlined, beside the section it opens, so the reader sees both the path and where it lands.
- Step 3, "Pick an authenticator in the Authentication service list" — the list itself, outlined.
The result-step capture is retaken. The one that shipped was taken on a stock instance, where the selector does not exist and the section shows "No alternative authentication service can be found." instead — which contradicts the step telling the reader to pick from a list. All three captures come from a local XWiki 17.10.11 with the OpenID Connect Authenticator deployed, so the selector is populated with real authenticators.
The page's FAQ already explains why a stock instance shows only one authenticator, so the screenshots and the FAQ agree.
Only the page content changes; no title, no xobject.
-
Eleni Cojocariu created this Change Request with changes for Select the Authenticator
5 days ago
-
Eleni Cojocariu added a new approval review
5 days ago
-
Eleni Cojocariu changed the status of the Change Request from ready for review
to ready for publication
5 days ago
-
Eleni Cojocariu changed the status of the Change Request from ready for publication
to published
5 days ago
All changes
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (1 modified, 2 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,8 +1,12 @@ 1 1 To choose the [[authenticator>>doc:documentation.xs.admin.authentication.WebHome]] a wiki uses: 2 2 3 3 1. Comment out ##xwiki.authentication.authclass## in the ##xwiki.cfg## file and restart the wiki, because a class named there takes precedence over the choice made in the administration. 4 -1. Go to "Administration" then "Users & Rights" then "Authentication". 5 -1. Pick an authenticator in the "Authentication service" list. 4 +1. Go to "Administration" then "Users & Rights" then "Authentication".((( 5 +{{image reference="authentication-admin-menu.png" size="extra" alt="The Authentication entry of the Users & Rights category of the wiki administration, outlined, beside the section it opens" caption="XWiki 17.10.11"/}} 6 +))) 7 +1. Pick an authenticator in the "Authentication service" list.((( 8 +{{image reference="authentication-service-select.png" size="large" alt="The Authentication service list of the administration section, outlined, and the Save button beside it" caption="XWiki 17.10.11"/}} 9 +))) 6 6 1. Click "Save". 7 7 1. Check that "Current Authentication service" now names the authenticator you picked, as follows:((( 8 8 {{image reference="authentication-service-section.png" size="large" alt="The Authentication service part of the Authentication administration section, with the current authenticator outlined" caption="XWiki 17.10.11"/}}
- authentication-service-section.png
-
- Size
-
... ... @@ -1,1 +1,1 @@ 1 -2 7.6KB1 +29.1 KB - Content
- authentication-admin-menu.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.elenicojocariu - Size
-
... ... @@ -1,0 +1,1 @@ 1 +68.3 KB - Content
- authentication-service-select.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.elenicojocariu - Size
-
... ... @@ -1,0 +1,1 @@ 1 +7.1 KB - Content
