Difference between revisions of "LIMSWiki:Product page"
Shawndouglas (talk | contribs) (Created help article.) |
Shawndouglas (talk | contribs) m (Updated example.) |
||
(2 intermediate revisions by the same user not shown) | |||
Line 194: | Line 194: | ||
Obviously pages can be much more dynamic and contain much more content, as long that content is able to be supported with a fair mix of independent and non-independent sources. | Obviously pages can be much more dynamic and contain much more content, as long that content is able to be supported with a fair mix of independent and non-independent sources. | ||
==Example pages== | |||
Example of a laboratory equipment article stub: [[Sonifier_S-450A|Branson Ultrasonic Corporation's Sonifier S-450A]] | |||
Example of an open-source software article stub: [[OpenELIS]] | |||
<!---Place all category tags here--> | |||
[[Category:LIMSwiki help documentation]] |
Latest revision as of 16:55, 26 October 2012
Like Wikipedia, product pages are going to be allowed on LIMSwiki.org. Also like Wikipedia, certain standards are expected of a product page:
- A product page shouldn't be created unless it meets notability guidelines. As Wikipedia defines it, "notability is an attempt to assess whether the topic has 'enduring notability,' as evidenced by significant coverage in reliable secondary sources that are independent of the topic."
- As mentioned above, a product page should be predominately based on reliable independent sources. While a product page can certainly contain self-supported, non-independent sources to back up company claims, these should not make up the majority of the sources.
- A product page should be neutral and not contain marketing speak.
- A product page should not read like an advertisement.
Product page format
A product page can have many different formats, based upon available information (or lack thereof) about the product. However, there are a few defining elements of a product page that need to be included:
1. Either a hardware or software info box: The two predominate infobox types that are used are Template:Infobox laboratory equipment and Template:Infobox software (with the potential of more being added as necessary), and they are used to insert a software-based info box into a product page.
Infobox laboratory equipment
The code for a laboratory equipment infobox (with all the available attributes) looks like this:
{{Infobox laboratory equipment |name = |image = |alt = <!-- Alternative text for images --> |caption = |acronym = |other_names = |uses = |notable_experiments = |inventor = |manufacturer = |model = |related = |website = [http://example.org example.org] }}
Obviously not all of these attributes will be needed for a piece of laboratory equipment. Those attributes not used can either be removed from the inserted code or left intact for future use. (See below for an example.)
For more detailed information on what each parameter means, please read the documentation on Template:Infobox laboratory equipment. |
Infobox software
The code for a software infobox (with all the available attributes) looks like this:
{{Infobox software | name = | title = | logo = <!-- [[File: ]] --> | screenshot = <!-- [[File: ]] --> | caption = | collapsible = | author = | developer = | released = <!-- {{Start date|YYYY|MM|DD|df=yes/no}} --> | discontinued = | latest release version = | latest release date = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} --> | latest preview version = | latest preview date = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} --> | frequently updated = <!-- DO NOT include this parameter unless you know what it does --> | programming language = | operating system = | platform = | size = | language = | status = | genre = | license = | website = [http://example.org example.org] }}
Obviously not all of these attributes will be needed for a software product. Those attributes not used can either be removed from the inserted code or left intact for future use. (See below for an example.)
For more detailed information on what each parameter means, please read the documentation on Template:Infobox software. |
2. An introductory paragraph or two that introduces the software and what it does
3. A history of the software product
4. A description of the software product's most important features
5. Any applicable hardware and software requirements for the specific product to function as intended (usually only for software products)
Example code
Laboratory equipment example
Here's example code that a laboratory equipment article stub may start out with:
{{Infobox laboratory equipment |name = ZYX Tabletop Microscope |image = |alt = <!-- Alternative text for images --> |caption = |acronym = |other_names = ZYX |uses = [[Digital microscopy]] |notable_experiments = |inventor = |manufacturer = [[ZYX Industries, Inc.]] |model = ZYX-ABC123 |related = [[ABC Tabletop Microscope]] |website = [http://zyxindustries.com ZYXIndustries.com] }} This is an intro paragraph about the product. ==Product history== This is the history of the product. ==Features== This is a brief description of the key features. ==Hardware/software requirements== If applicable, add any additional interfacing requirements or additional equipment needed to use the product. ==References== <references /> <!---Place all category tags here--> [[Category:Digital microscope]]
Obviously pages can be much more dynamic and contain much more content, as long that content is able to be supported with a fair mix of independent and non-independent sources.
Software example
Here's example code that a software article stub may start out with:
{{Infobox software | name = ABCXYZ LIMS | title = '''ABCXYZ LIMS''' | logo = <!-- [[File: ]] --> | screenshot = <!-- [[File: ]] --> | caption = | collapsible = | author = | developer = [[ABCXYZ, Inc.]] | released = <!-- {{Start date|2007}} --> | discontinued = | latest release version = 1.2.0 | latest release date = <!-- {{Start date and age|2009|08|19|}} --> | latest preview version = | latest preview date = <!-- {{Start date and age|YYYY|MM|DD|df=yes/no}} --> | programming language = Java | operating system = | platform = Java 1.6 or higher | size = | language = | status = Active | genre = [[LIMS]] | license = Proprietary commercial software | website = [http://www.abcxyz.com ABCXYZ.com] }} This is an intro paragraph about the software product. ==Product history== This is the history of the product. ==Features== This is a brief description of the key features. ==Hardware/software requirements== This is a description of the hardware and software requirements for running the product. '''Additional requirements to use the software:''' ==References== <references /> <!---Place all category tags here--> [[Category:Laboratory information management systems]]
Obviously pages can be much more dynamic and contain much more content, as long that content is able to be supported with a fair mix of independent and non-independent sources.
Example pages
Example of a laboratory equipment article stub: Branson Ultrasonic Corporation's Sonifier S-450A
Example of an open-source software article stub: OpenELIS