(81 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:49%'|
|style='width:25%'|  
|style='width:25%'|  
|style='width:25%'|
|style='width:25%'|
|-
|-
!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:W3c home.png]]</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.w3.org/TR/mobile-bp/#d0e630</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'>[[help:Audience|audiences]]: </small>[[Job:Web designer]]
<br/><small style='padding-top:.25em;display:block'>[[help:Actvity|activities]]: </small>[[Industry:Web development]]
<br/><small style='padding-top:.25em;display:block'>[[help:Location|locations]]: </small>[[Web:Internet]]
<br/><small style='padding-top:.25em;display:block'>[[help:Size|sizes]]: </small>
<small style='display:block'>[[help:Time|times]]: </small>
<br/>[[help:Infobox|'''Catalog Information''']]<hr/>
<small>[[help:Source|source]]: </small>
<br/><small>[[help:Tag|tags]]: </small>
<br/><small>[[help:Status|status]]: </small>
<br/><small>[[help:Notes|notes]]: </small>
<br/>
<br/><small>[[help:Identifier|identifiers]]: </small>
<br/><small>[[help:Date|version]]: </small>25 Mar 2013
<br/><small>[[help:Author|author]]: </small>John McClure
<br/><small>[[help:Contributor|contributors]]: </small>
<br/><small>[[help:Editor|editor]]: </small>
<br/><small>[[help:Publisher|publisher]]: </small>http://www.bestpracticeswiki.net
<br/><small>[[help:Rights|rights]]: </small>.
</div>
|-
|-
|colspan='3' style='background-color:white;font-size:small;'|<!--
|colspan='2' style='vertical-align:top;font-size:small;padding-bottom:.5em'|<!--
--><span style='display:block;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 {{SITENAME}}. Principal objectives of the ontology are
--><nowiki>[</nowiki>[[Summary:{{PAGENAME}}|edit]]<nowiki>]</nowiki></span><!--
# a consistent set of conventions for users to name properties whose values are associated with wiki pages
--><div style='padding:.5em 1.5em  0 1.5em;font-size:medium'>{{Summary:{{PAGENAME}}}}</div><!--
# a structured query syntax easier for users to learn and use
 
