ammend some of the English language strings and help text

Much of the help text was out of date or confusing, and some language strings lacked
clarity or conciseness.
Signed-off-by: Evan Goldenberg <evang@catalyst.net.nz>

htdocs/artefact/blog/lang/en.utf8/artefact.blog.php

@@ -31,8 +31,8 @@ $string['pluginname'] = 'Blogs';
 
 $string['blog'] = 'Blog';
 $string['blogs'] = 'Blogs';
-$string['addblog'] = 'Add Blog';
-$string['addpost'] = 'Add Post';
+$string['addblog'] = 'Create Blog';
+$string['addpost'] = 'New Post';
 $string['alignment'] = 'Alignment';
 $string['allowcommentsonpost'] = 'Allow comments on your post.';
 $string['attach'] = 'Attach';

htdocs/artefact/blog/lang/en.utf8/help/pages/index.html

 <h3>My Blogs</h3>
 <p>A blog is journal-like tool that allows you to record your thoughts and experiences.</p>
-<p>By default, your blogs can only be seen by you. By adding a blog to a view you can allow people to read it and post comments.</p>
-<p>You need to create a blog before you can post entries. You can have as many different blogs as you want.</p>
+<p>By default, your blogs can only be seen by you. By adding a blog to a view that is shared with others you can allow people to read it and post comments.</p>
+<p>You can have as many different blogs as you want.</p>

htdocs/artefact/file/lang/en.utf8/artefact.file.php

@@ -72,7 +72,7 @@ $string['fileexistsoverwritecancel'] =  'A file with that name already exists.
 $string['filelistloaded'] = 'File list loaded';
 $string['filemoved'] = 'File moved successfully';
 $string['filenamefieldisrequired'] = 'The file field is required';
-$string['fileinstructions'] = 'Upload your images, documents, or other files for inclusion in views. To move a file or folder, drag and drop it onto a folder.';
+$string['fileinstructions'] = 'Upload your images, documents, or other files for inclusion in views. Drag and drop the icons to move files between folders.';
 $string['filethingdeleted'] = '%s deleted';
 $string['filewithnameexists'] = 'A file or folder with the name "%s" already exists.';
 $string['folder'] = 'Folder';

htdocs/artefact/file/lang/en.utf8/help/pages/groupfiles.html

 <h3>Group Files</h3>
 <p>The group files area is a repository for shared folders and files to use within your group's views.</p>
 <p>You can use drag and drop to organise group files and folders.</p>
-<p>For security reasons your Site Administrator may restrict some file types from being uploaded to the system. </p>
+<p>For security reasons your Site Administrator may restrict some file types from being uploaded. </p>

htdocs/artefact/file/lang/en.utf8/help/pages/index.html

@@ -2,4 +2,4 @@
 <p>Your files area is a repository for folders and files to use within your portfolio.</p>
 <p>The number of files you may upload into your files area is dependant on your set file storage limit which is displayed in the quota box on the right of the screen.</p>
 <p>You can use drag and drop to organise your files and folders.</p>
-<p>For security reasons your Site Administrator may restrict some file types from being uploaded to the system. </p>
+<p>For security reasons your Site Administrator may restrict some file types from being uploaded. </p>

htdocs/artefact/file/lang/en.utf8/help/pages/profileicons.html

@@ -5,15 +5,15 @@
 </p>
 <p>
     You may have up to 5 icons in your Profile Icons area at once. Images you
-    upload need to be at least 16x16 pixels big. The images you upload count
-    towards your file quota.
+    upload must be at least 16x16 pixels and no greater than 1024x1024 pixels.
+    The images you upload count towards your file quota.
 </p>
 <p>
-    Your default image will be shown to other people beside your name, and you
-    may use the other images in views you create.
+    Your default icon will be shown to other people beside your name around the
+    site, and you may use the other images in the views you create.
 </p>
 <p>
-    <strong>Note:</strong> All of your profile icons are accessable by other
-    logged in users even if they are not currently your default, so delete them
-    if you do not want others to see them.
+<strong>Note:</strong> All of your profile icons (not just the default one)
+    can be accessed by other logged in users. Delete them if you do not want
+    others to see them.
 </p>

htdocs/artefact/internal/index.php

