Page Information

Title: Change the permissions for a role
Section: Administering Users
File name: user-permissions.txt
Covers: How to grant or deny permissions

Attribution

<<user-permissions>>::
  Adapted by https://www.drupal.org/u/batigolix[Boris Doesborg] from
  https://www.drupal.org/node/1803614["User Roles"],
  copyright 2000-2015 by the individual contributors to the
  https://www.drupal.org/documentation[Drupal Community Documentation]
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

batigolix’s picture

I am going to give this a shot.

This is for me personally an experiment to figure out how to work with the user guide project, ascii docs, dita writing, the templates andsoforth

batigolix’s picture

Issue summary: View changes
Parent issue: » #2512362: [Meta] Status tracking
batigolix’s picture

Issue summary: View changes
Status: Active » Needs review
FileSize
5.37 KB

Here's a first draft

batigolix’s picture

Issue summary: View changes
jhodgdon’s picture

Status: Needs review » Needs work

Boris, looks pretty good!

A few things to fix before I can commit the patch:

a) We're trying to keep each topic focused on a specific task or a concept. So in the Goal section, let's take out the background stuff. Just say what the end goal is if the reader performs the task (like: a user role gets new permissions or something like that). Also we have a Scenario to use as a specific example.

b) Take the .txt out of the ID at the top of the file -- it should just be user-permissions not user-permissions.txt

c) No blank line between the ID and the title. Not a big deal.

d) Index entries: each entry needs to be separate, like
(((Permissions, granting)))
(((Permissions, changing)))
etc.

e) After you started on this, we changed our guideline on screen shots -- now we decided we want each task topic to have a screen shot. See
https://userguide-drupal.redesign.devdrupal.org/guidelines/good-writing....
section 2.3.4

batigolix’s picture

Status: Needs work » Needs review
FileSize
5.36 KB
1.75 KB
88.98 KB

This addresses point a-e from #5

It isnt clear to me how to include the image in the patch. There isnt an image folder, yet is there?

jhodgdon’s picture

Status: Needs review » Needs work

Thanks Boris!

In the future, can you please upload the .txt file for the topic as well as the (optional) patch? Thanks! See the new shiny instructions on the project page:
https://www.drupal.org/project/user_guide
which also say what to do about images.

Also, there will be an images folder soon, as soon as I commit this patch or one of the other Task topics with images. Git doesn't create directories until there is something in them and there currently isn't anything... But I'm not convinced we actually want binary image files in patches anyway.

Anyway... I could not apply the patch due to changes recently committed. Can you just upload the topic you wrote? Much easier to review for the first draft and easier for me to deal with. Thanks!

Also can you write up the Attributions text in the format we need for the attributions.txt file (also now on the instructions on the project page)?

batigolix’s picture

Issue summary: View changes
batigolix’s picture

Status: Needs work » Needs review
FileSize
1.68 KB

I uploaded the full txt. That is indeed easier than patches.

I also changed the attributions format in the summary

batigolix’s picture

Issue summary: View changes
jhodgdon’s picture

Issue summary: View changes
Status: Needs review » Active

Looks great, thanks! Added to the Guide. Updated status in summary to "done" on writing, and set back to Active on the issue for the next phase.

Note: I'll put this up on the live site shortly but the image doesn't currently display due to #2514626: Images do not display.

jhodgdon’s picture

jhodgdon’s picture

Title: Write/edit user-permissions.txt » Write user-permissions.txt
Issue summary: View changes
Status: Active » Fixed

We decided to use separate issues for each phase of writing/editing.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.