Contextual Help for Network Admin

[PeteMall]

This is the master ticket for adding contextual help for the network admin screens. See #14435

The following screens are missing contextual help:

• Network Dashboard
• Sites
  • Add New
  • Edit Site
    • Info
    • Options
    • Users
    • Themes
• Users
  • Add New

More to come...

[PeteMall]

Related: #15346, #15376

[andrea_r]

First pass.

[vegasgeek]

Update to site-themes.php

[vegasgeek]

Update to site-options.php

[zeo]

Related to #15346, use "Documentation on X" instead of "X Documentation".

[nacin]

(In [16981]) Network Admin contextual help. props andrea_r (!), see #15314.

[nacin]

Diff off trunk from vegasgeek

[nacin]

Diff off trunk from vegasgeek

[nacin]

(In [16982]) Network admin contextual help edits. props vegasgeek, see #15314.

[nacin]

(In [16983]) Move to 'Documentation on XY' in the network admin. see #15314.

[nacin]

(In [16984]) Network Admin: Rename Options to Settings. Kick the tab to the end as well. see #15314.

[nacin]

(In [16985]) A few more s/site-options/site-settings/. see #15314.

[nacin]

Kicking this back to Andrea, so text, terminology, and Codex links can be updated as appropriate, as a lot has changed.

[andrea_r]

Last minor changes. Everything looks good.

[andrea_r]

not manifesting users this time. ;)

[zeo]

see ​http://core.trac.wordpress.org/attachment/ticket/15346/15346-documentation-on-xy.diff

[nacin]

(In [17015]) Final network admin help tweaks. props andrea_r, fixes #15314.

[SergeyBiryukov]

Fixed one misprint, removed trailing whitespace.

[SergeyBiryukov]

Found one more misprint and some trailing whitespace, see the patch above.

[nacin]

(In [17037]) Network admin contextual help fixes. props SergeyBiryukov, fixes #15314.

[nacin]

Thanks!

[SergeyBiryukov]

Improved wording.

[SergeyBiryukov]

Help on the Settings tab says “See the contextual help on the next tab”, however there are no more tabs. I've changed the string (see the patch). Or should we remove it?

[dougwrites]

The question now is whether we want all four tabs to say, "See the contextual help on the other tabs."?

[nacin]

We reordered them so we need to make sure the third tab (which used to be last) isn't missing the text.

[SergeyBiryukov]

The text is present on the third tab too. What is the best wording then?

[dougwrites]

Option for if we want all the tabs to say, "see the other tabs"

[dougwrites]

@nacin: one advantage of having all four tabs say "see the other tabs" would be if they were ever reordered again with a different one last, that last one would still be accurate.

[dougwrites]

We had a nice little discussion about this a few hours ago, but forgot to re-open the ticket. I think Sergey's latest patch is more necessary than mine, but both are very simple and, in my opinion, an improvement.

[nacin]

Patch is fine. Will handle in the morning.

Sent a note to wp-docs regarding Codex link changes. I think we're going to modify the network admin codex links using a new structure. That'll be the last thing before string freeze tomorrow.

[nacin]

I'm just going to add the same help text across all four tabs.

[nacin]

Oops, wrong ticket reference: [17044]

[nacin]

(In [17045]) Move to what will be the new Network Admin Codex page URLs. see #15314.

[nacin]

(In [17046]) Network-specific language on the plugin and theme editor help tabs. props andrea_r, see #15314.

[SergeyBiryukov]

Replying to nacin:

I'm just going to add the same help text across all four tabs.

“See the other tabs” string is left on the Themes tab. I guess it should be removed for consistency.

[nacin]

(In [17051]) Remove old string. props SergeyBiryukov, see #15314.

[nacin]

What's left:

• A new sentence on plugins.php (when in the network admin) that explains network activation/deactivation.

That's it.

[andrea_r]

What about something like, "Click the Netowrk activate link will activate the plugin on every site. plugin options will still need to be managed on a per-site basis." and the rest of those particulars & gotchas can be codexed.

[nacin]

Should there be a network-specific Codex article to link to in this instance?

[andrea_r]

Now that I think of it yes. It may exist as a blurb somewhere, might not need a whole page.

[andrea_r]

The Users menu needs a line something like "To search for user details, input the full username, or partial text with a wildcard." If it's too late, we can codex it.

[PeteMall]

I'm marking this as fixed after talking to Ryan. Any other details can go in the codex.