2025_01: Evaluate Team PSD Manual for Manual Update Procedure

[jamesmrollins]

User Story

As a manual user and member of Team PSD, I need instructions on how to update the gh-pages branch so that it results in an update to the bookdown Team PSD manual. The current instructions are in Chapter 1 Team PSD Manual and Chapter 2 Use and Contribute to Team PSD Manual of the Team PSD Manual.

Acceptance Criteria

• A user-test of the instructions is conducted to determine if they support the manual update use-case.
• Modifications to the instructions are written and illustrated in a clear and articulate manner.
• The Team PSD manual is updated in gh-pages to reflect the changes above.

[lijenn]

Discussed 7/19 Team Praxis Call:

• @jamesmrollins @matomasz @lijenn dispositioned to 2024_10

[lzim]

Cross-ref #550 questions re: #authorship_app section from @retooler
FYI: @matomasz @jamesmrollins @ljmoody @lijenn

[ljmoody]

fyi: Team PSD Manual section 2.3, Contribute to the Manual Using GitHub, is updated with new instructions and screenshots.
A general outline of the information:

Who should perform the user test of the manual? -- #quant_workflow members during the manuscript process(es)?

[lzim]

After we submit the grant I think tester could include
@hnorthcraft
@kmacia
@lijenn

[ljmoody]

Discussed at ad hoc sync up wk3 2025_01
with @matthewtomo & @ljmoody

• A manual update in December included information about the ActionChecker & Editors.
• Another update is needed to document the git branching strategy for all lzim repos (2024_11: DOC git branching strategies, PSD Manual #3301).
• Once 3301 is complete and grants are submitted, user testing is needed to evaluate the Team PSD Manual for accuracy, clarity, and usability.