Create user.md to store user management content #1051
Conversation
Including sectiosn for: - How to Add a User - How to Create a New User Role - How to Edit Role Permissions
docs/user-documentation/users.md
Outdated
| # Managing Users | ||
|
|
||
| ## How to Add a User | ||
| 1. Log in to Drupal under admin credentials. |
There was a problem hiding this comment.
Suggested change:
Log in to Drupal under admin credentials.
To:
Log in to Drupal. You will need the Administrator role to Manage Users.
docs/user-documentation/users.md
Outdated
| 1. Enter all required fields, as indicated by red asterisks, in the *Add user* page. | ||
| 1. In the *Roles* section, click on the roles that the new user will need. | ||
| - Click on "Administrator" if the new user will need to be able to run adminsitrative tasks in Drupal or Islandora 8. | ||
| - Click on "fedoraAdmin" if the new user will need to be able to run certain tasks in Fedora. This is required by the WebAC authentication so Islandora 8 and Fedora can communicate. |
There was a problem hiding this comment.
Suggested addition:
In the Contact Settings section. Note: the Personal contact form is selected by default.
docs/user-documentation/users.md
Outdated
| To review/edit the permission for each role, in the *People* page click the **Permissions** tab in the set of tabs above the **Add user** button. | ||
|
|
||
| ## How to Create a New User Role | ||
| 1. Log in to Drupal under admin credentials. |
There was a problem hiding this comment.
Same as above:
Log in to Drupal. You will need the Administrator role to edit or add roles.
docs/user-documentation/users.md
Outdated
| 1. Click the blue **Add role** button to bring up the *Add role* page. | ||
|  | ||
| 1. Name the role in a way that it can be disambiguated from related activities or similar groups | ||
| * I.e. use the course code for a particular class of students working on a particular collection. |
There was a problem hiding this comment.
Add period after similar groups.
Change I.e. to For example:
docs/user-documentation/users.md
Outdated
| 1. Click the blue **Save** button. | ||
|
|
||
| ## How to Edit Role Permissions | ||
| 1. Log in to Drupal under admin credentials. |
There was a problem hiding this comment.
Same as above:
Log in to Drupal. You will need the Administrator role to edit permissions.
docs/user-documentation/users.md
Outdated
| 1. Click the **Roles** tab in the set of tabs above the **Add user** button. | ||
|  | ||
| 1. To edit the permissions for a role click the **Edit** dropdown menu to the right of a role and select **Edit Permissions** to bring up the *Edit role* page. | ||
| 1. Scroll down or search for options that have an *Islandora* prefix or contain the word *Islanodra*. For example, *Islandora Access: Create terms*. |
There was a problem hiding this comment.
Spelling:
or contain the word Islanodra change to Islandora
| @@ -0,0 +1,36 @@ | |||
| # Managing Users | |||
There was a problem hiding this comment.
Providing link to this documentation https://www.drupal.org/docs/user_guide/en/user-new-user.html would be useful. Perhaps like:
Further Reading:
|
Thank you @librarychik & @Natkeeran I will work to implementing these changes as soon as I can today or tomorrow. |
|
@librarychik & @Natkeeran how does it look now? |
|
@dannylamb can you give me some feedback on this part of my content quoted below (still don't know how to properly directly quote content from my commits)....
|
|
@ysuarez Circling back around to all the leftover sprint tickets after a long vacay. Thanks for your patience on this one. Instead of "run certain tasks in Fedora" I'd put "write to Fedora". If you want to update that, we'll I'm more than happy to merge. |
|
@dannylamb I just made the change you suggested. Look it over and merge if you approve. |
GitHub Issue: #1040
What does this Pull Request do?
Creates user.md to store user management content
Including sections for:
What's new?
It covers the common steps for managing users in slightly more depth than older content in docs. It mentions the existence of the Drupal role of "fedoraAdmin".
How should this be tested?
A description of what steps someone could take to:
Additional Notes:
I think I need improvements to the content that mentions how the Drupal roles of "Administrator" and "fedoraAdmin" are meant to be used when creating or editing a Drupal user.
Here is what I wrote so far...
Interested parties
@Islandora-CLAW/committers