Difference between revisions of "Manual:FAQ"
| Line 8: | Line 8: | ||
__TOC__ | __TOC__ | ||
| − | + | ==General== | |
| + | ===What is this project all about?=== | ||
| + | This project is funded by ESTCP as part of their technology transfer program to develop a new and sustainable resource that provides the most up-to-date information about environmental restoration technologies for entry and mid level soil and groundwater remediation project managers and regulators. The resource will take the form of a "wiki" to provide easy internet access to the most complete collection of repositories of published materials and offer concise articles on an ever-growing list of topics by the most trusted and recognized experts in their respective fields. The ultimate goal is to provide the most accurate information, easily accessible for practitioners to make the best decisions about their remediation projects. | ||
| + | [[#top|Return to Top]] | ||
| + | ===What is expected of Authors?=== | ||
| + | The term "author" and "contributor" will be used interchangeably when talking about Remediapedia. | ||
==Content== | ==Content== | ||
===What do we mean by "content"?=== | ===What do we mean by "content"?=== | ||
| Line 36: | Line 41: | ||
Contributors should limit content to concise, easy to comprehend pages so that a reader only needs to scroll 2 or 3 screen lengths (assuming a standard 21" monitor) to read the full article. If your article needs to be much longer, consider dividing your topic into multiple pages so that appropriate sections can be "stand-alone" articles linked to each other. When an article needs to be longer to provide meaningful continuity of topic, exceptions are made, realizing that some topics will be complex and require development of concepts not easily condensed. | Contributors should limit content to concise, easy to comprehend pages so that a reader only needs to scroll 2 or 3 screen lengths (assuming a standard 21" monitor) to read the full article. If your article needs to be much longer, consider dividing your topic into multiple pages so that appropriate sections can be "stand-alone" articles linked to each other. When an article needs to be longer to provide meaningful continuity of topic, exceptions are made, realizing that some topics will be complex and require development of concepts not easily condensed. | ||
[[#top|(Return to Top)]] | [[#top|(Return to Top)]] | ||
| + | ===What level of detail should my article develop?=== | ||
| + | Wiki articles will vary in degree of detail. A well researched and proven technology, for example, may offer rich detail. A new technology or innovation in the research & development stages may offer less detail. | ||
| + | |||
| + | As a rule of thumb, articles should offer a general introduction/summary of the topic that is easy for all readers to understand. The topic can develop more detail in subsequent sections within the article. If a topic looks like it might contain one or more sections that would easily be their own self contained article, the contributor is advised to develop such sections as a new page linked back to the original page. The contributor must balance the need detailed subtopics spanning multiple pages with the need for a single cohesive page with the goal of simple concise page views. | ||
| + | [[#top|(Return to Top)]] | ||
| + | ===What should be the subheadings of my article?=== | ||
| + | Contributors have latitude to construct sections (headings) and subsections (subheadings) as needed to organize content in a meaningful way. The only structural exceptions are for each article to begin with an introduction and have a "See Also" section at the end to provide the reader with additional links to related content that may be on Remediapedia or another source, such as SERDP/ESTCP reports. | ||
| + | |||
| + | "References" is another standard section heading that will be automatically populated using the references you provide inside your article content. | ||
| + | [[#top|Return to Top]] | ||
==Format== | ==Format== | ||
=== What is the format for my article(s)?=== | === What is the format for my article(s)?=== | ||
Revision as of 20:31, 2 November 2015
| Frequently asked questions (FAQ)
This space is provided to address questions about use of the wiki in general. Wiki contributors should check here first to help understand their role in developing content for the wiki. If you have a question not addressed here, CONTACT US and we will response soon. |
Contents
- 1 General
- 2 Content
- 2.1 What do we mean by "content"?
- 2.2 What is an article?
- 2.3 What is a page?
- 2.4 What is a contributor?
- 2.5 How should contributors submit their content?
- 2.6 Who is the main target audience for this wiki?
- 2.7 How long should a wiki article be?
- 2.8 What level of detail should my article develop?
- 2.9 What should be the subheadings of my article?
- 3 Format
- 4 Organization
- 5 References
General
What is this project all about?
This project is funded by ESTCP as part of their technology transfer program to develop a new and sustainable resource that provides the most up-to-date information about environmental restoration technologies for entry and mid level soil and groundwater remediation project managers and regulators. The resource will take the form of a "wiki" to provide easy internet access to the most complete collection of repositories of published materials and offer concise articles on an ever-growing list of topics by the most trusted and recognized experts in their respective fields. The ultimate goal is to provide the most accurate information, easily accessible for practitioners to make the best decisions about their remediation projects. Return to Top
What is expected of Authors?
The term "author" and "contributor" will be used interchangeably when talking about Remediapedia.
Content
What do we mean by "content"?
Content is the collection of text, tables, images, and videos that Contributors provide to create an article.(Return to Top)
What is an article?
An article is the presentation of content on a page. Each article is a uniquely identifiable topic. An article may have one or several sections. The sections are logical divisions of topics (or subtopics) within the article. (Return to Top)
What is a page?
A page is essentially the location of the article on the wiki. It can be easily accessed with links from one page to another. The terms "page" and "article" may be used interchangeably as long as it is recognized that the article is the content and the page is the place where the content resides. (Return to Top)
What is a contributor?
Remediapedia is initially being developed with select input from experts in their respective environmental restoration topic areas. Recognizing that these experts may collaborate with their peers and/or staffs to complete an article, the project will collectively recognize them as "contributors". Original authors of the content will be noted as the first contributor as is customary for science papers and reports. Since a wiki is organic on the web and not static as in a physical book, it is anticipated that facts and understandings will be updated as they are developed. Consequently, future contributors may be recognized leaders in a given environmental restoration topic that have not yet been included in the original work.
Each contributor's name will be linked to a special contributor's profile page that provides the reader with a short bio, contact information and relevant links (e.g. a contributor's website). To that end, contributors are asked to provide their personal profile information at the time they submit articles using the format described in the Format Section of this FAQ. (Return to Top)
How should contributors submit their content?
In General
For Remediapedia, the Environmental Restoration Wiki ( also called ERWiki), contributors may submit their text and tables to wiki staff in a standard MicroSoft Word format (.doc or .docx extension) and their images in high resolution .jpg or .png format. The contractors who are developing this wiki platform will convert the contributor's materials to wiki format using standard wiki markup code. Any contributor who is already familiar with wiki markup is free to format their article directly on the wiki. If a contributor has ever provided content on mainstream wikis such as Wikipedia, they will be able to write directly to the wiki. Any contributor interested in / comfortable with editing within the wiki framework can receive help from the Wiki Staff to accomplish this.(Return to Top)
Outline
Main Article
Who is the main target audience for this wiki?
The main target audience of the wiki is Department of Defense (DoD) Remedial Project Managers (RPMs) and regulators who actually manage and regulate environmental restoration (ER) projects. However, we also want the Wiki to be useful to a range of audiences including consultants, students and researchers. (Return to Top)
How long should a wiki article be?
Contributors should limit content to concise, easy to comprehend pages so that a reader only needs to scroll 2 or 3 screen lengths (assuming a standard 21" monitor) to read the full article. If your article needs to be much longer, consider dividing your topic into multiple pages so that appropriate sections can be "stand-alone" articles linked to each other. When an article needs to be longer to provide meaningful continuity of topic, exceptions are made, realizing that some topics will be complex and require development of concepts not easily condensed. (Return to Top)
What level of detail should my article develop?
Wiki articles will vary in degree of detail. A well researched and proven technology, for example, may offer rich detail. A new technology or innovation in the research & development stages may offer less detail.
As a rule of thumb, articles should offer a general introduction/summary of the topic that is easy for all readers to understand. The topic can develop more detail in subsequent sections within the article. If a topic looks like it might contain one or more sections that would easily be their own self contained article, the contributor is advised to develop such sections as a new page linked back to the original page. The contributor must balance the need detailed subtopics spanning multiple pages with the need for a single cohesive page with the goal of simple concise page views. (Return to Top)
What should be the subheadings of my article?
Contributors have latitude to construct sections (headings) and subsections (subheadings) as needed to organize content in a meaningful way. The only structural exceptions are for each article to begin with an introduction and have a "See Also" section at the end to provide the reader with additional links to related content that may be on Remediapedia or another source, such as SERDP/ESTCP reports.
"References" is another standard section heading that will be automatically populated using the references you provide inside your article content. Return to Top
Format
What is the format for my article(s)?
- Text: Submit any document format that is easily accessible on the average computer. Most contributors will likely use Microsoft Word format (e.g. .DOC, .DOCX) or Word compatible document formats (e.g. .TXT, .RTF).
- Tables: Tables are typically formatted within documents so that they will be extracted from text submittals. However, contributors may submit spreadsheets or presentation files (e.g. excel or powerpoint) and even images in the appropriate image format.
- Images: Appropriate image formats are .jpg and.png. High resolution images are preferred (300 ppi or greater).
- Video: MP4 is preferred. However, most video formats can be converted if necessary.
What is the format for my Contributor Personal Profile?
- Contributor's Name: [TITLE] [FIRST NAME] [LAST NAME] [CREDENTIALS]
- Contributor's Work/Contact information: [PLACE OF WORK] [EMAIL ADDRESS] [PHONE NUMBER] [WEBSITE] [SOCIAL MEDIA (e.g. Twitter, Facebook, LinkedIn, etc.)]
- Brief Bio: One hundred (100) words or less including education and professional credentials
Organization
How do I find things on the wiki?
The single-most focal point on the wiki is the Main Page. The main page is an introduction to the wiki with some navigation links provided. The reader can return to the main page from any other page simply by clicking on the Logo int he upper left corner. The main page is NOT a "starting point" for a linear reading experience per se. There is no complete table of contents that directs the reader to various sections as in a book. The wiki is ever changing and never really complete so the most useful navigation experience is by following links within articles of interest.
The second most obvious organizational feature is the sidebar that is present on every page. Remediapedia has included some persistent links that will be located in the sidebar on every page. The reader
The basic structure of the wiki can be visualized as a matrix with pages as the core element. Any page can be accessed by using the top right search window. A page may be associated with one or more related pages by assigning them to a category. A category page is like a directory of related articles that the reader can access to find select topics of interest. For example, Remediapedia has more than one article dealing with the overall topic of common groundwater contaminants. These articles are listed on a category page called Common Groundwater Contaminants.
In a similar way, any content on a given page may be linked to one or more related pages either internally or externally to the wiki. For example, the article Chlorinated Solvents refers to several chlorinated compounds that are already well documented on Wikipedia. Therefore, if a reader wishes to learn more about a compound, a new and redundant page within Remediapedia is not required, but rather a link can take the reader to Wikipedia.
Categories and Links provide a way to organize related topics over multiple pages (articles) and provide the reader an opportunity to obtain a more complete understanding of the subject matter. Contributors are encourage to observe how their individual articles may relate to other articles on Remediapedia and recommend links or category names that will enhance the reader's experience. (Return to Top)
References
How should I reference my article content?
References are encouraged and add validity to content. Contributors should provide as much information as possible to allow readers to find the referenced materials themselves. Ideally all references will be more reliably accessed by using standard permanent catalogs where they exist, such as Digital Object Identifier (DOI) or International Standard Book Number (ISBN). The [Defense Technical Information Center] may be a source. When referencing SERDP/ESTCP reports and papers, please link to the [source repository] (Return to Top)
