Opened 3 years ago
Closed 3 years ago
#54357 closed enhancement (fixed)
Add help tabs in several screens to access their relative documentation
Reported by: | jdy68 | Owned by: | audrasjb |
---|---|---|---|
Milestone: | 5.9 | Priority: | normal |
Severity: | normal | Version: | |
Component: | Help/About | Keywords: | has-patch |
Focuses: | docs | Cc: |
Description
While checking the posts of the HelpHub documentation called via the tab Help in the various screens of the dashboard, I saw several things to improve.
1.In the Plugins Editor Screen, the documentation on the editor of plugin https://wordpress.org/support/article/plugins-editor-screen/ is well put in reference in tab Help, on the other hand it is not the case in the Apparence Editor Screen for the editor of theme https://wordpress.org/support/article/appearance-editor-screen/ which refers towards the documentation Edit files https://wordpress.org/support/article/editing-files/.
2.Help tabs are missing in several screens although a documentation post exists for these screens in HelpHub, we could add a Help tab and place there the link to the corresponding documentation, and a brief description of the screen's functionality as for the other screens in Overview. The help tabs and links to add are:
a.In the Privacy Settings Screen - the documentation Settings Privacy Screen https://wordpress.org/support/article/settings-privacy-screen/
b.In the Site Health Screen - the documentation Site Health Screen https://wordpress.org/support/article/site-health-screen/
c.In the Apparence Customize Screen - the documentation Appearance Customize Screen https://wordpress.org/support/article/appearance-customize-screen/
I propose to add the help tabs in the different screens and/or then place the links to the different documentations in them, as well as a small overview text for the new help tabs.
See screenshots of potential results:
privacy-screen-help-tab.png
site-health-screen-help-tab.png
customizer-add-link-to-help.png
Attachments (5)
Change History (15)
#2
@
3 years ago
- Milestone changed from Awaiting Review to 5.9
- Owner set to audrasjb
- Status changed from new to reviewing
Thanks for opening this documentation ticket and patch. Moving for 5.9 consideration.
#4
@
3 years ago
I didn't check the copy, but it looks like there are some coding standards issues to address Jenny :)
- options-privacy.php
There's an unwanted trailing space in this string:
contains the Privacy Policy of your site. '
and in this one:
and to keep this information current and accurate. '
- site-health.php
Same issue:
status of your installation. '
anything else that requires your attention. ')
(on this one, you also need to add a space before the closing parenthesis)
Also, we need a trailing dot on this string:
to obtain support to solve a problem on your site'
This ticket was mentioned in Slack in #core by abhanonstopnews. View the logs.
3 years ago
This ticket was mentioned in Slack in #core by abhanonstopnews. View the logs.
3 years ago
#8
@
3 years ago
- Keywords needs-copy-review removed
We reviewed the copy in the bug scrub on the about/help page today. The revised wording is below.
Change from: “The Privacy screen allows you to create new page of Privacy Policy for your site or specify existing one which contains the Privacy Policy of your site”
to
"The Privacy screen lets you either build a new privacy-policy page or choose one you already have to show."
Thanks to @johnjamesjacoby who volunteered to do the patch/commit to make the deadline, and
all those who made suggestions for the text revision.
proposed patch