Help:Orientation and Training Guide

From KNEXT

Account Creation

For the purposes of this prototype account creation is open to anyone with an email address. Create your account by visiting the account creation page.

In an enterprise setting account creation can be restricted to IT admin with access to the site backend and can be managed through the MediaWiki API if editing roles will be restricted to authorized users.

New Page Creation

Please see the step-by-step guide for creating new pages in this guide.

See more information about structuring the pages with namespace here.

Best Practices

Questions

Namespace: Questions

When to add a new question

  1. Check if a question exists by looking at the questions category
  2. To add a new question, create a link or type in the url new page in the Question namespace. This can be done by adding a link The namespace precedes the question with the format of "Question:"

How to add a new question

For consistency of linking the recommended steps for adding a new question

Quick Question Add - Add to the Question Queue

If you don't have time to complete the checklist for adding a question page, queue the question by adding it as redlinked text on [Help:Questions to be Added |Questions Queue].

Adding a Question Checklist

  1. Add the questions as a redlink
  2. To add a new question, create a link or type in the url new page in the Question namespace. This can be done by adding an internal Wiki link to a page which are page names with the format of "Question:".
  3. Add the Help:Question template to the page
  4. Fill in the template sections and make sure to link to relevant questions so you're not creating an orphan page.
  5. Add the Template:Review Request to the top of the question page. (not yet implemented)
  6. Add a comment for what you added and save the changes for the page
  7. Return to the [Help:Questions to be Added |Questions Queue] and the link should not be red (you may need to refresh the tab). If this is true, you are done.

When to Split Questions

Questions will be a fluid discussion on how to best handle, but one where the triggering action is when there may be enough material on a specific subset of that questions that you might create a subpage for a specific topic. The format of question or page name and adding a focus area in parenthesis. Example: Who are my competitors? (Competitive Analysis)

Resources

Namespace: Resources Resources are the "thing" that might help a person answer their question or might be a good person, organization, or place to handoff the user to get further information on their question. Items in catalogues, databases, websites, people, organizations are examples of resources.

Guides

Namespace: Main These pages are orientation and aggregation pages on topics that are commonly asked and useful to compile as a collection of questions and resources, but are broader than a specific question. These may setup how to think about a specific topic or broader subject.

Retrieved from "https://wiki.knext.io/index.php?title=Help:Orientation_and_Training_Guide&oldid=519"