Published
Wiki source code of Add the missing step screenshots to "Select the Authenticator"
Last modified by Eleni Cojocariu on 2026/08/10 22:18
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | [[Apply Diataxis>>https://dev.xwiki.org/xwiki/bin/view/Community/DocGuide/Diataxis/ApplyDiataxis/]] 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>>documentation.xs.admin.authentication.select-authenticator.WebHome]] only carried one, on its result step, while the two steps that move through the interface carried none. | ||
| 2 | |||
| 3 | Added: | ||
| 4 | |||
| 5 | * **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. | ||
| 6 | * **Step 3**, "Pick an authenticator in the Authentication service list" — the list itself, outlined. | ||
| 7 | |||
| 8 | 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>>extensions:Extension.OpenID Connect.OpenID Connect Authenticator.WebHome]] deployed, so the selector is populated with real authenticators. | ||
| 9 | |||
| 10 | The page's FAQ already explains why a stock instance shows only one authenticator, so the screenshots and the FAQ agree. | ||
| 11 | |||
| 12 | Only the page ##content## changes; no title, no xobject. |
