SOE2010.Report


 * Links to components of the report**


 * Report Sections ... put your indicator pages and other stuff into your section here - see Intro for example **

Introduction :: Wildlife Habitat :: Clean Water :: Local Farms & Food :: Connecting People with Nature


 * Ideas for** **report title**


 * Page templates** - [|wildlife template.docx] :: [|water template.docx] :: [|farm template.docx] :: [|connecting template.docx]


 * Style sheet for charts and graphs** - [|ChartsAndGraphsTemplates.docx]

Introduction & Region :: Wildlife Habitat :: Clean Water :: Local Farms & Food :: Connecting People with Nature
 * Outline ...** **we should not be adding new stuff to the outline - start building your report in the Report Sections area above**


 * Page Structure Elements** for each measure / indicator (decided 12 Feb )

See example for Land Cover Change (note that this isn't on the page template yet): [|LandCoverChange.pdf]


 * Name of Measure
 * What is this? Describes what the measure (indicator) is and, simply,how it is obtained
 * Why is this important? Describes why the measure matters - what kinds of things does it tell us about the state of the environment?
 * What does this measure show? (finding/results)Guides readers through interpreting the measure, with a combination of charts, graphs,and text - highlight the things that we want noticed.
 * Graph/table/map
 * Text interpretation of key points
 * Trends (if available)
 * Interpretation against standards (if available)
 * Limitations
 * Caveats, data gaps, suggestions for further research
 * Educational elements - sidebars that explain concepts of interest (eg, what is a watershed, what is eutrophication, what is a locavore)


 * Technical Notes and References - this is actually not on the page, but in the Tech Notes & Refs section - each measure should have a set of technical notes that are essentially the methods. Include (but not limited to) ...
 * Where the data came from
 * How measured
 * Analyses performed


 * Overall Format Proposal**

What do you all think of this idea to distinguish between technical and citation? >> -Brunell 3/9/10


 * The report will be presented on the web, with the front-end being an outline of the document.
 * There will be places to click to get an individual page, an entire section, or the entire document (I'm looking for a way to get these things built on an as-requested basis, so that as pages are added a request for a section will compile and deliver the section in its current form).
 * The PDF indicator pages contain NO citations - all the citations are in the Technical Notes.
 * At the end of each section, there will be a Technical Notes subsection (essentially Methods) that will include a technical note for each indicator - citations will be included within the Technical Notes only (not on the indicator page) and all references will be listed at the end of the Technical Notes

For example ... the front-end might look like this (with pictures) ...


 * State of the Triangle's Ecosystems** :: download full report


 * Executive Summary** :: download executive summary


 * Introduction** :: download introduction
 * What is this report?
 * Who is it intended for?
 * What region and time period does it cover?
 * How can it be read and used?


 * Land Cover and Population** :: download this section
 * Population trends
 * [|Land Cover Change]
 * Urbanized area growth through time
 * Developed acres as a percent of total acres through time
 * Population density maps through time
 * [|Technical Notes & References]


 * Wildlife Habitat** :: download this section
 * Introduction
 * Indicator 1
 * Indicator 2
 * Technical Notes & References

etc


 * Acknowledgments**


 * Citation Style** - Chicago - http://www.chicagomanualofstyle.org/tools_citationguide.html - Use the T & R elements in this guide.
 * but you can use initials without periods instead of full names in the citation list - So GR Hess instead of George R. Hess is OK.

In the above, each bulleted page would be a hyperlink taking you to a PDF of the indicator in the standard layout that Katherine and Steve have developed.

The closest thing we've found is the EPA report at http://cfpub.epa.gov/eroe/ - in fact, we could use tabs like that, too, but it makes the web-work more complicated. I have enough skills to do a decent basic layout and would be willing to do so.

The main advantage of this approach is that the "document" becomes very modular and buildable - I can envision adding new indicators and sections based on other efforts, and even having other organizations and agencies contribute to the effort.

Not sure what the disadvantages are, short of having to keep all the filenames and such straight.

<<I also see the use in having the report online- I think the EPA website is an excellent example because of its tiered approach. Additionally, I like their idea of having reduced size graphs and tables to one side of the text, and not in the body of the text.

For your (George's) idea using the Technical Notes section: I think we should see the Technical Notes section as sort of a glossary of terms, concepts, etc. that you refer to in the text that is hyperlinked by text in the document, whereas for a citation you would use a superscript. Examples:

"The Division of Water Quality classifies streams as impaired under section 303d of the Clean Water Act" (see "__Clean Water Act Section 303(d)__").

In the "Technical Notes" section: __Clean Water Act Section 303(d)__: Under section 303(d) of the Clean Water Act, states, territories, and authorized tribes are required to develop lists of impaired waters. These are waters that are too polluted or otherwise degraded to meet the water quality standards set by states, territories, or authorized tribes. The law requires that these jurisdictions establish priority rankings for waters on the lists and develop TMDLs for these waters.

"About 10% of all groundwater public water supply systems are in violation of drinking water standards because of biological contamination^10"

In the citation section: 10. Citizen's Guide to Ground-Water Protection. EPA. April 1990.

Brunell>>

Response: I (george) am thinking of something even simpler. I want to ... (1) limit the use of hyperlinks in the initial version - it can make life very complicated (2) keep each indicator page a simple PDF document with the graphics and stuff right in it (no little graphs clicking to big graphs - too complex) (3) have citations only in the Tech Notes - no citations on the indicator pages - just plain language (4) citations in the Tech Notes in something like an APA format (name date) with the reference list at the end of the Tech Notes - superscripts are too hard to keep track of as things change - I positively refuse to deal with them

Items 2-4 are a lot like the way they did it in the Heinz document

So in Brunell's example, it would change to ...

"The Division of Water Quality classifies streams as impaired under section 303d of the Clean Water Act. About 10% of all groundwater public water supply systems are in violation of drinking water standards because of biological contamination."

In the "Technical Notes" section: Under section 303(d) of the Clean Water Act (citation name, date), states, territories, and authorized tribes are required to develop lists of impaired waters. These are waters that are too polluted or otherwise degraded to meet the water quality standards set by states, territories, or authorized tribes. The law requires that these jurisdictions establish priority rankings for waters on the lists and develop TMDLs for these waters. We examined the 303(d)-listed streams in the Triangle ...

In the citation section: citation name. date. rest of citation

george