Difference between revisions of "Submissions:HowDoISubmitAModelllingIssue"

Revision as of 07:45, 2 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 step 3 below. You are finished.
No?
1. Click to Post a modeling issue now.
2. Continue to step 2.

Step 2: Creating the Wiki Page

Enter the title of the wiki page. Enter the string: "Community:" followed by a short name. Give this some thought.
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 three tabs: Description, About Modeling Issue, and Free Text.

DESCRIPTION Tab: Fill out the two mandatory fields:

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.
Description: Give a concise description of the modeling issue.

IMAGE Tab

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

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.
Domains: Enter one or more Domains separated by comma. See existing domains or add a new one.
Competency questions: Enter one or more competency questions, separated by a comma.
Scenario: Describe one or more scenarios where this modeling issue arises.
Proposed Solution: Enter one or more comma separated file names of ontology (e.g. .owl) files that are proposed solutions to the modeling issue.
Related pattern Enter one or more comma separated ontology design patterns that may be used to solve this issue.

ADDITIONAL INFORMATION

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

For additional information, see the Glossary of Terms | Sorry, you need to be logged to propose an exemplary ontology.

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

}}

@@ Line 22: / Line 22: @@
 *# Click link in leftmost column to open the issue.
 *# Check for accuracy and completeness.
-*# Make changes and additions as appropriate following instructions in step 2 below.  You are finished.
+*# Make changes and additions as appropriate following instructions in step 3 below.  You are finished.
 * ''No?''
 *# Click to [[Community:PostModelingIssue| Post a modeling issue now.]]
@@ Line 28: / Line 28: @@
-=== Step 2: Filling out the modeling issue form ===
+=== Step 2: Creating the Wiki Page ===
+# Enter the title of the wiki page. Enter the string: "Community:" followed by a short name. Give this some thought.
+# 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 three tabs: Description, About Modeling Issue, and Free Text.
-* Fill in the mandatory Descriptoin fields:
+* DESCRIPTION Tab: Fill out the two mandatory fields:
-** '''Title:'''Enter the name of the exemplary ontology.
+# '''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.
-** '''Description:''' Give a concise description or abstract of the ontology, highlighting what is most important.
+# '''Description:''' Give a concise description of the modeling issue.
-** '''Purpose:''' Indicate what the ontology is for and what the intended benefits are to whom.
-** '''Justification:''' Explain why the ontology is exemplary. It should meet some of  [[Odp:Exemplary_ontology|these criteria]].
-** '''URI:''' Give a URI of where the .owl file may be found.
+* IMAGE Tab
-** '''Domains:'''  Enter one or more [[:Category:Domain | domains]], separated by a comma.
+# '''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
+# '''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.
+# '''Domains:'''  Enter one or more Domains separated by comma.  [[Community:Domain| See existing domains or add a new one]].
+# '''Competency questions:''' Enter one or more competency questions, separated by a comma.
+# '''Scenario:''' Describe one or more scenarios where this modeling issue arises.
+# '''Proposed Solution:''' Enter one or more comma separated file names of ontology (e.g. .owl) files that are proposed solutions to the modeling issue.
+# '''Related pattern''' Enter one or more comma separated ontology design patterns that may be used to solve this issue.
+* ADDITIONAL INFORMATION
+# Add any free text you wish to further describe the modeling issue.
-* Fill in as many optional fields as you can.
-** '''Organization''' List the major organization(s) associated with this ontology. This may be who owns and controls the ontology, the organization(s) managing associated projects, or where most of the work was or is being done.
-** '''Authors''' List the major authors and contributors that helped create the ontology.
-** '''Licensing''' Indicate any licensing arrangements that govern the distribution of the ontology, ''e.g.'' open source, GNU, CopyLeft. See [http://en.wikipedia.org/wiki/Software_license Sofware license on Wikipedia].
-** '''Competency questions:''' Enter one or more competency questions, separated by a comma.
-** '''Scenario:''' Describe one or more situations where this ontology is particularly useful.
-** '''Known Issues:''' Describe one or more known issues related to this ontology.
-** '''Web References (Links):''' List one or more URLs to websites with helpful information about this exemplary ontology.
-** '''Other References:''' List one or more references to helpful information about this exemplary ontology that are not URL links.
-** '''Long Description:''' Give a more detailed description of the ontology. Enter or paste as much text as you need. HINT: you can cut and paste large amounts of already nicely formated text into into a word processor that exports to wiki format (''e.g.'' OpenOffice Writer). Then paste that into the field.  Suggested content:
-*** ''Purpose:'' describe the purpose and intended users;
-*** ''Content:'' highlight key elements of the ontology's structure and content;
-*** ''Usage:'' indicate how much use the ontology is getting from whom.
-*** ''Availability Details:'' Include any additional details on how to get the ontology not mentioned above (''e.g.'' licensing, cost, links).
-** '''Recommended by''' Give the name(s) of any individuals that recommended the ontology as being exemplary, other than the author.
 For additional information, see the [[Odp:About#Glossary_of_Terms | Glossary of Terms]]
 |{{Not allowed|Action=propose an exemplary ontology}}
 }}