Difference between revisions of "Help:Tutorial"

MyWikiBiz, Author Your Legacy — Monday November 18, 2024
Jump to navigationJump to search
(→‎Style Guidelines: Peanut Farming)
(→‎Directory Space: Splitting living and deceased with estate, etc.)
 
(38 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Places to Start=
+
<noinclude>{{Help contents back}}
Click [[Centiare:Demonstration|here]] to see a collection of pages that demonstrate Centiare's ''Directory'' listing capabilities.
+
----
 +
<br>
 +
=Demonstration=
 +
Check out MyWikiBiz's [[Help:Demonstration|'''Demonstration''']] area to see a collection of pages that highlight MyWikiBiz's ''Directory'' listing and search-result capabilities.
  
=The Bread and Butter of Centiare=
+
=Nuts & Bolts=
When you're ready to create your own Directory listing on Centiare, there are two key elements that you should remember -- 90% of future user searches within Centiare will likely contain either:
+
 
:*NAICS code
+
==Directory Space==
 +
 
 +
'''''Directory Space''''' is a protected [[Help:About|MyWikiBiz]] custom namespace that supports advocate point of view ([[APOV]]) for "[[Help:user-owned|user-owned]]" pages.
 +
 
 +
MyWikiBiz uses an ''[[Entity|entity]]'' (person [legal organization or individual], place, or thing) concept to determine placement. The basic rule-of-thumb to determine whether an article should be listed under the '''''Directory Space''''' or be placed within '''''Main Space''''' is: ''"Would the entity have legal standing in a court of law"?''
 +
 
 +
If the answer is '''''yes''''' as to whether an entity could bring a cause of action as a plaintiff, or respond to a complaint as a defendant, then it should be listed under the '''''Directory Space'''''. Examples:
 +
 
 +
* Commercial Enterprise - [[Directory:LunaGraphica|LunaGraphica]]
 +
* Non-Profit Organization - [[Directory:The USS Rankin Association|USS Rankin Association]]
 +
* Government, Agency, or Political Entity - [[Directory:Huntington Beach, California|City of Huntington Beach]]
 +
* Person (Living) - [[Directory:Liz Cohen|Liz Cohen]]
 +
* Person (Deceased, with active estate) - [[Directory:Carl Sagan|Estate of Carl Sagan]]
 +
* Property - [[Directory:The Walt Disney Company/Mickey Mouse|Disney/Mickey Mouse]]
 +
 
 +
If the answer is '''''no''''', then it should be placed within '''''Main Space''''' and follow the neutral point-of-view ([[NPOV]]) rules of conduct. Examples:
 +
 
 +
* Things - [[Central Index Key]]
 +
* Systems - [[North America Industry Classification System]]
 +
* Person (Deceased, with no active estate) - [[Sir Isaac Newton]]
 +
* Property (with no assets or royalties) - [[Wealth of Nations]]
 +
 
 +
===Discussion===
 +
 
 +
'''Note'''
 +
:Discussions regarding Directory listing entries should take place in the respective [[Help:Discussion Namespace|discussion namespace]]s. For example, corporate governance issues respective to publicly-held companies; shout-outs to personalities here enshrined; consumer reviews of products; etc.
 +
 
 +
==Semantic Tagging==
 +
 
 +
When you're ready to create your own Directory listing on MyWikiBiz, there are two key elements that you should remember -- 90% of future user searches within MyWikiBiz will likely contain either:
 +
:*[[NAICS]] code
 
::...and/or...
 
::...and/or...
:*ZIP code
+
:*[[ZIP]] code
  
If you or your business don't appropriately tag these elements in your Directory space, you're going to be missing from all of those search opportunities.  You should certainly know your ZIP code, and better still if you know the ZIP+4.  If you are unsure of the appropriate NAICS code (or codes) to use, the official [http://www.census.gov/epcd/naics02/naicod02.htm U.S. Census site for NAICS] is the appropriate reference.
+
If you or your business don't appropriately tag these elements in your Directory space, you're going to be missing from all of those search opportunities.  You should certainly know your ZIP code, and better still if you know the ZIP+4.  If you are unsure of the appropriate NAICS code (or codes) to use, the official [http://www.census.gov/epcd/naics02/naicod02.htm U.S. Census site for NAICS] is an appropriate reference.
  
 
=Style Guidelines=
 
=Style Guidelines=
 +
{{further|[[Help:Manual of Style]]}}
  
==Use the ''official'' NAICS title==
+
==Use the ''official'' NAICS names==
When you indicate the industry in which you work, it will be most helpful to future semantic searching if you use the official NAICS name for your industry.  For example, the NAICS code of [http://www.census.gov/epcd/naics02/def/ND111992.HTM#N111992 11199] indicates "'''Peanut Farming'''".   
+
When you indicate the industry in which you work, it will be most helpful to future [[Special:SearchTriple|semantic searches]] and [[Help:ASK|ASK queries]] if you use the official NAICS name for your industry.  For example, the NAICS code of [http://www.census.gov/epcd/naics02/def/ND111992.HTM#N111992 11199] indicates "'''Peanut Farming'''".   
  
You may like to call your field "Goober Growing", but if you choose that name within Centiare, you're just cutting yourself off from the many, many more people who will be looking specifically for the term "Peanut Farming", because they will also be encouraged to enter official NAICS names when searching.
+
You may like to call your line of work "Goober Growing", but if you choose that name within MyWikiBiz, you're just cutting yourself off from the many, many more people who will be looking specifically for the term "Peanut Farming", because they will also be encouraged to enter official NAICS names when searching.
  
 
==Use uniform titles when identifying any Key_Person==
 
==Use uniform titles when identifying any Key_Person==
Within [[Directory:Centiare|Centiare]], one of the most useful features is the [[Semantic tagging|semantic tag]], which allows for robust [[Centiare:Searching|searching]] of the entire database.  To allow the greatest number of users the greatest chance of successfully finding the records they want, it is helpful to agree on a certain uniformity when naming semantic tags and attributes.
+
Within [[Directory:MyWikiBiz|MyWikiBiz]], one of the most useful features is the [[Semantic tagging|semantic tag]], which allows for robust [[Help:Searching|searching]] of the entire database.  To allow the greatest number of users the greatest chance of successfully finding the records they want, it is helpful to agree on a certain uniformity when naming semantic tags and attributes.
  
 
For example, within the <nowiki>'''{{Infobox_Company}}'''</nowiki> template, you will see the following wonderful semantic tags:
 
For example, within the <nowiki>'''{{Infobox_Company}}'''</nowiki> template, you will see the following wonderful semantic tags:
Line 27: Line 61:
 
::...etc.
 
::...etc.
  
Ideally and if possible, any senior corporate employee should be accorded only one common title in Centiare, to optimize semantic searching.  The more that users adhere to this guideline, the more likely their data will be ''found'' by people using Centiare's [[Special:SearchTriple|semantic search]] utility.  Furthermore, if in doubt about Centiare's "preferred" rank and nomenclature of titles, the following list should be used to force consensus across the many differences that appear in the corporate working world.  Within Centiare, please use '''''only''''' the following labels when naming Key Person titles:
+
Ideally and if possible, any senior corporate employee should be accorded only one common title in MyWikiBiz, to optimize semantic searching.  The more that users adhere to this guideline, the more likely their data will be ''found'' by people using MyWikiBiz's [[Special:SearchTriple|semantic search]] utility.  Furthermore, if in doubt about MyWikiBiz's "preferred" rank and nomenclature of titles, the following list should be used to force consensus across the many differences that appear in the corporate working world.  Within MyWikiBiz, please use '''''only''''' the following labels when naming Key Person titles:
  
 
:* '''Chair''' (as opposed to Chairperson, Chairman, Chairwoman, etc.)
 
:* '''Chair''' (as opposed to Chairperson, Chairman, Chairwoman, etc.)
Line 43: Line 77:
 
Additionally, consider whether the '''Founder''' of an organization is also the '''CEO''' or '''Chair''' (in which case use the '''CEO''' or '''Chair''' nomenclature), or whether he or she has been relegated to some non-executive role such as "Spokesperson", "Advisor", or some other honorary title (in which case, do not include this person as a '''Key Person''' in the Infobox; rather, notate them in the '''Founder''' field and feel free to write about them in the article space).
 
Additionally, consider whether the '''Founder''' of an organization is also the '''CEO''' or '''Chair''' (in which case use the '''CEO''' or '''Chair''' nomenclature), or whether he or she has been relegated to some non-executive role such as "Spokesperson", "Advisor", or some other honorary title (in which case, do not include this person as a '''Key Person''' in the Infobox; rather, notate them in the '''Founder''' field and feel free to write about them in the article space).
  
Adherence to this Style Guideline should by no means be considered mandatory, nor a perjorative assessment of any person's "actual" title at their company.  It is merely a mechanism to make semantic searching more productive for more Centiare users. If only three companies in the United States choose to call their CIO the ''Data Ninja'', that's very cute, but not at all useful to Centiare users who are looking for ''CIO'' types of personnel in the state of [[Michigan]].
+
Adherence to this Style Guideline should by no means be considered mandatory, nor a perjorative assessment of any person's "actual" title at their company.  It is merely a mechanism to make semantic searching more productive for more MyWikiBiz users. If only three companies in the United States choose to call their CIO the ''Data Ninja'', that's very cute, but not at all useful to MyWikiBiz users who are looking for ''CIO'' types of personnel in the state of [[Directory:Michigan|Michigan]].
 +
 
 +
(Note: any additions to the list above should first reach consensus on this entry's [[MyWikiBiz_talk:Tutorial|Discussion]] page.)
 +
 
 +
==Calendar Dates==
 +
{{further|[[Help:Manual of Style (dates and numbers)]]}}
 +
 
 +
While the overall organization of MyWikiBiz is flat, certain sections do conform to traditional hierarchical structuring. Calendar dates are one such area. MyWikiBiz takes advantage of [[MediaWiki]]'s built-in subpage cross-referencing feature to facilitate hierarchical organization.  Subpages are generated easily by adding a forward-slash ( / ) at the end of the page address, followed by the name of the subpage.  For example, to make a month's subpage of the page about the year <nowiki>[[2005]]</nowiki>, one might make a page called <nowiki>[[2005/July]]</nowiki>.
 +
 
 +
===Organization===
 +
 
 +
Years, months and days have their own Main page articles -- for example [[2005]], [[December]] ''and'' [[December_20|December 20]].
 +
 
 +
For '''''non-repeating''''' dating purposes, months are treated as subpages within the respective years in which they occur -- for example, [[2005/July_20|July 20, 2005]].
 +
:* References to year-month-day are useful for specific items such as a historical events, newspaper article publishing dates, etc.
  
(Note: any additions to the list above should first reach consensus on this entry's [[Centiare_talk:Tutorial|Discussion]] page.)
+
For '''''repeating''''' dating purposes, days are treated as stand alone dates with respect to the months in which they occur -- for example, [[March_10|March 10]].
 +
:* References to month-day are useful for such items as almanac listings without regard to the actual years in which they occurred; e.g., all births of famous actors which occurred on [[June_1|June 1]], all deaths of notable scientists which occurred on [[December_20|December 20]], etc.

Latest revision as of 19:19, 7 November 2008

Help:Contents


Demonstration

Check out MyWikiBiz's Demonstration area to see a collection of pages that highlight MyWikiBiz's Directory listing and search-result capabilities.

Nuts & Bolts

Directory Space

Directory Space is a protected MyWikiBiz custom namespace that supports advocate point of view (APOV) for "user-owned" pages.

MyWikiBiz uses an entity (person [legal organization or individual], place, or thing) concept to determine placement. The basic rule-of-thumb to determine whether an article should be listed under the Directory Space or be placed within Main Space is: "Would the entity have legal standing in a court of law"?

If the answer is yes as to whether an entity could bring a cause of action as a plaintiff, or respond to a complaint as a defendant, then it should be listed under the Directory Space. Examples:

If the answer is no, then it should be placed within Main Space and follow the neutral point-of-view (NPOV) rules of conduct. Examples:

Discussion

Note

Discussions regarding Directory listing entries should take place in the respective discussion namespaces. For example, corporate governance issues respective to publicly-held companies; shout-outs to personalities here enshrined; consumer reviews of products; etc.

Semantic Tagging

When you're ready to create your own Directory listing on MyWikiBiz, there are two key elements that you should remember -- 90% of future user searches within MyWikiBiz will likely contain either:

...and/or...

If you or your business don't appropriately tag these elements in your Directory space, you're going to be missing from all of those search opportunities. You should certainly know your ZIP code, and better still if you know the ZIP+4. If you are unsure of the appropriate NAICS code (or codes) to use, the official U.S. Census site for NAICS is an appropriate reference.

Style Guidelines

Template:Further

Use the official NAICS names

When you indicate the industry in which you work, it will be most helpful to future semantic searches and ASK queries if you use the official NAICS name for your industry. For example, the NAICS code of 11199 indicates "Peanut Farming".

You may like to call your line of work "Goober Growing", but if you choose that name within MyWikiBiz, you're just cutting yourself off from the many, many more people who will be looking specifically for the term "Peanut Farming", because they will also be encouraged to enter official NAICS names when searching.

Use uniform titles when identifying any Key_Person

Within MyWikiBiz, one of the most useful features is the semantic tag, which allows for robust searching of the entire database. To allow the greatest number of users the greatest chance of successfully finding the records they want, it is helpful to agree on a certain uniformity when naming semantic tags and attributes.

For example, within the '''{{Infobox_Company}}''' template, you will see the following wonderful semantic tags:

Key_Person1_Title
Key_Person2_Title
Key_Person3_Title
...etc.

Ideally and if possible, any senior corporate employee should be accorded only one common title in MyWikiBiz, to optimize semantic searching. The more that users adhere to this guideline, the more likely their data will be found by people using MyWikiBiz's semantic search utility. Furthermore, if in doubt about MyWikiBiz's "preferred" rank and nomenclature of titles, the following list should be used to force consensus across the many differences that appear in the corporate working world. Within MyWikiBiz, please use only the following labels when naming Key Person titles:

  • Chair (as opposed to Chairperson, Chairman, Chairwoman, etc.)
  • Board (use for any non-Chair members of a Board of Directors)
  • CEO (as opposed to Chief Executive Officer, Executive Director, President, Owner, etc.)
  • CFO (as opposed to Chief Financial Officer, Controller, etc.)
  • COO (as opposed to Chief Operations Officer, Senior Operations Manager, etc.)
  • CIO (as opposed to Chief Information Officer, Senior Technologist, MIS Director, etc.)
  • CMO (as opposed to Chief Marketing Officer, Communications Director, Director of Public Affairs, etc.)
  • SVP (as opposed to Senior Vice President, Executive Vice President, Regional Director, Division Head, etc.)
  • VP (as opposed to Vice President, Senior Manager, etc.)
  • Manager (use as a catch-all for any middle management titles)
  • Legal (as opposed to Attorney, Corporate Counsel, General Counsel, etc.)

Additionally, consider whether the Founder of an organization is also the CEO or Chair (in which case use the CEO or Chair nomenclature), or whether he or she has been relegated to some non-executive role such as "Spokesperson", "Advisor", or some other honorary title (in which case, do not include this person as a Key Person in the Infobox; rather, notate them in the Founder field and feel free to write about them in the article space).

Adherence to this Style Guideline should by no means be considered mandatory, nor a perjorative assessment of any person's "actual" title at their company. It is merely a mechanism to make semantic searching more productive for more MyWikiBiz users. If only three companies in the United States choose to call their CIO the Data Ninja, that's very cute, but not at all useful to MyWikiBiz users who are looking for CIO types of personnel in the state of Michigan.

(Note: any additions to the list above should first reach consensus on this entry's Discussion page.)

Calendar Dates

Template:Further

While the overall organization of MyWikiBiz is flat, certain sections do conform to traditional hierarchical structuring. Calendar dates are one such area. MyWikiBiz takes advantage of MediaWiki's built-in subpage cross-referencing feature to facilitate hierarchical organization. Subpages are generated easily by adding a forward-slash ( / ) at the end of the page address, followed by the name of the subpage. For example, to make a month's subpage of the page about the year [[2005]], one might make a page called [[2005/July]].

Organization

Years, months and days have their own Main page articles -- for example 2005, December and December 20.

For non-repeating dating purposes, months are treated as subpages within the respective years in which they occur -- for example, July 20, 2005.

  • References to year-month-day are useful for specific items such as a historical events, newspaper article publishing dates, etc.

For repeating dating purposes, days are treated as stand alone dates with respect to the months in which they occur -- for example, March 10.

  • References to month-day are useful for such items as almanac listings without regard to the actual years in which they occurred; e.g., all births of famous actors which occurred on June 1, all deaths of notable scientists which occurred on December 20, etc.