Submissions:HowDoISubmitAModelllingIssue

From Odp

(Difference between revisions)
Jump to: navigation, search
(New page: {{#ifLogged: {{Post or Contribute to a modeling issue |Image=PostIssue.png |Info= # View existing modeling issues to see if your issue is already there. # If so, click...)
Current revision (02:35, 6 March 2010) (view source)
 
(7 intermediate revisions not shown.)
Line 15: Line 15:
__NOTOC__
__NOTOC__
-
== Recommended Procedure for Submitting Exemplary Ontologies ==  
+
== Recommended Procedure for Posting or Contributing to Modeling Issues ==  
-
=== Step 1:  Is the exemplary ontology you wish to submit already in the [[Ontology:Main|Exemplary Ontology Catalogue]]?  ===
+
=== Step 1:  Is the modeling issue you wish to submit already in the [[Community:Main|table of modeling issues]]?  ===
-
View the [[Ontology:Main|Exemplary Ontology Catalogue]]. Is the ontology you want to add already there?
+
View the [[Community:Main|existing modeling issues]]. Is the issue you want to post already there?
-
* ''Yes?'' Click to open the ontology and check the information for accuracy and completeness. Make changes and additions as appropriate.  You are finished.
+
* ''Yes?''  
-
* ''No?'' From the catalogue page, click the ''Submit a new Exemplary Ontology'' button and continue to step 2.
+
*# Click link in leftmost column to open the issue.
 +
*# Check for accuracy and completeness.  
 +
*# Make changes and additions as appropriate following instructions in steps 3 and 4 below.  You are finished.
 +
* ''No?''  
 +
*# Click to [[Community:PostModelingIssue| Post a modeling issue now.]]
 +
*# Continue to step 2.
-
=== Step 2: Filling out the Exemplary Ontology form ===
 
-
* Fill in the mandatory fields:
+
=== Step 2: Creating the Wiki Page ===
-
** '''Name:'''Enter the name of the exemplary ontology.
+
# Enter the title of the wiki page. Enter the string: "Community:" followed by a short name. Give this some thought.
-
** '''Description:''' Give a concise description or abstract of the ontology, highlighting what is most important.
+
# Click the "Create" button to take you to the main forms for describing the 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.
+
=== Step 3: Filling out the modeling issue forms ===
-
** '''Domains:''' Enter one or more [[:Category:Domain | domains]], separated by a comma.
+
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:
 +
# '''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. [[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.
 +
 
 +
 
 +
=== Step 4: Add References ===
 +
{{References Help Text}}
 +
 
 +
 
 +
=== Step 5: Contributing to an existing modeling issue. ===
 +
# Read and understand the modeling issue as currently described.
 +
# Identify how you can improve it.
 +
# Fill in or add to any fields that are empty or incomplete.
 +
# Start a discussion using the discussion tab, making recommendations, or asking further questions of clarification.
-
* 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]]
For additional information, see the [[Odp:About#Glossary_of_Terms | Glossary of Terms]]
 +
 +
 +
{{Info tip
 +
|
 +
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.
 +
}}
 +
|{{Not allowed|Action=propose an exemplary ontology}}
|{{Not allowed|Action=propose an exemplary ontology}}
}}
}}

Current revision

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

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

Retrieved from "http://ontologydesignpatterns.org/wiki/Submissions:HowDoISubmitAModelllingIssue"
Personal tools
Quality Committee
Content OP publishers