PetroWiki - The Moderator's Guide

Moderator’s Guide

3

Introduction ………………………………………………...

Log In Steps ………………………………………………….

Toolbox …………………………………………………………

Moderating Task List …………………………………….

Who and What are you Moderating? ………….

Approving or Rejecting ………………………………..

Changes ……………………………………………………….

OnePetro …………………………………………………….

Helpful Links ………………………………………………..

Page 4

Page 5

Page 6

Page 7-12

Page 13-14

Page 15-17

Page 18-25

Page 26-30

Page 31

In 2012, SPE launched the pilot for PetroWiki (www.petrowiki.org), our effort to convert the Petroleum Engineering Handbook (PEH) into an evergreen resource that can be updated by members.

As SPE began building PetroWiki, we decided that it was important for the protection of SPE’s technical reputation that the wiki be moderated. Contributions from SPE members are reviewed by at least two members with expertise in the subject matter before they are approved and can be viewed publicly.

The volunteer commitment to serve as a moderator for PetroWiki is modest, but it is a crucially important role in terms of making sure that the technical information in PetroWiki is accurate.

While more contributions will mean more work for moderators, our experience to date tells us that volunteers spend less than one hour per week as PetroWiki moderators.

Thank you for your commitment to this valuable resource.

4

5

1. Access the PetroWiki at www.petrowiki.org

2. Log in using your SPE membership login

3. You are now logged in to PetroWiki

Click Log in

Login here

Initial Steps to Access the Moderator’s Area

See Y

our Nam

e

1. Locate the TOOLBOX

It is listed on the left hand side toolbar.Click the Toolbox to expand the menu.

Click To

olbox

The Moderator’s Area

2. Locate the MODERATION link.

The link is listed under the Toolbox.

Click the Moderation link to access the current edits that need to be updated, corrected,

approved, or rejected.

6

Select Moderation

Expanded Menu

Moderating Task List

Moderator Task List

For more information see: PetroWiki Help

No pending tasks

Pending tasks

8

9

Moderator Task ListActive Pages

Idle Pages

These are active/pending pages: You will need to approve or reject.

These are idle pages you have approved or rejected. The page(s) are now waiting for final approval or rejection.

For more information see: PetroWiki Help

10

Moderator Task List

These are your assigned pages that have been updated and are ready for approval or rejection.

This is the lapsed time since the edit.

These are your co-moderators.

Reflects time lapse of your actions.

Public Page to discuss the page.

Active Pages

For more information see: PetroWiki Help

11

Moderator Task List

Page(s) you have approved or rejected. The page is now in idle waiting for your co-moderators to approve or reject.

These are your co-moderators and their

actions.

Reflects time lapse of actions.

Public Page to discuss the page.

Idle Pages

For more information see: PetroWiki Help

12

Moderator Task List

You also have the option to scroll down this same page to make edits and then save.

SelectApprove or Reject

Select an edited page to view the moderation

screen.

The green shaded area is the updated content.

Updated by:

For more information see: PetroWiki Help

Who and What are you Moderating?

14

Community of Users

As a moderator, look for errors or limited content:

Limited or no citations (add or expand using external sources such as OnePetro.)

Accurate information (correct with consideration of other points of view.)

Appropriate information(remove inappropriate or misinformation.)

Current information(update outdated information, links, and images.)

Promotion or Advertisements(Organizational, individual, or product advertisements are not allowed)

1. Logging in.2. Adding, deleting, and/or updating

content.3. Completing the acknowledgments page.4. Saving the changes.

Novice to Expert

PetroWiki contributors are asked to add to the wiki by:

For more information see: PetroWiki Help

Approving or Rejecting

16

Approving

Moderators can APPROVE any updates that have any of the following.

Look for errors or limited content:

You are not alone in moderating content. Each area is overseen by at least two moderators.

Once updated content is approved the same task is sent to a second moderator.

References or citations (APPROVE) Accurate information (APPROVE) Appropriate information (APPROVE) Current information (APPROVE) Promotion or Advertisements (APPROVE only with EDIT)

For more information see: PetroWiki Help

17

Rejecting

Moderators can REJECT updates that have any of the following. Inaccurate information (REJECT) Inappropriate information (REJECT)

You are not alone in moderating content. Each area is overseen by at least two moderators.

An explanation form is generated when updated content is rejected by a moderator. The task is then transferred to the next moderator.

REJECT

Outdated information (REJECT) Promotion or Advertisements (REJECT)

The rejecting moderator is not identified to the user.

For more information see: PetroWiki Help

Changes

Making Changes: Basics

Edit Content

Content is easy to correct and update. A toolbar is provided with bold, Italics, advanced, special characters, headings,

images and links.

Preview Content

Preview tab

Edit tab

For more information see: PetroWiki Help 19

Making Changes: Basics

Finalizing Changes

All users are required to agree to the acknowledgements page before changes can be saved.

Preview Content

Changes tab

The “Save page” button will not become active until the first three acknowledgments are checked or the “minor edit” box is selected.

