Difference between revisions of "Help:Tutorial"
m (Centiare:Tutorial moved to Help:Tutorial) |
(→Directory Space: Splitting living and deceased with estate, etc.) |
||
(One intermediate revision by one other user not shown) | |||
Line 3: | Line 3: | ||
<br> | <br> | ||
=Demonstration= | =Demonstration= | ||
− | Check out | + | Check out MyWikiBiz's [[Help:Demonstration|'''Demonstration''']] area to see a collection of pages that highlight MyWikiBiz's ''Directory'' listing and search-result capabilities. |
=Nuts & Bolts= | =Nuts & Bolts= | ||
Line 9: | Line 9: | ||
==Directory Space== | ==Directory Space== | ||
− | '''''Directory Space''''' is a protected [[ | + | '''''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: | 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: | + | * Commercial Enterprise - [[Directory:LunaGraphica|LunaGraphica]] |
− | * Non-Profit Organization - [[Directory: | + | * Non-Profit Organization - [[Directory:The USS Rankin Association|USS Rankin Association]] |
− | * Government | + | * Government, Agency, or Political Entity - [[Directory:Huntington Beach, California|City of Huntington Beach]] |
− | * Person (Living | + | * 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]] | * 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: | 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: | ||
− | * [[Central Index Key]] | + | * Things - [[Central Index Key]] |
− | * [[North America Industry Classification System]] | + | * Systems - [[North America Industry Classification System]] |
− | * [[Sir Isaac Newton]] | + | * Person (Deceased, with no active estate) - [[Sir Isaac Newton]] |
− | * [[Wealth of Nations]] | + | * Property (with no assets or royalties) - [[Wealth of Nations]] |
===Discussion=== | ===Discussion=== | ||
− | '''Note''' Discussions regarding Directory listing entries should take place in the respective [[ | + | '''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== | ==Semantic Tagging== | ||
− | When you're ready to create your own Directory listing on | + | 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 | :*[[NAICS]] code | ||
::...and/or... | ::...and/or... | ||
Line 43: | Line 44: | ||
=Style Guidelines= | =Style Guidelines= | ||
− | {{further|[[ | + | {{further|[[Help:Manual of Style]]}} |
==Use the ''official'' NAICS names== | ==Use the ''official'' NAICS names== | ||
− | When you indicate the industry in which you work, it will be most helpful to future [[Special:SearchTriple|semantic searches]] and [[ | + | 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 line of work "Goober Growing", but if you choose that name within | + | 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: | + | 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 60: | Line 61: | ||
::...etc. | ::...etc. | ||
− | Ideally and if possible, any senior corporate employee should be accorded only one common title in | + | 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 76: | 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 | + | 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 [[ | + | (Note: any additions to the list above should first reach consensus on this entry's [[MyWikiBiz_talk:Tutorial|Discussion]] page.) |
==Calendar Dates== | ==Calendar Dates== | ||
− | {{further|[[ | + | {{further|[[Help:Manual of Style (dates and numbers)]]}} |
− | While the overall organization of | + | 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=== | ===Organization=== |
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:
- Commercial Enterprise - LunaGraphica
- Non-Profit Organization - USS Rankin Association
- Government, Agency, or Political Entity - City of Huntington Beach
- Person (Living) - Liz Cohen
- Person (Deceased, with active estate) - Estate of Carl Sagan
- Property - 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 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:
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
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
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.