BiomedGT Help: Contributing Content

From BiomedGT

Jump to: navigation, search

This page explains how to submit proposals and participate in discussions. It also provides links to pages that provide help with editing. If you have suggestions for this page, please submit feedback.

Note: The procedures on this page apply to all terminologies except CTCAE_Category. If you are working on the CTCAE project, follow the procedures under Managing CTCAE Proposals (CTCAE Project Only).

Contents

Before You Begin

Although you are welcome to browse and search this wiki, you need to register as a collaborator to perform certain tasks that are detailed on this page. If you want to propose additions or changes to current terminology, see Registration Process for Collaborators.

About the Edit Toolbar

When writing and editing wiki pages, note the following useful features on the Edit toolbar:

  • Icons for bold and italic.
  • A carriage return button for creating a line break in the middle of a paragraph.
  • A signature icon labeled "Your signature with timestamp." Click the icon to append your user name and add a date/time stamp to your comment.

Usage Notes:

  • The Edit toolbar does not include a button for adding bulleted lists. When you need a bulleted list item, type an asterisk (*) at the beginning of a line of text.
  • The check box at the bottom of the text entry box enables you to switch between a syntax-highlighted and standard editor. If your signature is pre-pending rather than appending, make sure that this box is not checked.

A complete description of the Edit toolbar is available at http://meta.wikimedia.org/wiki/Help:Edit_toolbar.

Proposing Changes and Additions to Terminology

If you are a registered BiomedGT collaborator, you can propose changes or additions to BiomedGT. For example, you might suggest changes to such information as preferred names, definitions, synonyms, associations, and parents. You can do this through either a structured or unstructured proposal.

About Structured Proposals

The more formal method of proposing changes and additions is through the submission of a structured proposal. This type of proposal requires that you complete a standardized submission form. You can save and edit the proposal using the same structured form. For more information, see Submitting a Structured Proposal.

About Unstructured Proposals

Before proposing changes, a group of collaborators can start a discussion about the nature of the changes using a discussion page. They can also use this page to make recommendations to the NCI curators who will be integrating content into the BiomedGT or other terminology. A discussion page enables each contributor to add signed, date-stamped comments.

Examples of discussion page content:

  • "You should consider creating the sibling concepts for this concept because we need them in order to..."
  • "We recommend adding a new property X for this concept and all its children to represent Y (give definition and other relevant info)."

Note: Be as specific as possible in your unstructured comments and recommendations.

See Also:

Creating a Structured Proposal

Prerequisite topic: About Structured Proposals

To submit a structured proposal, follow these steps:

  1. Find the concept for which you want to submit a proposal.
  2. Select the concept in the search results list.
    The wiki displays the detail page for the concept.
  3. Ensure that the second tab at the top of the page shows propose changes in red letters and not proposed changes in blue letters.
    If the tab shows proposed changes in blue letters, then someone has already submitted a proposal for this concept.
  4. Click the propose changes tab at the top of the page.
    The LexWiki BGT Form page appears. The tab at the top of the page shows the word special. Note the four tabs: Meta, Lexical, Properties, and Associations.
  5. Complete the fields for each tab using the Structured Proposal Form Reference Page.

See Also: Submitting Proposals

Creating an Unstructured Proposal

Prerequisite topic: About Unstructured Proposals

Note: If you are a CTCAE project user, see Managing CTCAE Proposals (CTCAE Project Only).

To add or contribute to a proposal discussion, follow these steps:

  1. Browse or search for the term that you want to discuss.
  2. Click the discuss tab at the top of the category page for the selected term.
    If a discussion is already in progress, you will see previously entered comments on the discussion page. If no one has added comments, you will immediately see the page title, the Edit toolbar, and a box for typing text. Regardless, you can use the toolbar and text entry box to add your own comments.
  3. Write and edit your comments in the text entry box:
    • Start each bulleted item with an asterisk (*).
    • Surround subheadings with equal signs (=== heading ===)
    • Use the Edit toolbar to add formatting.
      For a complete description of the toolbar buttons, see the following MediaWiki page:
      http://meta.wikimedia.org/wiki/Help:Edit_toolbar
  4. Append your signature to the comments by clicking the Your signature with timestamp button.
  5. Click Save page.
    The most recent comments appear at the top of the page.

Submitting Proposals

Prerequisite topics:

Note: If you are a CTCAE project user, see Managing CTCAE Proposals (CTCAE Project Only).

When you are ready to submit a proposal for consideration, you can submit it as a package. The package can contain only one proposal or several proposals. Once you have submitted a proposal package, your package enters into a workflow process. The process has various stages, each with a status designation that identifies what process stage the package has reached:

  • New
  • Ready to Submit
  • Submitted
  • In Process
  • Completed

To learn more about each status designation, see the Curation Status page.

Creating a Workflow Package

Prerequisite topic: Submitting Proposals

To create a workflow package, follow these steps:

  1. Locate the workflow category on the left navigation bar.
  2. Click the Create / Update Package link.
    The Form:WorkFlow Request page opens.
  3. Enter the name of the new package in the box on the right.
  4. Click Create or Update Package.
    The Add Workflow Request: Workflow:{Package Name} opens.
  5. Select a Priority option.
  6. Add a comment or instructions in the text entry box.
  7. Follow these steps in both the Structured Proposals and Unstructured Proposals sections:
    1. Click Add another.
    2. Enter the proposal name in the Proposal field.
    3. Repeat steps a and b to add more proposals.
  8. Click Save page.
    The WorkFlow:{Package Name} page updates to show details about the package that you just submitted. This page includes the following informtion:
    • Submitter: Your user name
    • Submission date: The submission date in numerical format
    • Priority: The priority level that you assigned
    • Proposal: Concepts included in the package
    • Package status: The current workflow status for the package
    • Facts about {Package Name}: A FactBox showing the workflow component, submission date, priority, and submitted name. The FactBox also provides a link to the RDF feed for the package.
    • Categories: Shows the current status of the package. The initial status is WorkFlow Pending Receipt.