Minor edit = Grammar or spelling corrections.

For more information see: PetroWiki Help 20

Making Changes: Wikitext

INTERNAL[[PageName|Title]] is a link to another wiki page.

Example view in EDIT: Content in PetroWiki is [[PetroWiki:Moderation|moderated]] by at least two members with subject matter expertise.Example view in PREVIEW:Content in PetroWiki is moderated by at least two members with subject matter expertise.

EXTERNAL[URL|Title] is a link an external website.

Example view in EDIT: Content in [[http://www.petrowiki.org|PetrowWiki]] is by at least two members with subject matter expertise.Example view in PREVIEW:Content in PetroWiki is moderated by at least two members with subject matter expertise.

*Be sure to add the pipe (|) between the PageName/URL and the Title.

LINKS

LISTS

Example bulleted listUsing * Result

* Oil* Gas* Water

• Oil• Gas• Water

Example numbered listUsing # Result

# Oil# Gas# Water

1. Oil2. Gas3. Water

For more information see: PetroWiki Help 21

Making Changes: Wikitext

For each reference that appears, you will need to name it (give it a number) and put the following code around it so that it maybe linked to in the text.

<ref name="r1">Reference citation goes here</ref>

Increment r1, r2, r3, etc. for successive references. The numeric part will be the number that will appear when you add the footnote in the text.

If you are adding a new reference at the end of an existing list, look at the last r#, add one and create your <ref name=rX></ref> around the citation to the document you are referencing.

At the end of the relevant phrase, sentence, or paragraph enter the following:

<ref name="rX" />

where X is the number of the reference for that footnote. If the same document is referenced multiple times in the text, you can use the same tag at each text location that points to that document.

References

Footnotes

Successive numbering is NOT automatically generated.

22For more information see: PetroWiki Help

Making Changes: Headings

Headings are important in the creation of the

Table of Contents

Heading levels are important in proper organization of all

Petrowiki content

23For more information see: PetroWiki Help

=Title Page (Level 1)=

Level 1 is reserved for the Title Page only.Never use Level 1 unless otherwise instructed

by PetroWiki administrators.

==Heading (Level 2)==

Use Level 2 for main headings

===Sub Heading (Level 3)===

Use Level 3 for sub headings (Notice its green for emphasis)

====Sub Heading (Level 4)====

Use Level 4 for the subheading of Level 3

=====Sub Heading (Level 5)=====rarely used

======Sub Heading (Level 6)======rarely used

Adding an “=“ before and after text will create headings.

Example

Making Changes: Headings

24For more information see: PetroWiki Help

These are:Level 2 headings

== Function of a facility ==

These are:Level 3 headings

=== Main process ====== Secondary process ===

These are:Level 4 headings

==== Sales and disposal ====

Level 2 headings create distinct section breaks using a

line break.

Each heading level has an [edit] for added ease of use.

Making Changes: Headings

25For more information see: PetroWiki Help

Adding OnePetro

OnePetro Articles: Why

OnePetro is one of the most comprehensive resources available on upstream oil and gas. Adding OnePetro articles will assist industry

professionals in finding relevant answers to technical questions.

OnePetro is an online library of technical literature for the oil and gas exploration and production (E&P) industry. It contains more than 145,000 documents produced by 18 publishing partners.

27For more information see: PetroWiki Help

OnePetro Articles: WhereEvery PetroWiki Page has the following sections:

Topic TitleOverview and/or Subject Content

ReferencesSee also

Noteworthy papers in OnePetroExternal links

28

Insert the OnePetro citation(s) here.

For more information see: PetroWiki Help

OnePetro Articles: HowLocate an article from OnePetro (www.onepetro.org)

NO PERIOD

at the end.

The DOI number will be listed on the “Document Preview” window within the OnePetro just above the title to the right.

http://dx.doi.org/ _ _ _ _ _ _

29For more information see: PetroWiki Help

30

You can’t break the PetroWiki.Wikis keep track of all changes, so virtually everything can be rolled back, undone, or redone etc.

Be Brave

History

Need Practice?

There is a page titled “Sandbox” under the help topics where you can try things out if you want practice or need to test how things work together.

http://www.petrowiki.org/Sandbox

31

PetroWiki Contacts:PetroWiki Email – [email protected] Office222 Palisades Creek Drive Richardson, Texas 75080+1.972.952.9393+1.800.456.6863 (Toll-free in the US and Canada)Hours: 0730 to 1700 CST (GMT–5), Mon-Fri

PetroWiki – http://www.petrowiki.org

PetroWiki Help – http://tinyurl.com/petrowikihelp

PetroWiki Tutorials:Slideshare – PowerPoint – http://www.slideshare.net/speinnovationsYouTube - Video – http://www.youtube.com/user/2012SPE

PetroWiki Practice Zone: Sandbox – http://www.petrowiki.org/Sandbox

Wikipedia – http://www.wikipedia.org/

Helpful Resources

Helpful Links

Moderator’s Guide