DOCS-3711

[mpaik]

Clarify different procedure for adding first user admin or root user

[tychoish]

I'm wary of relative references (e.g. step 3) to other parts of content, particularly in includes files. This file is used six different files.

Also I'm not sure that this needs to be inside of a note block. It's not more special than the other items discussed in the file.

You can check for include-file use with the following operation:

$ giza includes graph -f /includes/access-create-user.rst 
{
    "/includes/access-create-user.rst": [
       "/reference/command/createUser.txt", 
       "/reference/method/db.createUser.txt", 
       "/tutorial/add-admin-user.txt", 
       "/tutorial/add-user-administrator.txt", 
       "/tutorial/add-user-to-database.txt"
     ]
 }

[tychoish]

I think it probably makes sense to either put this directly in the tutorial source file or to make a separate include file to include beneath a new heading on the three relevant tutorials.

[mpaik]

Already done, building now to check syntax. It's staying in a note box because it's a gotcha - the information was already inline in the text and was missed by the ticket filer. Re: 'note', your wariness is duly noted (hah!). Unless you want me to nest note boxes, it's staying as it is a gotcha within a gotcha. This may change as we improve the docs milieu around user management, but that's out of scope for a ticket of this size and severity.

[tychoish]

I think it would be more effective and easier to catch if you dropped the note and italicize or bold the section.

(Our movement away from note boxes comes from aje and above.)

[tychoish]

merged