-
Improvement
-
Resolution: Unresolved
-
Minor
I am reading the Jenkins credentials plugin user guide to try to understand an issue I'm having with my Jenkins setup, and I am finding it extremely frustrating. The guide is written by someone(s?) who obviously understand the credentials plugin well, and the motivation behind it; unfortunately, it assumes that I want or need to understand everything about the plugin in order to do anything with it. I just want to use the thing, not learn the whys and wherefores of its creation. It has no internal links to facilitate navigation around the document; section headers are difficult to find while scrolling; detailed step-by-step screenshots are put next to overviews.
[JENKINS-57406] credentials plugin user guide is system-centric rather than user-centric
Labels | New: new-permission |
Environment | Original: I am reading the Jenkins credentials plugin user guide to try to understand an issue I'm having with my Jenkins setup, and I am finding it extremely frustrating. The guide is written by someone(s?) who obviously understand the credentials plugin well, and the motivation behind it; unfortunately, it assumes that I want or need to understand everything about the plugin in order to do anything with it. I just want to use the thing, not learn the whys and wherefores of its creation. It has no internal links to facilitate navigation around the document; section headers are difficult to find while scrolling; detailed step-by-step screenshots are put next to overviews. |
Description | New: I am reading the Jenkins credentials plugin user guide to try to understand an issue I'm having with my Jenkins setup, and I am finding it extremely frustrating. The guide is written by someone(s?) who obviously understand the credentials plugin well, and the motivation behind it; unfortunately, it assumes that I want or need to understand everything about the plugin in order to do anything with it. I just want to use the thing, not learn the whys and wherefores of its creation. It has no internal links to facilitate navigation around the document; section headers are difficult to find while scrolling; detailed step-by-step screenshots are put next to overviews. |
Labels | Original: new-permission | New: newbie-friendly |
Labels | Original: newbie-friendly | New: documentation newbie-friendly |
Labels | Original: documentation newbie-friendly | New: documentation |