Difference between revisions of "Submissions:HowDoISubmitAModelllingIssue"

Latest revision as of 02:35, 6 March 2010

{{#ifLogged:

How to post or contribute to a modeling issue (in a nutshell)
	View existing modeling issues to see if your issue is already there. If so, click on it and skip to next step. If not, Click the link: Post a modeling issue now. Fill out or add to existing form describing various aspects of the modeling issue.

	The steps for posting new issues and contributing to existing issues are described below.

Recommended Procedure for Posting or Contributing to Modeling Issues

Step 1: Is the modeling issue you wish to submit already in the table of modeling issues?

View the existing modeling issues. Is the issue you want to post already there?

• Yes?
  1. Click link in leftmost column to open the issue.
  2. Check for accuracy and completeness.
  3. Make changes and additions as appropriate following instructions in steps 3 and 4 below. You are finished.
• No?
  1. Click to Post a modeling issue now.
  2. Continue to step 2.

Step 2: Creating the Wiki Page

1. Enter the title of the wiki page. Enter the string: "Community:" followed by a short name. Give this some thought.
2. Click the "Create" button to take you to the main forms for describing the issue.

Step 3: Filling out the modeling issue forms

How you proceed will depend on how well developed your thinking is about your issue. Fill in as many of the fields below as you can. There are four tabs: Description, Image, About Modeling Issue, and Free Text.

• DESCRIPTION Tab: Fill out the two mandatory fields:

1. Name: Enter the name of the modeling issue. It will often be the same as the title. Of you may wish to make is slightly longer or more nicely formatted.
2. Description: Give a concise description of the modeling issue.

• IMAGE Tab

1. Image File Name: Enter the file name of an image that graphically depicts the modeling issue. It will be uploaded and displayed at the top of the modeling issue description. Ensure that it is a legitimate image file (e.g. .png, .jpg but not .pdf)

• ABOUT MODELING ISSUE Tab

1. Contributors: A list of comma separated names of persons who contributed to this modeling issue. Normally you just start typing your own name and select from a set of values that appear in a dropdown menu.
2. Domains: Enter one or more Domains separated by comma. See existing domains or add a new one.
3. Competency questions: Enter one or more competency questions, separated by a comma.
4. Scenario: Describe one or more scenarios where this modeling issue arises.
5. Proposed Solution: Enter one or more comma separated file names of ontology (e.g. .owl) files that are proposed solutions to the modeling issue.
6. Related pattern Enter one or more comma separated ontology design patterns that may be used to solve this issue.

• ADDITIONAL INFORMATION

1. Add any free text you wish to further describe the modeling issue.

Step 4: Add References

At the bottom of the main page for the item you are adding a reference to, you can add one or more references. For each, you can fill in the following fields:

• Label: Enter a very short label that will be used as the wiki page title.
• Description: Enter the text that will be appear at the bottom of the page. It might be the same as the label. It might be a full reference with title, authors, publication, date etc.
• Type: Select the type (e.g. Project home page, Documentation, Wiki). If the type you wish to enter is not there, select Other and enter the type.
• URL: Enter the URL for the reference, if appropriate.

Step 5: Contributing to an existing modeling issue.

1. Read and understand the modeling issue as currently described.
2. Identify how you can improve it.
3. Fill in or add to any fields that are empty or incomplete.
4. Start a discussion using the discussion tab, making recommendations, or asking further questions of clarification.

For additional information, see the Glossary of Terms

	The goal is for all modeling issues to: reach a stage of being very clearly defined have one or more implemented solutions linked to design patterns be clearly explained so others can benefit from your efforts be illustrated by at least one figure.

| Sorry, you need to be logged to propose an exemplary ontology.

If you don't have an ODP account, you can request it.

}}