Difference between revisions of "CleanEnergyWIKI:Community Portal"
Cmditradmin (talk | contribs) |
|||
| Line 1: | Line 1: | ||
We invite CMDITR members to edit and improve this wiki. With your help it will be a useful learning tool for current | We invite CMDITR members to edit and improve this wiki. With your help it will be a useful learning tool for current students, and a substantial legacy of the Center. Eventually, this wiki will be merged into the National Science Digital Library. Here are some guidelines: | ||
=== Lead Editor === | === Lead Editor === | ||
Each section will have a lead editor. They are listed on the [[Credits and Reviewers]] page. Anyone may edit a page but the lead editor's job is to methodically read everything and serve as the | Each section will have a lead editor. They are listed on the [[Credits and Reviewers]] page. Anyone may edit a page, but the lead editor's job is to methodically read everything and serve as the gatekeeper for accuracy and relevance. Reviewers should look for the following: | ||
=== Accuracy === | ==== Accuracy ==== | ||
Check the terminology, formulas, graphics and captions | Check the terminology, formulas, graphics and captions for scientific accuracy. Make sure that results are state-of-the-art and timely. If you find errors that you can fix without debate, please correct them. If you need to discuss an issue with the creator you can click on the edit history to see who authored the original remarks. Each article has a top tab for "discussion" which is a note area linked for each article in which discussion can be carried on. This is also a good place to submit requests to the education team for revisions, such as additional graphics. | ||
=== Coherence and Readability === | ==== Coherence and Readability ==== | ||
Most of these articles were transcribed from live lectures and may be somewhat fragmented or disorganized. Please read them with the mindset of a undergraduate or first year graduate student. You may assume | Most of these articles were transcribed from live lectures and may be somewhat fragmented or disorganized. Please read them with the mindset of a undergraduate or first-year graduate student. You may assume the audience has had freshman chemistry, but any deeper content should be bolstered with additional links. Wikipedia is an excellent resource for providing additional explanation. One advantage of the wiki format is the core article can follow a coherent strand without getting bogged down in deeper explanations that are only useful to some people. At the same time, people who need extra help can access links to catch up on background they are missing. Please edit the language for clarity and brevity. | ||
=== Headings- === | === Headings- === | ||
Any article with more than three heading tags (==Heading==) automatically builds an outline at the top of the page. Headings can have any degree of | Any article with more than three heading tags (==Heading==) automatically builds an outline at the top of the page. Headings can have any degree of depth by adding additional tags (===subheading===, ====subsubheading====). This outline is an important organizational tool to help students understand the structure of the content. In some cases it will be necessary to add superheadings to provide groupings, or to delete headings in order to keep parallel construction. Major headings should have summary statements explaining the overarching idea and introducing the topic. | ||
=== Additional Resources === | === Additional Resources === | ||
Please add additional references to research or other web resources that are useful throughout the article. We will attempt to make journal citations link automatically to library abstracts and | Please add additional references to research or other web resources that are useful throughout the article. We will attempt to make journal citations link automatically to library abstracts (and to the full article when universities have subscribed to those services). | ||
=== Copyright - IP === | === Copyright - IP === | ||
Please be sure that any text you add is original. If you are using a direct quote provide attribution ideally including an appropriate web link. Also be sure any graphics | Please be sure that any text you add is original. If you are using a direct quote, provide attribution- ideally including an appropriate web link. Also be sure any graphics are correctly licensed. Most of the graphics have been taken directly from PowerPoint presentations of faculty. In some cases where the origin was uncertain we have replaced graphics with equivalents from wikimedia, or recreated drawings. After the wiki is fully vetted and reviewed we intend to migrate most of the graphics to the photonics digital library where we provide full metadata documentation. We need to add citations for scientific graphs but often these would benefit from redrawing in a simplified format. Please use the discussion page to help resolve these issues. | ||
=== Editing Procedure === | === Editing Procedure === | ||
Click "edit" at the top of the page to edit the entire article, or click "edit" to the right of each heading to edit just that subsection. Click [[Help:Contents Help]] button for some common wiki markups and a link to the main Wikipedia How To page. Also refer to the [[Photonics Wiki Stylesheet]] for general pointers about the organization and formatting of the articles. | Click "edit" at the top of the page to edit the entire article, or click "edit" to the right of each heading to edit just that subsection. Click [[Help:Contents Help]] button for some common wiki markups and a link to the main Wikipedia How To page. Also refer to the [[Photonics Wiki Stylesheet]] for general pointers about the organization and formatting of the articles. | ||
Revision as of 10:37, 9 December 2009
We invite CMDITR members to edit and improve this wiki. With your help it will be a useful learning tool for current students, and a substantial legacy of the Center. Eventually, this wiki will be merged into the National Science Digital Library. Here are some guidelines:
Lead Editor
Each section will have a lead editor. They are listed on the Credits and Reviewers page. Anyone may edit a page, but the lead editor's job is to methodically read everything and serve as the gatekeeper for accuracy and relevance. Reviewers should look for the following:
Accuracy
Check the terminology, formulas, graphics and captions for scientific accuracy. Make sure that results are state-of-the-art and timely. If you find errors that you can fix without debate, please correct them. If you need to discuss an issue with the creator you can click on the edit history to see who authored the original remarks. Each article has a top tab for "discussion" which is a note area linked for each article in which discussion can be carried on. This is also a good place to submit requests to the education team for revisions, such as additional graphics.
Coherence and Readability
Most of these articles were transcribed from live lectures and may be somewhat fragmented or disorganized. Please read them with the mindset of a undergraduate or first-year graduate student. You may assume the audience has had freshman chemistry, but any deeper content should be bolstered with additional links. Wikipedia is an excellent resource for providing additional explanation. One advantage of the wiki format is the core article can follow a coherent strand without getting bogged down in deeper explanations that are only useful to some people. At the same time, people who need extra help can access links to catch up on background they are missing. Please edit the language for clarity and brevity.
Headings-
Any article with more than three heading tags (==Heading==) automatically builds an outline at the top of the page. Headings can have any degree of depth by adding additional tags (===subheading===, ====subsubheading====). This outline is an important organizational tool to help students understand the structure of the content. In some cases it will be necessary to add superheadings to provide groupings, or to delete headings in order to keep parallel construction. Major headings should have summary statements explaining the overarching idea and introducing the topic.
Additional Resources
Please add additional references to research or other web resources that are useful throughout the article. We will attempt to make journal citations link automatically to library abstracts (and to the full article when universities have subscribed to those services).
Copyright - IP
Please be sure that any text you add is original. If you are using a direct quote, provide attribution- ideally including an appropriate web link. Also be sure any graphics are correctly licensed. Most of the graphics have been taken directly from PowerPoint presentations of faculty. In some cases where the origin was uncertain we have replaced graphics with equivalents from wikimedia, or recreated drawings. After the wiki is fully vetted and reviewed we intend to migrate most of the graphics to the photonics digital library where we provide full metadata documentation. We need to add citations for scientific graphs but often these would benefit from redrawing in a simplified format. Please use the discussion page to help resolve these issues.
Editing Procedure
Click "edit" at the top of the page to edit the entire article, or click "edit" to the right of each heading to edit just that subsection. Click Help:Contents Help button for some common wiki markups and a link to the main Wikipedia How To page. Also refer to the Photonics Wiki Stylesheet for general pointers about the organization and formatting of the articles.