@@ -196,7 +196,7 @@ function get_desired_fields(&$allfields, $desiredfields, $section) {
     $return["{$section}description"] = array(
         'type'  => 'html',
         'labelhtml' => ($section == 'about') ? '<div id="profileicon"><a href="' . get_config('wwwroot') . 'artefact/file/profileicons.php"><img src="' . get_config('wwwroot') . 'thumb.php?type=profileicon&maxsize=100&id=' . intval($USER->get('id')) . '" alt=""></a></div>' : '',
-        'value' => get_string("{$section}description", 'artefact.internal')
+        'value' => get_string('infoisprivate', 'artefact.internal')
     );
     foreach ($desiredfields as $field) {
         if (isset($allfields[$field])) {

htdocs/artefact/internal/lang/en.utf8/artefact.internal.php

@@ -35,9 +35,7 @@ $string['myfiles'] = 'My Files';
 $string['mandatory'] = 'Mandatory';
 $string['public'] = 'Public';
 
-$string['aboutdescription'] = 'Enter your real first and last name here. If you want to show a different name to people in the system, put that name in as your display name.';
-$string['contactdescription'] = 'All of this information is private, unless you choose to put it in a view.';
-$string['messagingdescription'] = 'Like your contact information, this information is private.';
+$string['infoisprivate'] = 'This information is private until you include it in a view that is shared with others.';
 $string['viewmyprofile'] = 'View my profile';
 
 // profile categories

htdocs/artefact/internal/lang/en.utf8/help/pages/index.html

 <h3>My Profile</h3>
-<p>Each of the profile fields are separate artefacts, which may be independently added to a view. Some of these fields might not be editable. They have been locked by the site administrator for user identification.</p>
+<p>Some of these fields might not be editable. They have been locked by the site administrator.</p>
 <p><strong>Warning:</strong> Consider your personal security before releasing contact information on a publicly available view.<p>

htdocs/artefact/resume/index.php

@@ -163,7 +163,6 @@ $personalinformationform = pieform(array(
                         ? $personalinformation->get_composite('dateofbirth') : null),
                     'title' => get_string('dateofbirth', 'artefact.resume'),
                     'description' => get_string('dateformatguide'),
-                    'help'  => true,
                 ),
                 'placeofbirth' => array(
                     'type' => 'text',

htdocs/artefact/resume/lang/en.utf8/help/forms/coverletter.coverletterfs.html

 <h3>Cover Letter</h3>
-<p>The Cover Letter area allows you to create a message for those users reviewing your Résumé.  Using the HTML editor you can format the Cover Letter as required.</p>
+<p>The Cover Letter section allows you to create a message for those users reviewing your Résumé.  Using the HTML editor you can format the Cover Letter as required.</p>

htdocs/artefact/resume/lang/en.utf8/help/forms/interests.interestsfs.html

 <h3>Interests</h3>
-<p>The Interests sub-section allows to list your personal and/or professional interests.  This might include your hobbies, sporting activities, volunteer work, areas of research and expertise etc.  Listing your Interests will help employers form a better picture of who you are and what you would bring to their organisation.</p>
+<p>The Interests section allows to list your personal and/or professional interests.  This might include your hobbies, sporting activities, volunteer work, areas of research and expertise etc.  Listing your Interests will help employers form a better picture of who you are and what you would bring to their organisation.</p>

htdocs/artefact/resume/lang/en.utf8/help/forms/personalinformation.dateofbirth.html

-<h3>Date of Birth</h3>
-<p>You can either enter in the required date using the format YYYY/MM/DD (Year/Month/Day) or use the calendar to select an auto-insert date.</p>

htdocs/artefact/resume/lang/en.utf8/help/pages/goals.html

 <h3>My Goals</h3>
-<p>The goals area is divided into three sections: Personal, Academic and Career. Using the HTML editor within each box, you can create goal description artefacts. These may be added to your views.</p>
+<p>The goals area is divided into three sections: Personal, Academic and Career. Goals added here may be included in your views.</p>
 <p>Personal or career goals are often provided in résumés so that employers can understand how a particular role might suit your ambitions.</p>
 <p>You can also use the academic goals section to describe achievements you are seeking in your programme of study.</p>
 <p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the page.</p>

htdocs/artefact/resume/lang/en.utf8/help/pages/index.html

 <h3>My Résumé</h3>
-<p>The résumé area allows you to build an online résumé or CV. This area is divided into two sections – one for entering general information and one for details of your experience and qualifications.</p>
-<p>To view or hide the four sub-sections in general information, click on the arrowed sub-section name.</p>
+<p>The résumé area allows you to build an online résumé or CV.</p>
 <p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the section.</p>

htdocs/artefact/resume/lang/en.utf8/help/pages/skills.html

 <h3>My Skills</h3>
-<p>The skills area is divided into three sections: Personal, Academic and Work. Using the HTML editor within each box, you can create goal description artefacts. These may be added to your views.</p>
-<p>Employers are always interested in what skills you can bring to a role. You can also use this section to display what attributes would bring to a collaborative community or working group.</p>
+<p>The skills area is divided into three sections: Personal, Academic and Work. Skills added here may be included in your views.</p>
+<p>Employers are always interested in what skills you can bring to a role. You can also use this section to display the attributes that you would bring to a collaborative community or working group.</p>
 <p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the page.</p>

htdocs/artefact/resume/lang/en.utf8/help/sections/addbook.html

 <h3>Books and Publications</h3>
-<p>List any publications you have written or contributed to in any role such as editor or designer. Entries display in reverse chronological order. Click ‘Add’ to put in an entry. Use ‘Cancel’ to close the ‘Add’ section without saving your entry.</p>
-<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the section.</p>
-<p>New saved entries display in your résumé in the tabular format. Change your entry by clicking <span style="text-decoration:underline">Edit</span>. Remember to ‘Save’ your changes, then click <span style="text-decoration:underline">Back to My Résumé</span> to return to main screen. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
+<p>List any publications you have written or contributed to in any role such as editor or designer. Click ‘Add’ to enclude a new entry. Use ‘Cancel’ to close the form without saving your entry.</p>
+<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the form.</p>
+<p>Entries are displayed a tabular format. Change an entry by clicking <span style="text-decoration:underline">Edit</span>. When you are finished, save your changes to return to this page. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
 <p>If you have provided a publication description, click your title to view or hide this information.</p>

htdocs/artefact/resume/lang/en.utf8/help/sections/addcertification.html

 <h3>Certifications, Accreditations and Awards</h3>
 <p>List any certifications, accreditations or awards you have received; eg: Chartered Accountant, Registered Nurse, or First Aid Certificate.</p>
-<p>Entries display in reverse chronological order. Click ‘Add’ to put in an entry. Use ‘Cancel’ to close the ‘Add’ section without saving your entry.</p>
-<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the section.</p>
-<p>New saved entries display in your résumé in the tabular format. Change your entry by clicking <span style="text-decoration:underline">Edit</span>. Remember to ‘Save’ your changes, then click <span style="text-decoration:underline">Back to My Résumé</span> to return to main screen. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
+<p>Click ‘Add’ to include a new entry. Use ‘Cancel’ to close the form without saving your entry. If you have more than one entry, use the arrows to order them as you choose.</p>
+<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the form.</p>
+<p>Entries are displayed in a tabular format. Change an entry by clicking <span style="text-decoration:underline">Edit</span>. When you are finished, save your changes to return to this page. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
 <p>If you have provided an award description, click your award title to view or hide this information.</p>

htdocs/artefact/resume/lang/en.utf8/help/sections/addeducationhistory.html

 <h3>Education History</h3>
-<p>This section allows you to create a record of your academic qualifications. Entries display in reverse chronological order. Click ‘Add’ to put an entry into your education history. Use ‘Cancel’ to close the ‘Add’ section without saving your entry.</p>
-<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the section.</p>
-<p>New saved entries display in your résumé in the tabular format. Change your entry by clicking <span style="text-decoration:underline">Edit</span>. Remember to ‘Save’ your changes, then click <span style="text-decoration:underline">Back to My Résumé</span> to return to main screen. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
+<p>This section allows you to create a record of your academic qualifications. Click ‘Add’ to put an entry into your education history. Use ‘Cancel’ to close the form without saving your entry. If you have more than one entry, use the arrows to order them as you choose.</p>
+<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the form.</p>
+<p>Entries are displayed in a tabular format. Change an entry by clicking <span style="text-decoration:underline">Edit</span>. When you are finished, save your changes to return to this page. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
 <p>If you have provided a qualification description, click your qualification name to view or hide this information.</p>

htdocs/artefact/resume/lang/en.utf8/help/sections/addemploymenthistory.html

 <h3>Employment history</h3>
-<p>This section allows you to create a record of your work experience. Entries display in reverse chronological order. Click ‘Add’ to put an entry into your employment history. Use ‘Cancel’ to close the ‘Add’ section without saving your entry.</p>
-<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the section.</p>
-<p>New saved entries display in your résumé in the tabular format. Change your entry by clicking <span style="text-decoration:underline">Edit</span>. Remember to ‘Save’ your changes, then click <span style="text-decoration:underline">Back to My Résumé</span> to return to main screen. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
-<p>If you have provided a position description, click your position name to view or hide this information.</p>
+<p>This section allows you to create a record of your work experience. Click ‘Add’ to put an entry into your employment history. Use ‘Cancel’ to close the form without saving your entry. If you have more than one entry, use the arrows to order them as you choose.</p>
+<p><strong>Note:</strong> It is important to save each new entry using the button at the foot of the form.</p>
+<p>Entries are displayed in a tabular format. Change an entry by clicking <span style="text-decoration:underline">Edit</span>. When you are finished, save your changes to return to this page. Click <span style="text-decoration:underline">Delete</span> to remove entries.</p>
+<p>If you provided a position description, click the position name to view or hide this information.</p>