Title: contextual help – Make WordPress Documentation

---

#  Tag Archives: contextual help

 [  ](https://profiles.wordpress.org/drewapicture/) [Drew Jaynes](https://profiles.wordpress.org/drewapicture/)
11:15 pm _on_ February 9, 2013     
Tags: contextual help, [Network Admin ( 2 )](https://make.wordpress.org/docs/tag/network-admin/),
site management   

# 󠀁[Network Help Text: An update + sites.php](https://make.wordpress.org/docs/2013/02/09/network-help-text-an-update-sites-php/)󠁿

On top of everything else, revising the Network Admin help text got kinda of got
pushed to the side. I’m working this weekend to get a better handle on the project.

 1. On the tracking ticket, [#23163](https://core.trac.wordpress.org/ticket/23163),
    I incorporated changes from [@raggedrobins](https://profiles.wordpress.org/raggedrobins/)
    in [the patch](https://core.trac.wordpress.org/ticket/23163#comment:4) for `/network/
    index.php` as [previously discussed](https://make.wordpress.org/docs/2013/01/14/got-the-ball-rolling-on-network-admin-help-text/)
    on make/docs. Note the initials notation in the patch name. I fully intend to get
    credit for contributors, whether they’re making patches or not. So we need to try
    to keep track of that.
 2. On that note, I’m almost finished with my tutorial for making Help Text patches
    in the make/docs handbook. Updates on that soon.
 3. I also took the opportunity today to start additionally working on the `/network/
    sites.php` (Sites) screen help text. The following is the first pass:

**Before:**

> _Tab: Overview_

Add New takes you to the Add New Site screen. You can search for a site by Name,
ID number, or IP address. Screen Options allows you to choose how many sites to 
display on one page.

This is the main table of all sites on this network. Switch between list and excerptExcerpt
An excerpt is the description of the blog post or page that will by default show
on the blog archive page, in search results (SERPs), and on social media. With an
SEO plugin, the excerpt may also be in that plugin’s metabox. views by using the
icons above the right side of the table.

Hovering over each site reveals seven options (three for the primary site):

 * An Edit link to a separate Edit Site screen.
 * Dashboard leads to the Dashboard for that site.
 * Deactivate, Archive, and Spam which lead to confirmation screens. These actions
   can be reversed later.
    Delete which is a permanent action after the confirmation
   screens.
 * Visit to go to the frontend site live.

The site ID is used internally, and is not shown on the front end of the site or
to users/viewers.

Clicking on bold headings can re-sort this table.

**After:**

> _Tab: Overview_

This area of the Administration Screens is used for managing the sites in your MultisiteMultisite
Multisite is a WordPress feature which allows users to create a network of sites
on a single WordPress installation. Available since WordPress version 3.0, Multisite
is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project
was discontinued and its features were included into WordPress core. [Advanced Administration Handbook -> Create A Network.](https://developer.wordpress.org/advanced-administration/multisite/create-network/)
Network.

From here you can:

 * Add, modify or remove sites from your network
 * Search for sites in your network
 * Perform bulk actions on multiple sites at once

> _Tab: Site Management_

The site management screen allows you to modify aspects of one or many of your sites
at once.

**Hovering over each site** reveals seven options (three for the primary site):

 * **Clicking Edit** takes you to a multi-part settings screen for that site
 * **Clicking Dashboard** takes you to the Dashboard screen for that site
 * **Clicking Deactivate, Archive, or Spam** performs the specified action with 
   a confirmation screen
 * **Clicking Delete** deletes a site from your network, following a confirmation
   screen
 * **Clicking Visit** takes you to the front-end view of the site

**Going forward:** It should be noted that from the Sites screen, there is also 
an ‘Add Site’ button in the admin menu and in the headerHeader The header of your
site is typically the first thing people will experience. The masthead or header
art located across the top of your page is part of the look and feel of your website.
It can influence a visitor’s opinion about your content and you/ your organization’s
brand. It may also look different on different screen sizes.. Should that be covered
in some way in the _Overview_ tab?

[#contextual-help](https://make.wordpress.org/docs/tag/contextual-help/), [#network-admin](https://make.wordpress.org/docs/tag/network-admin/),
[#site-management](https://make.wordpress.org/docs/tag/site-management/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2013%2F02%2F09%2Fnetwork-help-text-an-update-sites-php%2F%23respond&locale=en_US)

 [  ](https://profiles.wordpress.org/drewapicture/) [Drew Jaynes](https://profiles.wordpress.org/drewapicture/)
5:36 pm _on_ January 14, 2013     
Tags: contextual help, multisite, [Network Admin ( 2 )](https://make.wordpress.org/docs/tag/network-admin/)

# 󠀁[Got the ball rolling on Network Admin help text](https://make.wordpress.org/docs/2013/01/14/got-the-ball-rolling-on-network-admin-help-text/)󠁿

I’ve submitted changes for the first set of text to be refreshed/rewritten in Network
Admin on the tracking ticket: [#23163](https://core.trac.wordpress.org/ticket/23163)

The hope is to maintain a balance between action and description text.

For the main Network Admin index I propose this initial draft. Feedback is encouraged!

**Before:**

_Tab: Overview:_

Until WordPress 3.0, running multiple sites required using WordPress MU instead 
of regular WordPress. In version 3.0, these applications have merged. If you are
a former MU user, you should be aware of the following changes:

 * Site Admin is now Super Admin (we highly encourage you to get yourself a cape!).
 * Blogs are now called Sites; Site is now called Network.

The Right Now box provides the network administrator with links to the screens to
either create a new site or user, or to search existing users and sites. Screens
for Sites and Users are also accessible through the left-hand navigation in the 
Network Admin section.

**After:**

_Tab: Overview:_

Welcome to your Network Admin. This area of the Dashboard is used for managing all
aspects of your MultisiteMultisite Multisite is a WordPress feature which allows
users to create a network of sites on a single WordPress installation. Available
since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser
project. WordPress MultiUser project was discontinued and its features were included
into WordPress core. [Advanced Administration Handbook -> Create A Network.](https://developer.wordpress.org/advanced-administration/multisite/create-network/)
network.

The menus on the left side allow you to:

 * Add and manage sites or users
 * Install and activate themes or plugins
 * Update your network
 * Modify global network settings

_Tab: Quick Tasks:_

The Right Now widgetWidget A WordPress Widget is a small block that performs a specific
function. You can add these widgets in sidebars also known as widget-ready areas
on your web page. WordPress widgets were originally created to provide a simple 
and easy-to-use way of giving design and structure control of the WordPress theme
to the user. on this screen provides current user and site counts on your network.
New users and sites are easily created by clicking the ‘Create a New Site’ or ‘Create
a New User’ links.

You can also search for any user or site in your network by using the search boxes.
Users can be searched by entering all or part of a username or email address. Sites
are searchable by path or domain, depending on which type of network you have.

[#contextual-help](https://make.wordpress.org/docs/tag/contextual-help/), [#multisite](https://make.wordpress.org/docs/tag/multisite/),
[#network-admin](https://make.wordpress.org/docs/tag/network-admin/)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2013%2F01%2F14%2Fgot-the-ball-rolling-on-network-admin-help-text%2F%23respond&locale=en_US)