(48 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{| style='width:100%;'  
{| style='width:100%;;border-collapse:collapse;border-color:white;'  
|style='width:25%'|  
|style='width:25%'|  
|style='widt:30%'|  
|style='widt:49%'|  
|style='width:25%'|  
|style='width:25%'|  
|style='width:14em'|
|-
|-
!colspan='3' style='text-align:left;font-size:xx-large;'| <div style='font-size:medium;padding:.2em 1em auto .1em;float:left;margin-right:12px;'>[[File:BestPracticesWiki_140x140.gif|100px]]</div><span style='padding-bottom:6px;font-size:small;display:block;'>Best Practice:</span><span style='line-height:110%'>''{{PAGENAME}}''</span><br/><span style='font-size:x-small;color:gray;font-variant:small-caps'>Source: http://www.bestpracticeswiki.net</span>
|colspan='2' style='text-align:left;font-size:xx-large;vertical-align:top'| <div style='font-size:medium;float:left;'><!--
-->[[File:BestPracticesWiki_140x140.gif|100px]]</div><span style='padding-bottom:6px;font-size:small;display:block;'>Best Practice:</span><span style='line-height:115%'>''{{PAGENAME}}''</span><br/><span style='font-size:x-small;color:gray;font-variant:small-caps'>Source: http://www.bestpracticeswiki.net</span>
 
|rowspan='4' style='text-align:center;vertical-align:top'|{{:Mediabox:Wiki_Ontology_1.0}}<!--
--><div style='border:solid darkgray;padding:.25em;height:47em;overflow:scroll'>{{Infobox:Wiki_Ontology_1.0}}</div>


!colspan='1' rowspan='3' style='vertical-align:top;background-color:lightyellow'|<div style='font-size:medium;padding:1em;float:left;margin-right:4px;'>[[File:Type - Best Practice.png|50px]]</div><big style='font-family:cursive'>A Best Practice</big><hr/>[[{{FULLPAGENAME}}|{{PAGENAME}}]]
{{.clear}}
<div style='text-align:left'>
[[help:Context|'''Context''']]<hr/>
<small style='display:block'>audiences: </small>[[Job:Ontologist]], [[Job:Database Designer]], [[Job:Web Manager]], [[Role:Expert User]]
<br/><small style='padding-top:.25em;display:block'>activities: </small>[[Industry:Web Design]]
<br/><small style='padding-top:.25em;display:block'>features: </small>
<small style='padding-top:.25em;display:block'>locations: </small>[[Web:Internet]]
<br/>[[help:Infobox|'''Catalog Information''']]<hr/>
<small>source: </small>
<br/><small>tags: </small>
<br/><small>status: </small>
<br/><small>notes: </small>
<br/>
<br/><small>identifiers: </small>
<br/><small>version: </small>25 Mar 2013
<br/><small>author: </small>John McClure
<br/><small>contributors: </small>
<br/><small>editor: </small>
<br/><small>publisher: </small>[http://www.bestpracticeswiki.net BestPractices]
<br/><small>rights: </small>.
</div>
|-
|-
|colspan='3' style='background-color:white;font-size:small;'|<!--
|colspan='2' style='vertical-align:top;font-size:small;padding-bottom:.5em'|<!--
--><div style='padding:1.5em;font-size:medium'><!--
--><span style='float:right;margin:-1.25em .25em 0 1em;'><!--
-->This document specifies Practices underlying the ontology developed for the [[mw:Extension:Semantic MediaWiki|semantic wiki]] supporting {{SITENAME}}. The practices below do not necessarily apply to ontologies fielded in technical environments other than semantic wikis. Principal objectives of the ontology are
--><nowiki>[</nowiki>[[Summary:{{PAGENAME}}|edit]]<nowiki>]</nowiki></span><!--
# conventions to name classes & properties attached to wiki pages and page subobjects
--><div style='padding:.5em 1.5em  0 1.5em;font-size:medium'>{{Summary:{{PAGENAME}}}}</div><!--
# a [http://www.isotopicmaps.org/ctm/ucs-2008-05-25.txt Topic Map-syntax] widget for direct entry of page subobjects & properties
 
# a structured query syntax easier for users to learn and use
--><div style='padding-top:.5em'><!--
# an "annotation desktop" for semantic scientific & socio-economic ontologies
--><span style='padding-left:0em;font-variant:small-caps'><small>in ''best practice'' bundle: </small></span><!--
<br/>This material is primarily directed at web developers associated with {{SITENAME}} and at any others who use the [[Ontology:Wiki Topic Maps|Wiki Topic Maps Ontology]].  Readers of this document are expected to be familiar with Semantic MediaWiki and its suites of software extensions.<!--
--></div><!--
--><span style='padding-left:0em;font-variant:small-caps'>in bundle: </span><!--
-->[[{{NAMESPACE}}:Wiki Documentation]]<!--
-->[[{{NAMESPACE}}:Wiki Documentation]]<!--
--><span style='padding-left:.3em;font-variant:small-caps'>narrower than: </span><!--
--><span style='padding-left:.3em;font-variant:small-caps'><small>broader topics: </small></span><!--
-->[[Subject:Computer Applications|Ontologies]]<!--
-->[[Subject:Computer Applications|Wiki Ontologies]]<!--
--><span style='padding-left:.3em;font-variant:small-caps'>broader than: </span><!--
--><span style='padding-left:.3em;font-variant:small-caps'><small>narrower topics: </small></span><!--
-->
--></div>
|-
|-
|colspan='2' style='text-align:left;background-color:beige;'|
| colspan='2' style='background-color:beige;vertical-align:top;'|<!--
--><div style='text-align:left;'><!--
<span style='float:right;margin:0'><nowiki>[</nowiki>[[edit]]<nowiki>]</nowiki></span>
<div><big>'''General ''"Rules of Thumb"'' Advice</big></div>
--><nowiki/>
===General ''"Rules of Thumb"'' Advice===
===General ''"Rules of Thumb"'' Advice===
----
*[[Rule:Rule #272|<small style='float:right'>(Stated)</small>]]<!--
-->[ABSTRACT GRAMMAR CLASSES] Establish as grammatical abstract classes: [[Type:Noun|Noun]],[[Type:Verb|Verb]], [[Type:Adjective|Adjective]], [[Type:Adverb|Adverb]], [[Type:Adjective|Adjective]], [[Type:Participle|Participle]], [[Type:Plural|Plural]] and [[Type:Preposition|Preposition]].
*[[Rule:Rule #272|<small style='float:right'>(Stated)</small>]]<!--
*[[Rule:Rule #272|<small style='float:right'>(Stated)</small>]]<!--
-->[ABSTRACT CLASSES] Establish basic abstract classes [[Type:Who|Who]], [[Type:What|What]], [[Type:When|When]], [[Type:Where|Where]], [[Type:Which|Which]], [[Type:Why|Why]], [[Type:How|How]] and [[Type:How much|How much]].
-->[ABSTRACT TOPIC CLASSES] Establish as topical abstract classes: [[Type:Story|Story]],[[Type:What|What]], [[Type:When|When]], [[Type:Where|Where]], [[Type:Who|Who]], [[Type:Which|Which]], [[Type:Why|Why]], [[Type:How|How]] and [[Type:How much|How much]].  
*[[Rule:Rule #272|<small style='float:right'>(Debated)</small>]]<!--
*[[Rule:Rule #272|<small style='float:right'>(Debated)</small>]]<!--
-->[ATTRIBUTE NAMESPACE] Rename the SMW ''Property'' namespace to ''Attribute'' in order to preserve "property" as a prime legal/economic term for a "type of topic".
-->[ATTRIBUTE NAMESPACE] Rename the SMW ''Property'' namespace to ''Attribute'' in order to preserve "property" as a prime legal/economic term for a "type of topic".
Line 55: Line 40:
-->[TEXT PROPERTIES] Identify the names of all text properties by (1) a "period" followed by (2) a lower case letter. The property name may have a suffix to indicate language or facets of the property's value.
-->[TEXT PROPERTIES] Identify the names of all text properties by (1) a "period" followed by (2) a lower case letter. The property name may have a suffix to indicate language or facets of the property's value.
*[[Rule:Rule #273|<small style='float:right'>(Agreed)</small>]]<!--
*[[Rule:Rule #273|<small style='float:right'>(Agreed)</small>]]<!--
-->[PROPERTY FACETS] Identify the names of facets by (1)  a "period" followed by (2) a lower case letter. Include facets for language, numeric precision, variance and statistical measures.
-->[PROPERTY FACETS] Identify the names of facets by (1)  a ''hash'' character followed by (2) a lower case letter. Include facets for language, numeric precision, variance and statistical measures.
*[[Rule:Rule #274|<small style='float:right'>(Tabled)</small>]]<!--
*[[Rule:Rule #274|<small style='float:right'>(Tabled)</small>]]<!--
-->[OBJECT PROPERTIES] Identify the names of all object properties by a Capital Letter and do not follow any camel-casing convention.  
-->[OBJECT PROPERTIES] Identify the names of all object properties by a Capital Letter and do not follow any camel-casing convention.  
Line 67: Line 52:
-->[SI PROPERTIES] Support all Systeme Internationale (SI) abbreviations for types of numeric quantities as property names.
-->[SI PROPERTIES] Support all Systeme Internationale (SI) abbreviations for types of numeric quantities as property names.
*[[Rule:Rule #282|<small style='float:right'>(Finalized)</small>]]<!--
*[[Rule:Rule #282|<small style='float:right'>(Finalized)</small>]]<!--
-->[WIKI NAMESPACES]  Require a wiki page's namespaces to be the primary mechanism for communicating the ''type of topic'' that the page represents. Allow any namespace to contain any of three primary SKOS metatypes: (a) concept (b) collection (c) schema/bundle.
-->[WIKI NAMESPACES]  Require a wiki page's namespaces to be the primary mechanism for communicating the ''type of topic'' that the page represents.  
*[[Rule:Rule #283|<small style='float:right'>(Constructing)</small>]]<!--
*[[Rule:Rule #282|<small style='float:right'>(Created)</small>]]<!--
-->[NAMESPACE CONTENTS]  Any namespace (except ''Main'') may contain any of the SKOS ontology's metatypes: (a) ''concept'' (a type of ''topic'') (b) ''collection'' (a type of ''bag'') and (c) ''schema'' (a type of ''bundle'').
*[[Rule:Rule #283|<small style='float:right'>(Created)</small>]]<!--
-->[WIKI PAGENAMES] Assume that the name of a page in a wiki is the topic of the page, and a topic of the wiki.
-->[WIKI PAGENAMES] Assume that the name of a page in a wiki is the topic of the page, and a topic of the wiki.
*[[Rule:Rule #283|<small style='float:right'>(Re-stated)</small>]]<!--
*[[Rule:Rule #283|<small style='float:right'>(Re-stated)</small>]]<!--
Line 80: Line 67:
*[[Rule:Rule 301|<small style='float:right'>(Re-agreed)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Re-agreed)</small>]]<!--
-->[RDF SCHEMA] Support all RDF Schema properties and classes for data exchanges and queries.
-->[RDF SCHEMA] Support all RDF Schema properties and classes for data exchanges and queries.
*[[Rule:Rule #273|<small style='float:right'>(Stated)</small>]]<!--
-->[STRUCTURED PAGENAMES] The root of structured pagenames within a namespace should be the page's ''Publisher'' ''Creator'' or ''Author''.
<!--
<div style='margin-top:.75em'>
<span style='float:right;'><nowiki>[</nowiki>[[edit]]<nowiki>]</nowiki></span>
<div style=''><big>'''Conditional ''"Rules of Thumb"'' Advice'''</big></div>
----
</div>
--><nowiki/>


===Conditional ''"Rules of Thumb"'' Advice===
==='''Conditional ''"Rules of Thumb"'' Advice'''===
 
*
<hr/>{{#formlink:form=Advice|link text=Add another "Rule of Thumb" '''''(from the same source only)'''''|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}
!colspan='1' style='background-color:lightblue;vertical-align:top;'|
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>Media links </div>
{{#ask:[[Link:+]]|format=list|default=<small>No media items found</small><br/>}}
{{#formlink:form=Link|link text=Add a link|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>See also</div>
{{#ask:[[Relation:+]]|format=list|default=<small>No other items found</small><br/>}}
{{#formlink:form=Relation|link text=Add a link|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
<div style='background-color:yellow;color:black;margin-top:1em'>
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0;'>Community Contacts</div>
{{#ask:[[Advice:+]]|format=list|default=<small>No contacts found</small><br/>}}
<hr/>{{#formlink:form=Expert|link text=Be a go-to expert<br/>about this practice|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}<hr/>{{#formlink:form=Practitioner|link text=Do you or your organization use this best practice ?|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}
</div>
<div style='background-color:gray;color:darkblue;margin:0 0 1.5 0'>
{{#formlink:form=Search|link text='''Search for more<br/>''Best Practices''<br/>like this one'''|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
</div>
</div>
<div style='background-color:limegreen;color:teal;margin:1em 0 1em 0'>
<div style='color:white;font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>Group Blog</div>
{{#formlink:form=Blog|link text='''Start a group blog<br/>for this best practice'''|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
</div>
<div style='background-color:sandybrown;color:white;margin-top:1em'>
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>''Snap Poll''</div>
{{#formlink:form=Practitioner|link text=Do you or your organization use this best practice ?|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}
{{#formlink:form=Poll|link text=Create a poll|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
</div>
<div style='background-color:lightblue;color:black;vertical-align:top;'>
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>Case studies, datasets & surveys</div>
{{#ask:[[Study:+]]|format=list|default=<small>No case studies found</small><br/>}}
{{#formlink:form=Study|link text=Add a case study|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
<hr/> {{#ask:[[Dataset:+]]|format=list|default=<small>No open data datasets found</small><br/>}}
{{#formlink:form=Dataset|link text=Add a dataset|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
<hr/> {{#ask:[[Survey:+]]|format=list|default=<small>No surveys found</small>}}
<span style='float:right'>{{#formlink:form=Survey|link text=Add a survey|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}</span>
</div>
|-
!colspan='4' style='background-color:white;color:teal;'|
<div style='text-align:center;font-size:medium;padding:1em;'>[[{{TALKPAGENAME}}|Community discussion & public comments happen on the "Talk" page]]</div>
|-
|-
!colspan='4' style='background-color:coral;;vertical-align:top;'|
!colspan='2' style='background-color:coral;;vertical-align:top;'|
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>Expert Opinions</div>
<div style='font-size:medium;font-weight:bold;text-align:center;padding:.5em 0 0 0'>Expert Opinions</div>
{{#ask:[[Opinion:+]]|format=list|default=<small>No opinions found</small><br/>}}{{comments|show=True}}
{{#ask:[[Opinion:+]]|format=list|default=<small>No opinions found</small><br/>}}{{comments|show=True}}
<hr/>{{#formlink:form=Expert|link text=Add an expert opinion about this best practice|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}
 
|-
!colspan='2' style='background-color:white;color:teal;'|
<div style='text-align:center;font-size:medium;padding:1em;'>[[{{TALKPAGENAME}}|Community discussion & public comments happen on the "Talk" page]]</div>


|}__NOTOC__
|}__NOTOC__
{{#css:
{{#css:
h1#firstHeading {display:none}
h1#firstHeading {display:none}
li {line-height:115%;margin-top:.5em}
}}
{{#seo:
|title=Wiki Ontology 1.0 | bestpracticeswiki.net
|keywords=wiki ontology,best practices for wiki ontology development
|description=Best Practices for the development of a wiki utilized for best practices.
}}
}}

Latest revision as of 15:08, 16 July 2015

BestPracticesWiki 140x140.gif
Best Practice:Wiki Ontology 1.0
Source: http://www.bestpracticeswiki.net
Attached Media

{{#ask:Link:+|format=list|default=No media items found
}} {{#formlink:form=Link|link text=Attach multi-media
to this Best Practice|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}

See also

{{#ask:Relation:+|format=list|default=No other items found
}} {{#formlink:form=Relation|link text=Add an external link|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}

Search for similar

{{#formlink:form=Search|link text=Go to query form|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}

Group Blogs

{{#formlink:form=Blog|link text=Start a group blog
for this best practice|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}

Snap Polls
  • {{#formlink:form=Practitioner|link text=Do you or your organization use this best practice ?|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}
Community Contacts

{{#ask:Advice:+|format=list|default=No contacts found
}}


{{#formlink:form=Expert|link text=Are you a go-to resource
about this practice?|link type=|query string=|query string parameters|target=|tooltip=|popup|new window}}
Case studies, datasets & surveys

{{#ask:Study:+|format=list|default=No case studies found
}} {{#formlink:form=Study|link text=Add a case study|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}


{{#ask:Dataset:+|format=list|default=No open data datasets found
}}

{{#formlink:form=Dataset|link text=Add a dataset|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}


{{#ask:Survey:+|format=list|default=No surveys found}}

{{#formlink:form=Survey|link text=Add a survey|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}

[edit]
in best practice bundle: Wiki Documentationbroader topics: Wiki Ontologiesnarrower topics:

General "Rules of Thumb" Advice


  • (Stated)[ABSTRACT GRAMMAR CLASSES] Establish as grammatical abstract classes: Noun,Verb, Adjective, Adverb, Adjective, Participle, Plural and Preposition.
  • (Stated)[ABSTRACT TOPIC CLASSES] Establish as topical abstract classes: Story,What, When, Where, Who, Which, Why, How and How much.
  • (Debated)[ATTRIBUTE NAMESPACE] Rename the SMW Property namespace to Attribute in order to preserve "property" as a prime legal/economic term for a "type of topic".
  • (Discussing)[TEXT PROPERTIES] Identify the names of all text properties by (1) a "period" followed by (2) a lower case letter. The property name may have a suffix to indicate language or facets of the property's value.
  • (Agreed)[PROPERTY FACETS] Identify the names of facets by (1) a hash character followed by (2) a lower case letter. Include facets for language, numeric precision, variance and statistical measures.
  • (Tabled)[OBJECT PROPERTIES] Identify the names of all object properties by a Capital Letter and do not follow any camel-casing convention.
  • (Voting)[NUMERIC PROPERTIES] Support RDF-style numeric property names, e.g., "1" and "2", when used as suffixes to either a text or an object property name.
  • (Withdrawn)[PROPERTY NAMES] Disallow from property names all special characters other than en-dash and hash characters.
  • (Discussing)[ISO PROPERTIES] Support all International Standards Organization (ISO) codes for currencies & languages as property names for monetary and text/string data.
  • (Presumed)[SI PROPERTIES] Support all Systeme Internationale (SI) abbreviations for types of numeric quantities as property names.
  • (Finalized)[WIKI NAMESPACES] Require a wiki page's namespaces to be the primary mechanism for communicating the type of topic that the page represents.
  • (Created)[NAMESPACE CONTENTS] Any namespace (except Main) may contain any of the SKOS ontology's metatypes: (a) concept (a type of topic) (b) collection (a type of bag) and (c) schema (a type of bundle).
  • (Created)[WIKI PAGENAMES] Assume that the name of a page in a wiki is the topic of the page, and a topic of the wiki.
  • (Re-stated)[WIKI REDIRECTS] Consider REDIRECTs to be alternate names, or aliases, in the Topic Map sense.
  • (Questioned)[DUBLIN CORE] Adopt & tightly integrate all Dublin Core properties for general provenance purposes.
  • (Re-questioned)[XML SCHEMA] Support all XML Schema datatypes as property names for low-level data transmissions or queries.
  • (Re-proposed)[RDF] Support all RDF properties and classes for RDF-level data transmissions and RDF-level queries.
  • (Re-agreed)[RDF SCHEMA] Support all RDF Schema properties and classes for data exchanges and queries.
  • (Stated)[STRUCTURED PAGENAMES] The root of structured pagenames within a namespace should be the page's Publisher Creator or Author.

Conditional "Rules of Thumb" Advice

Expert Opinions
{{#ask:Opinion:+|format=list|default=No opinions found
}}
nopreview

{{#set:

Article has average rating={{#averagerating:}}

}} {{#showcommentform:}}

?Has comment person ?Has comment date ?Has comment text ?Has comment rating ?Belongs to comment ?Comment was deleted#true,false ?Has comment editor ?Modification date ?Has attached article format=template template=CommentResult sort=Has comment date order=asc link=none limit=100

}}


{{#css: h1#firstHeading {display:none} li {line-height:115%;margin-top:.5em} }}