# user-level Topic Map syntax widgets for direct, textual entry, exploiting ''namespaces'' as the ''names of <u>topic types</u>'' consistent with ISO Topic Maps.
--><div style='padding-top:.5em'><!--
# a coherent framework to stitch together semantic web and socio-economic ontologies
--><span style='padding-left:0em;font-variant:small-caps'><small>in ''best practice'' bundle: </small></span><!--
This material is primarily directed at web developers associated with {{SITENAME}} and of any others that 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.<!--
-->[[{{NAMESPACE}}:Wiki Documentation]]<!--
--></span><!--
--><span style='padding-left:.3em;font-variant:small-caps'><small>broader topics: </small></span><!--
--><span style='padding-left:0em;font-variant:small-caps'>in bundle: </span><!--
-->[[Subject:Computer Applications|Wiki Ontologies]]<!--
--><!--
--><span style='padding-left:.3em;font-variant:small-caps'><small>narrower topics: </small></span><!--
--><span style='padding-left:.3em;font-variant:small-caps'>narrower than: </span><!--
--></div>
-->[[Subject:Computer Applications|Ontologies]]<!--
--><span style='padding-left:.3em;font-variant:small-caps'>broader than: </span><!--
-->
|-
|-
|colspan='2' style='text-align:left;background-color:beige;'|
| colspan='2' style='background-color:beige;vertical-align:top;'|<!--
===''"Rules of Thumb"'' Advice===
--><div style='text-align:left;'><!--
*[[Rule:Rule #272|<small style='float:right'>(Rule #272)</small>]]<!--
<span style='float:right;margin:0'><nowiki>[</nowiki>[[edit]]<nowiki>]</nowiki></span>
-->[TEXT PROPERTIES] Text property names begin with a "period" followed by a lower case letter; and may have substructure indicating language or one or more numeric facets.
<div><big>'''General ''"Rules of Thumb"'' Advice</big></div>
*[[Rule:Rule #273|<small style='float:right'>(Rule #273)</small>]]<!--
--><nowiki/>
-->[NUMERIC FACETS] Numeric facet names begin with a "period" followed by a lower case letter. Facets such as numeric precision, variance and statistical measures are represented by suffixing its name to the name of any "Number" property.
===General ''"Rules of Thumb"'' Advice===
*[[Rule:Rule #274|<small style='float:right'>(Rule #274)</small>]]<!--
----
-->[OBJECT PROPERTIES] Object property names begin with a Capital Letter and do not follow any camel-casing convention.  
*[[Rule:Rule #272|<small style='float:right'>(Stated)</small>]]<!--
*[[Rule:Rule #261|<small style='float:right'>(Rule #261)</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]].
-->[PROPERTY NAMES] Property names may not contain any special characters other than ''en-dash'' and ''hash'' characters.
*[[Rule:Rule #272|<small style='float:right'>(Stated)</small>]]<!--
*[[Rule:Rule #109|<small style='float:right'>(Rule #109)</small>]]<!--
-->[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]].
-->[ISO PROPERTIES] International Standards Organization (ISO) codes for currencies & languages are required names for monetary and text/string properties; for the property name, each code is preceded by a period.
*[[Rule:Rule #272|<small style='float:right'>(Debated)</small>]]<!--
*[[Rule:Rule #280|<small style='float:right'>(Rule #280)</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".
-->[SI PROPERTIES] Systeme Internationale (SI) abbreviations for numeric quantities are required names in the ontology.
*[[Rule:Rule #272|<small style='float:right'>(Discussing)</small>]]<!--
*[[Rule:Rule #282|<small style='float:right'>(Rule #282)</small>]]<!--
-->[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.
-->[BALANCE] Take into account the trade-off between having too many links on a page and asking the user to follow too many links to reach what they are looking for.
*[[Rule:Rule #273|<small style='float:right'>(Agreed)</small>]]<!--
*[[Rule:Rule #283|<small style='float:right'>(Rule #283)</small>]]<!--
-->[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.
-->[NAVIGATION] Provide consistent navigation mechanisms.
*[[Rule:Rule #274|<small style='float:right'>(Tabled)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[OBJECT PROPERTIES] Identify the names of all object properties by a Capital Letter and do not follow any camel-casing convention.  
-->[ACCESS_KEYS] Assign access keys to links in navigational menus and frequently accessed functionality.
*[[Rule:Rule #274|<small style='float:right'>(Voting)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[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.
-->[LINK_TARGET_ID] Clearly identify the target of each link.
*[[Rule:Rule #261|<small style='float:right'>(Withdrawn)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[PROPERTY NAMES] Disallow from property names all special characters other than ''en-dash'' and ''hash'' characters.
-->[LINK_TARGET_FORMAT] Note the target file's format unless you know the device supports it.
*[[Rule:Rule #109|<small style='float:right'>(Discussing)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[ISO PROPERTIES] Support all International Standards Organization (ISO) codes for currencies & languages as property names for monetary and text/string data.
-->[IMAGE_MAPS] Do not use image maps unless you know the device supports them effectively.
*[[Rule:Rule #280|<small style='float:right'>(Presumed)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[SI PROPERTIES] Support all Systeme Internationale (SI) abbreviations for types of numeric quantities as property names.
-->[POP_UPS] Do not cause pop-ups or other windows to appear and do not change the current window without informing the user.
*[[Rule:Rule #282|<small style='float:right'>(Finalized)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[WIKI NAMESPACES] Require a wiki page's namespaces to be the primary mechanism for communicating the ''type of topic'' that the page represents.  
-->[AUTO_REFRESH] Do not create periodically auto-refreshing pages, unless you have informed the user and provided a means of stopping it.
*[[Rule:Rule #282|<small style='float:right'>(Created)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</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'').
-->[REDIRECTION] Do not use markup to redirect pages automatically. Instead, configure the server to perform redirects by means of HTTP 3xx codes.
*[[Rule:Rule #283|<small style='float:right'>(Created)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</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.
-->[EXTERNAL_RESOURCES] Keep the number of externally linked resources to a minimum.
*[[Rule:Rule #283|<small style='float:right'>(Re-stated)</small>]]<!--
*[[Rule:Rule 301|<small style='float:right'>(Rule 301)</small>]]<!--
-->[WIKI REDIRECTS] Consider REDIRECTs to be alternate names, or aliases, in the Topic Map sense.
-->[SUITABLE] Ensure that content is suitable for use in a mobile context.
*[[Rule:Rule 301|<small style='float:right'>(Questioned)</small>]]<!--
*[[more|more...]]
-->[DUBLIN CORE] Adopt & tightly integrate all Dublin Core properties for general provenance purposes.
<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}}
*[[Rule:Rule 301|<small style='float:right'>(Re-questioned)</small>]]<!--
!colspan='1' style='background-color:lightblue;vertical-align:top;'|
-->[XML SCHEMA] Support all XML Schema datatypes as property names for low-level data transmissions or queries.
===Media links ===
*[[Rule:Rule 301|<small style='float:right'>(Re-proposed)</small>]]<!--
{{#ask:[[Link:+]]|format=list|default=<small>No media items found</small><br/>}}
-->[RDF] Support all RDF properties and classes for RDF-level data transmissions and RDF-level queries.
{{#formlink:form=Link|link text=Add a link|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
*[[Rule:Rule 301|<small style='float:right'>(Re-agreed)</small>]]<!--
===See also===
-->[RDF SCHEMA] Support all RDF Schema properties and classes for data exchanges and queries.
{{#ask:[[Relation:+]]|format=list|default=<small>No other items found</small><br/>}}
*[[Rule:Rule #273|<small style='float:right'>(Stated)</small>]]<!--
{{#formlink:form=Relation|link text=Add a link|link type=button|query string=|query string parameters|target=|tooltip=|popup|new window}}
-->[STRUCTURED PAGENAMES] The root of structured pagenames within a namespace should be the page's ''Publisher'' ''Creator'' or ''Author''.
<div style='background-color:yellow;color:teal;margin-top:1em'>
<!--
===Community Contacts===
<div style='margin-top:.75em'>
{{#ask:[[Advice:+]]|format=list|default=<small>No contacts found</small><br/>}}
<span style='float:right;'><nowiki>[</nowiki>[[edit]]<nowiki>]</nowiki></span>
<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 style=''><big>'''Conditional ''"Rules of Thumb"'' Advice'''</big></div>
----
</div>
</div>
<div style='background-color:gray;color:darkblue;margin:0 0 1.5 0'>
--><nowiki/>
{{#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>
==='''Conditional ''"Rules of Thumb"'' Advice'''===
<div style='background-color:limegreen;color:teal;margin:1em 0 1em 0'>
*
===Group Blog===
{{#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'>
===''Snap Poll''===
{{#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>
|-
|-
!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='2' style='background-color:cornsilk;color:teal;vertical-align:top;'|
===Case studies, datasets & surveys===
{{#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>
!colspan='2' style='background-color:coral;;vertical-align:top;'|
!colspan='2' style='background-color:coral;;vertical-align:top;'|
===Expert Opinions===
<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} }}