Monitoring the Status of a Workflow Package

Prerequisite topic: Creating a Workflow Package

To monitor the status of your submitted workflow package, follow these steps:

  1. After submitting the package, note the name of the page that identifies the package. The name follows this format: WorkFlow:{Package Name}. You can always return to this page to view the updated status in the Categories area.
  2. View the WorkFlow BiomedGT Proposal page. This page lists all submitted proposals.
  3. (Optional) Use your browser's Find feature to locate your proposal on the page.
  4. Once you locate your proposal in the list, click the proposal name to view the details.
  5. Scroll to the bottom of the details page until you see the Categories area.
  6. Note the WorkFlow CurationStatus designation.

Tip:

Managing CTCAE Proposals (CTCAE Project Only)

Note: The editing suggestions for the structured proposal procedures are for guidance only. The idea is to help reviewers and editors understand your intent. Always include comments to ensure that your intent is clear.

Topics in this section:

Submitting a Structured CTCAE Proposal

To submit a proposal for an adverse event (AE), follow these steps:

  1. Find the concept for which you want to submit a proposal.
  2. Click the Make a proposal link at the bottom of the Tabular tab.
    The adverse event and associated grades are displayed on the Special tab. This tab is read-only, but it is available for reference.
  3. At the bottom of the Special tab, click Add another.
  4. Select a status from the Proposal Status list: Edit Term, Split Term, or New Term:
    • If you want to edit a term (such as changing the AE name or grade names), leave the status set to Edit Term and make the desired change. The change will be interpreted as a replacement for the contents of the corresponding field (AE name or specific grade).
    • If you want to split a term, select Split Term, then create a proposal for each of the new terms. For example, if you want to split Hypersensitivity into Allergic Reaction, Hypersensitivity, and Drug Fever, create three Split Term proposals.
    • If you want to create a new term, select New Term, then indicate any new grades or leave them blank.
    • If you want to leave a term as is, include the AE name in the Adverse Event field, then type No Change in the Comments field.
    • If you want to delete a term, leave the Adverse Event field blank, then type DELETE in the Comments field.
  5. When you are finished, click Save page.

Go to CTCAE topic list

Creating a New Structured CTCAE Proposal

To create an additional proposal, follow these steps:

  1. Locate the proposal.
  2. Click the Make a proposal link at the bottom of the Tabular tab.
  3. To add a proposal, click Add another.
  4. Select a status from the Proposal Status list: Edit Term, Split Term, or New Term:
    • If you want to edit a term (such as changing the AE name or grade names), leave the status set to Edit Term and make the desired change. The change will be interpreted as a replacement for the contents of the corresponding field (AE name or specific grade).
    • If you want to split a term, select Split Term, then create a proposal for each of the new terms. For example, if you want to split Hypersensitivity into Allergic Reaction, Hypersensitivity, and Drug Fever, create three Split Term proposals.
    • If you want to create a new term, select New Term, then indicate any new grades or leave them blank.
    • If you want to leave a term as is, include the AE name in the Adverse Event field, then type No Change in the Comments field.
    • If you want to delete a term, leave the Adverse Event field blank, then type DELETE in the Comments field.
  5. When you are finished, click Save page.

Go to CTCAE topic list

Editing an Existing Structured CTCAE Proposal

To edit an existing proposal, follow these steps:

  1. Locate the CTCAE term.
  2. Click the Make a proposal link at the bottom of the Tabular tab.
  3. Edit the existing proposal.
    Only change someone else's proposal if authorized to do so.
  4. Click Save Page.

Note: You can also use this method to add a new proposal.

Go to CTCAE topic list

Deleting a Structured CTCAE Proposal

To delete a proposal (or part of a proposal), follow these steps:

  1. Locate the proposal.
  2. Click the Make a proposal link at the bottom of the Tabular tab.
  3. Under the proposal that you want to delete, click Remove.
  4. Click Save Page.

Go to CTCAE topic list

Participating in a Discussion (CTCAE Project)

Prerequisite topic: About Unstructured Proposals

To initiate or participate in a discussion, follow these steps:

  1. Browse or search for the term that you want to discuss.
  2. Click the Discussion tab at the top of the category page for the selected term.
    If a discussion is already in progress, you will see previously entered comments on the discussion page. If no one has added comments, you will immediately see the page title, the Edit toolbar, and a box for typing text. Regardless, you can use the toolbar and text entry box to add your own comments.
  3. Click the Leave a Comment link.
  4. Write and edit your comments in the text entry box:
    • Start each bulleted item with an asterisk (*).
    • Surround subheadings with equal signs (=== heading ===)
    • Use the Edit toolbar to add formatting. For a complete description of the toolbar buttons, see the following MediaWiki page: http://meta.wikimedia.org/wiki/Help:Edit_toolbar
  5. Append your signature to the comments by clicking the Your signature with timestamp button.
  6. Click Save page.
    The most recent comments appear at the top of the page.

Go to CTCAE topic list

Need More Help?

Tell Us How We're Doing...

Retrieved from "http://biomedgt.nci.nih.gov/wiki/index.php/BiomedGT_Help:_Contributing_Content"
Personal tools
content search