Difference between revisions of "Article Standards"
Line 2: | Line 2: | ||
A standardized article for reference: [[Colusa & Lake Railroad]] | A standardized article for reference: [[Colusa & Lake Railroad]] | ||
<span style="float:right;">__TOC__</span> | <span style="float:right;">__TOC__</span> | ||
All article pages for railroads should start with the heading: History (H3) | |||
'''Short or "Wiki" style article'''<br /> | '''Short or "Wiki" style article'''<br /> | ||
Line 15: | Line 18: | ||
Both styles of History write ups should not be longer than 4-5 paragraphs. Additional histories on detailed subjects should be stubbed from the main railroad page, keeping the page text to a minimum. For extended and/or thorough histories, see “Articles” below. Some operations worked in multiple areas, under the same Corporate Parent. (SNW&L, Truckee Lumber, etc). For these operations the railroad should be listed as a sub-company of the parent. | Both styles of History write ups should not be longer than 4-5 paragraphs. Additional histories on detailed subjects should be stubbed from the main railroad page, keeping the page text to a minimum. For extended and/or thorough histories, see “Articles” below. Some operations worked in multiple areas, under the same Corporate Parent. (SNW&L, Truckee Lumber, etc). For these operations the railroad should be listed as a sub-company of the parent. | ||
On the site we’ve been listing them in the following format: | On the site we’ve been listing them in the following format: '' This needs revision '' | ||
Lake Tahoe Narrow Gauge Railroad. (Heading) | Lake Tahoe Narrow Gauge Railroad. (Heading) | ||
Carson & Tahoe Lumber & Fluming Company. (Sub-Heading) | Carson & Tahoe Lumber & Fluming Company. (Sub-Heading) | ||
Line 32: | Line 35: | ||
===Article Graphics=== | ===Article Graphics=== | ||
For initial articles on a railroad, it is suggested to avoid adding more than 1 or 2 graphics inline. Extended articles can include more graphics as | For initial articles on a railroad, it is suggested to avoid adding more than 1 or 2 graphics inline. Extended articles can include more graphics dependent on length. These images should be placed to match the narrative of the article as closely as possible. Additional images and galleries should be placed at the end of the article or on a separate page as needed. See: Galleries and Locomotive / Equipment Pages | ||
Note: All articles are subject to editorial/layout changes as the Webmaster and/or Editor see fit to match the site's overall style. | '' Note: All articles are subject to editorial/layout changes as the Webmaster and/or Editor see fit to match the site's overall style. '' | ||
===Units, Measures and Dates=== | ===Units, Measures and Dates=== | ||
Railroad gauge should always be expressed in inches. 36” rather than 3'. | Railroad gauge should always be expressed in inches. 36” rather than 3' and avoid using ' or " to represent feet and inches, instead use 36in. | ||
Meter and other gauges should always be expressed in longhand (Meter Gauge, Monorail). | Meter and other gauges should always be expressed in longhand (Meter Gauge, Monorail). | ||
All units and measurements should be written in Imperial and Metric units in the following style: 2.5 | All units and measurements should be written in Imperial and Metric units in the following style: 2.5 mi (4km) | ||
'' Revision Dates should use the following format: Revised: Month Day, Year '' - Revision dates are now automatic. Delete this reference. | |||
'' | ===Tables=== | ||
Tables are complex and difficult to format without a reference. Multiple online tools exist like: [https://www.tablesgenerator.com/mediawiki_tables#] allowing for simplified table creation including copying and pasting the data into the table before hand. Large spreadsheets of data should be uploaded to the site in .pdf format rather than posted directly to a page. ''This may be revised down the road'' | |||
===Citations=== | ===Citations=== | ||
Line 52: | Line 58: | ||
===Attribution=== | ===Attribution=== | ||
All complete articles written by a member of PacificNG or Contributor should include a proper notation of their work. | All complete articles written by a member of PacificNG or Contributor should include a proper notation of their work. This includes article rewrites or continuations handled by additional members. In this situation, all of the article authors should be given credit. Compiled "wiki format" pages can use a "Compiled by" attribution. Do not nee | ||
Examples: | |||
Compiled by <Author> | |||
By <Author> | |||
By <Author 1>, <Author 2>, and <Author 3> | |||
Other attributions should be included in the citations at the end of the article. | |||
===Creative Commons=== | ===Creative Commons=== | ||
Whenever possible, articles written for the site should be issued a creative commons license. All photographs or documents attributed to PacificNG are to be covered by CC | Whenever possible, articles written for the site should be issued a creative commons license. All photographs or documents attributed to PacificNG are to be covered by CC For public, non commercial use: http://creativecommons.org/licenses/by-nc/4.0/ | ||
For public, non commercial use: http://creativecommons.org/licenses/by-nc/4.0/ | |||
Cite: “<DocName>” by <Creator> is licensed under CC BY-NC 4.0 | Cite: “<DocName>” by <Creator> is licensed under CC BY-NC 4.0 | ||
See examples: https://wiki.creativecommons.org/wiki/Marking_your_work_with_a_CC_license#Example:_Image | See examples: https://wiki.creativecommons.org/wiki/Marking_your_work_with_a_CC_license#Example:_Image | ||
Authors retain copyright control on their own works or submissions. | |||
===Data Column=== | ===Data Column=== | ||
Line 65: | Line 77: | ||
Examples of information to be included: Incorporation Dates, Corporate Ownership, Length of Road, Rail Weights, Tie Dimensions | Examples of information to be included: Incorporation Dates, Corporate Ownership, Length of Road, Rail Weights, Tie Dimensions | ||
Railroads that had several owners listed under the Corporate Ownership heading should link to the related page. | Railroads that had several owners listed under the Corporate Ownership heading should link to the related page. | ||
Railroads that operate with multiple names / corporate owners should include a list of these names and dates. These names will be used to in-link to related pages. | Railroads that operate with multiple names / corporate owners should include a list of these names and dates. These names will be used to in-link to related pages. | ||
==Reference Standards== | ==Reference Standards== | ||
The list below contains the standard sub-headings titles to be used on article pages for grouping reference materials. | The list below contains the standard sub-headings titles to be used on article pages for grouping reference materials. All sub-headings should be sorted alphabetically on article pages. '' Sub-Headings subject to change '' | ||
===Articles=== | ===Articles=== | ||
Line 80: | Line 90: | ||
===Equipment Rosters=== | ===Equipment Rosters=== | ||
Use Equipment Rosters for the heading on pages rather than "Roster". The final format of rosters has not been decided. At this time only small rosters are being posted to the site until this solution is in place. | Use Equipment Rosters for the heading on pages rather than "Roster". The final format of rosters has not been decided. At this time only small rosters are being posted to the site until this solution is in place. | ||
===Government Reports=== | |||
ICC Valuations, PUC Valuations, Reports, Surveys | |||
===Newspaper Clippings=== | ===Newspaper Clippings=== | ||
Line 89: | Line 102: | ||
===Photographs=== | ===Photographs=== | ||
Every railroad | Every railroad album in our image gallery. In lieu of linking to the Album, linking to the relevant keyword (i.e Porter, Baldwin, 4-4-0). | ||
Additional links to galleries | Additional external links to galleries (SPNGHS, SVRY) should be linked under this heading. Images placed inline the article text can be excluded from image galleries on an article page. | ||
===Manuscripts=== | ===Manuscripts=== | ||
Line 97: | Line 110: | ||
===Painting Information / References=== | ===Painting Information / References=== | ||
Paint notes (contemporary and historic), illustrations. | Paint notes (contemporary and historic), illustrations. | ||
===PacificNG Engineering Survey=== | |||
Any PNGes worksheets should be listed under this heading. | |||
===Historic References=== | ===Historic References=== | ||
Line 106: | Line 122: | ||
PngES reports? Oral histories. | PngES reports? Oral histories. | ||
=== | |||
===Links=== | |||
Related off site links. | |||
===Video=== | ===Video=== | ||
Links to video (historic or contemporary) that pertains to the subject. In most cases these will be contemporary videos. | Links to video (historic or contemporary) that pertains to the subject. In most cases these will be contemporary videos. | ||
==Organization and Collection Links== | ==Organization and Collection Links== | ||
The list below contains the standard headings titles to be used at the bottom of article pages. These should be in H2 size to match "Reference Material Available Online". | The list below contains the standard headings titles to be used at the bottom of article pages. These should be in H2 size to match "Reference Material Available Online" and be listed after sub-headings used in Reference Material Available Online. | ||
===Organizations=== | ===Organizations=== |
Revision as of 11:29, 18 November 2020
This page is a work in progress while article standards are refined for the site. A standardized article for reference: Colusa & Lake Railroad
All article pages for railroads should start with the heading: History (H3)
Short or "Wiki" style article
Short description used on the state index pages. This is to be no more than 3-4 sentences max that provide the most basic description of the road. See any state index page for examples. Note: This brief description is not required for submitting articles.
Basic Histories by Definition
Type A or “Compiled” : These can range in length depending on the information available, but at a minimum should be a full paragraph. Write ups of this type do not need citations, nor a specific author. Articles of this type are suggested for the initial listing of a railroad on the site. Attribution for this type of history is solely up to the discretion of the author. Should the history be assembled from common knowledge or vague sources, it is recommended NOT to include an author’s attribution (ala wiki). In cases where extensive research was required, attribution should always say: “Compiled by XXXXXX”
Type B or “Narrative” : These histories are fully fleshed out with citations (Biblio style minimum, in line citations are optional but welcomed) and provide a consistent telling of the railroad’s history. Articles of this type are generally going to be researched and take some time to get written and put on the site. All histories of this type should carry attribution to the author in the form of “By XXXXXX”.
Both styles of History write ups should not be longer than 4-5 paragraphs. Additional histories on detailed subjects should be stubbed from the main railroad page, keeping the page text to a minimum. For extended and/or thorough histories, see “Articles” below. Some operations worked in multiple areas, under the same Corporate Parent. (SNW&L, Truckee Lumber, etc). For these operations the railroad should be listed as a sub-company of the parent.
On the site we’ve been listing them in the following format: This needs revision Lake Tahoe Narrow Gauge Railroad. (Heading) Carson & Tahoe Lumber & Fluming Company. (Sub-Heading)
This formatting will allow for the eventual connection to the Corporate Parent directly.
Article Tips:
1. Always remember to include: Who, What, When, Where, Why
2. Always write the complete company name one or two times before switching to abbreviations.
3. In-Linking to articles on our site and/or Wikipedia (or Mindat) within your narrative is encouraged. One of our goals with PacificNG is to build interest in other railroads/companies in our focus.
4.
Article Graphics
For initial articles on a railroad, it is suggested to avoid adding more than 1 or 2 graphics inline. Extended articles can include more graphics dependent on length. These images should be placed to match the narrative of the article as closely as possible. Additional images and galleries should be placed at the end of the article or on a separate page as needed. See: Galleries and Locomotive / Equipment Pages Note: All articles are subject to editorial/layout changes as the Webmaster and/or Editor see fit to match the site's overall style.
Units, Measures and Dates
Railroad gauge should always be expressed in inches. 36” rather than 3' and avoid using ' or " to represent feet and inches, instead use 36in. Meter and other gauges should always be expressed in longhand (Meter Gauge, Monorail). All units and measurements should be written in Imperial and Metric units in the following style: 2.5 mi (4km)
Revision Dates should use the following format: Revised: Month Day, Year - Revision dates are now automatic. Delete this reference.
Tables
Tables are complex and difficult to format without a reference. Multiple online tools exist like: [1] allowing for simplified table creation including copying and pasting the data into the table before hand. Large spreadsheets of data should be uploaded to the site in .pdf format rather than posted directly to a page. This may be revised down the road
Citations
All citations should conform to the standards set by the Chicago Manual of Style 17th Edition.
Contributors/Authors are not required to furnish citations in this format, the Webmaster/Editor is expected to reformat these when the page is created. The Webmaster and/or Editor does appreciate the effort however.
At present we are only using Bibliography and/or Inline Citations as outlined by the Chicago Manual. For editorial notes and additional sources (not used in the history), please see: “Additional Sources”.
Attribution
All complete articles written by a member of PacificNG or Contributor should include a proper notation of their work. This includes article rewrites or continuations handled by additional members. In this situation, all of the article authors should be given credit. Compiled "wiki format" pages can use a "Compiled by" attribution. Do not nee
Examples: Compiled by <Author> By <Author> By <Author 1>, <Author 2>, and <Author 3>
Other attributions should be included in the citations at the end of the article.
Creative Commons
Whenever possible, articles written for the site should be issued a creative commons license. All photographs or documents attributed to PacificNG are to be covered by CC For public, non commercial use: http://creativecommons.org/licenses/by-nc/4.0/ Cite: “<DocName>” by <Creator> is licensed under CC BY-NC 4.0 See examples: https://wiki.creativecommons.org/wiki/Marking_your_work_with_a_CC_license#Example:_Image Authors retain copyright control on their own works or submissions.
Data Column
The data column is optional. If included it should provide a quick summary of data relating to the railroad. Examples of information to be included: Incorporation Dates, Corporate Ownership, Length of Road, Rail Weights, Tie Dimensions Railroads that had several owners listed under the Corporate Ownership heading should link to the related page. Railroads that operate with multiple names / corporate owners should include a list of these names and dates. These names will be used to in-link to related pages.
Reference Standards
The list below contains the standard sub-headings titles to be used on article pages for grouping reference materials. All sub-headings should be sorted alphabetically on article pages. Sub-Headings subject to change
Articles
Articles on specific topics related to the railroad. This can include extended histories of the railroad, discussion of specific areas, details or people. Extended articles should follow the same citation guidelines as described above. There is no length limit to extended histories/articles.
Drawings
Drawings of specific equipment, facilities, or hardware related to the railroad. Example: Curtis F's Baldwin frame drawings.
Equipment Rosters
Use Equipment Rosters for the heading on pages rather than "Roster". The final format of rosters has not been decided. At this time only small rosters are being posted to the site until this solution is in place.
Government Reports
ICC Valuations, PUC Valuations, Reports, Surveys
Newspaper Clippings
Our newspaper database is pending and the final format of rosters has not been decided. At this time only small rosters are being posted to the site until this solution is in place.
Maps
Should include a Google Earth map on our site. Can also link to maps made by others if they are up to our quality standards (Dave Dye).
Photographs
Every railroad album in our image gallery. In lieu of linking to the Album, linking to the relevant keyword (i.e Porter, Baldwin, 4-4-0). Additional external links to galleries (SPNGHS, SVRY) should be linked under this heading. Images placed inline the article text can be excluded from image galleries on an article page.
Manuscripts
Reserved for original documents related to the railroad. This can include: work orders, receipts, ledgers and other items copied from historic collections.
Painting Information / References
Paint notes (contemporary and historic), illustrations.
PacificNG Engineering Survey
Any PNGes worksheets should be listed under this heading.
Historic References
Links to books that mention the subject. In most cases these should be HISTORIC books. This includes periodicals, historic fliers and oral histories.
Contemporary References
“Additional Sources” Page. Additional sources that are noteworthy, but not used in the primary history article should be listed on a page stubbed from the primary article. PngES reports? Oral histories.
Links
Related off site links.
Video
Links to video (historic or contemporary) that pertains to the subject. In most cases these will be contemporary videos.
Organization and Collection Links
The list below contains the standard headings titles to be used at the bottom of article pages. These should be in H2 size to match "Reference Material Available Online" and be listed after sub-headings used in Reference Material Available Online.
Organizations
Links to and/or names of contemporary organizations / historical societies related to the railroad.
Collections
Links to and/or names of institutions with holdings related to the railroad and/or it's founders.