Difference between revisions of "Good stub"

From PC-BSD Wiki
Jump to: navigation, search
m
m (Example)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
''This is a description of a PC-BSD wiki standard.''
 
''This is a description of a PC-BSD wiki standard.''
  
A good preliminary page [[w:stub|stub]] is very easy to write. It consists of:
+
A good preliminary page [[wikipedia:stub|stub]] is very easy to write. It consists of:
  
#A first paragraph saying what the head term describes. The head term should be in '''bold''' type. One sentence is quite adequate.
+
# A first paragraph saying what the head term describes. The head term should be in '''bold''' type. One sentence is quite adequate.
#A second paragraph saying why the subject is important enough to document on a PC-BSD wiki page. Again one sentence is adequate.
+
# A second paragraph saying why the subject is important enough to document on a PC-BSD wiki page. Again one sentence is adequate.
#Optionally, a third paragraph giving relevant applicable external links as a bulleted list. This should have a heading of ''External link(s)''.
+
# Optionally, a third paragraph giving relevant applicable external links as a bulleted list. This should have a heading of ''External link(s)''.
#Recommended: An outline of topics or ideas to help others continue to expand the page.  
+
# Recommended: An outline of topics or ideas to help others continue to expand the page.  
#Our [[template:StubWarning|stub warning]].
+
# Our [[template:StubWarning|stub warning]].
  
 
That's all! If you can write such a stub, this is an alternative to removing a sub-standard page, and can be very useful in the process of creating or revising the PC-BSD Handbook. Also, it is a way to handle suspected [[wikipedia:copyright violation|copyright violation]]s. In particular, if the text exists on the web already, make that an external link which also helps to feed back into the community by increasing interconnectedness.
 
That's all! If you can write such a stub, this is an alternative to removing a sub-standard page, and can be very useful in the process of creating or revising the PC-BSD Handbook. Also, it is a way to handle suspected [[wikipedia:copyright violation|copyright violation]]s. In particular, if the text exists on the web already, make that an external link which also helps to feed back into the community by increasing interconnectedness.
  
If you can write a better stub, or even a PC-BSD wiki page, so much the better. Always remember that stubs are ''only'' useful if ''someone'' develops them into a detailed and coherent PC-BSD wiki page. See also [[PC-BSD wiki:Perfect page stub]].
+
If you can write a better stub, or even a PC-BSD wiki page, so much the better. Always remember that stubs are ''only'' useful if ''someone'' develops them into a detailed and coherent PC-BSD wiki page. <!-- See also [[PC-BSD wiki:Perfect page stub]]. -->
  
==Example==
+
== Example ==
  
 
Imagine that a detailed page from a (mythological and fabricated for this example) site www.alter-microsquish-vacs.com.py has been posted with no explanation, and appears to be a likely copyright violation. It describes the (also fantastical for this example) device, Max'O'slydePad 9000, which is the page name. The following stub, which would take only a quick moment to compose, would be appropriate:   
 
Imagine that a detailed page from a (mythological and fabricated for this example) site www.alter-microsquish-vacs.com.py has been posted with no explanation, and appears to be a likely copyright violation. It describes the (also fantastical for this example) device, Max'O'slydePad 9000, which is the page name. The following stub, which would take only a quick moment to compose, would be appropriate:   
  
<nowiki>
+
<code><nowiki>
'''Max-O-slydePad 9000''' is a device made to compete with the [[caress|Banana Tote Caress]] by Electric Plantain Village</nowiki>
+
'''Max-O-slydePad 9000''' is a device made to compete with the [[caress|Banana Tote Caress]] by Electric Plantain Village.
 +
</nowiki></code>
  
<nowiki>
+
<code><nowiki>
It is the most recent product by [[microsquish|Alter Microsquish Vacs Corporation]] of Pearl Island, and incorporates the latest Supra-Glide technology. </nowiki>
+
It is the most recent product by [[microsquish|Alter Microsquish Vacs Corporation]] of Pearl Island, and incorporates the latest Supra-Glide technology. </nowiki></code>
  
<nowiki>==External links==</nowiki>
+
<code><nowiki>
 +
== External links ==
 +
</nowiki></code>
  
<nowiki>*[www.alter-microsquish-vacs.com\mosp9k.htm Detailed description and retail outlet]</nowiki>  
+
<code><nowiki>
 +
* [www.alter-microsquish-vacs.com\mosp9k.htm Detailed description and retail outlet]
 +
</nowiki></code>
  
<nowiki>{{StubWarning | icon = favicon | category = handbook | stubcategory = maxoslyde }}</nowiki>
+
<code><nowiki>
 +
{{StubWarning | icon = favicon | category = handbook | stubcategory = maxoslyde }}
 +
</nowiki></code>
  
  
[[Category:PC-BSD Wiki standard]]
+
[[Category:PC-BSD Wiki standard]] <!-- not sure if this should be categorized in 'stubs'
[[category:stubs]]
+
<noinclude>[[category:stubs]]</noinclude> -->

Latest revision as of 04:12, 9 July 2012

This is a description of a PC-BSD wiki standard.

A good preliminary page stub is very easy to write. It consists of:

  1. A first paragraph saying what the head term describes. The head term should be in bold type. One sentence is quite adequate.
  2. A second paragraph saying why the subject is important enough to document on a PC-BSD wiki page. Again one sentence is adequate.
  3. Optionally, a third paragraph giving relevant applicable external links as a bulleted list. This should have a heading of External link(s).
  4. Recommended: An outline of topics or ideas to help others continue to expand the page.
  5. Our stub warning.

That's all! If you can write such a stub, this is an alternative to removing a sub-standard page, and can be very useful in the process of creating or revising the PC-BSD Handbook. Also, it is a way to handle suspected copyright violations. In particular, if the text exists on the web already, make that an external link which also helps to feed back into the community by increasing interconnectedness.

If you can write a better stub, or even a PC-BSD wiki page, so much the better. Always remember that stubs are only useful if someone develops them into a detailed and coherent PC-BSD wiki page.

[edit] Example

Imagine that a detailed page from a (mythological and fabricated for this example) site www.alter-microsquish-vacs.com.py has been posted with no explanation, and appears to be a likely copyright violation. It describes the (also fantastical for this example) device, Max'O'slydePad 9000, which is the page name. The following stub, which would take only a quick moment to compose, would be appropriate:

'''Max-O-slydePad 9000''' is a device made to compete with the [[caress|Banana Tote Caress]] by Electric Plantain Village.

It is the most recent product by [[microsquish|Alter Microsquish Vacs Corporation]] of Pearl Island, and incorporates the latest Supra-Glide technology.

== External links ==

* [www.alter-microsquish-vacs.com\mosp9k.htm Detailed description and retail outlet]

{{StubWarning | icon = favicon | category = handbook | stubcategory = maxoslyde }}

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox