create templates for things other projects

[fgmart-zz]

saved-viz data-set description user description

[ivanrudnicki]

Here's my suggested text:

Please describe the visualization that you have saved, including what data are represented in the visualization and what trends or patterns the visualization appears to reveal.

Please describe the contents of this data set, including any relevant details about how, when, and where the data were collected, or (in the case of existing data sets) where the data were found.

Please describe yourself for other members of the iSENSE community. This information will be displayed only to users who are logged in to the iSENSE web site and who click on your profile page.

[mmcguinn]

My primary issue with these is they are not templates so much as instructions.

On Tue, Dec 10, 2013 at 11:36 AM, ivanrudnicki notifications@github.comwrote:

Here's my suggested text:

Please describe the visualization that you have saved, including what data are represented in the visualization and what trends or patterns the visualization appears to reveal.

Please describe the contents of this data set, including any relevant details about how, when, and where the data were collected, or (in the case of existing data sets) where the data were found.

Please describe yourself for other members of the iSENSE community. This information will be displayed only to users who are logged in to the iSENSE web site and who click on your profile page.

— Reply to this email directly or view it on GitHubhttps://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30243494 .

[ivanrudnicki]

True. Would the alternative - a description of a random viz, data set, and person - be weird, though?

For example:

This scatter plot shows the relationship between water temperature and dissolved oxygen in the Charles River over a two-year period. In general, higher temperatures are correlated with lower dissolved oxygen levels.

This data set includes temperature, pH, dissolved oxygen, salinity, and turbidity data from a sampling station by the Museum of Science in the Charles River's lower basin.

Hi. I'm Michael! I teach seventh-grade earth science at the Kathryn P. Stoklosa Middle School in Lowell, Massachusetts. I love rivers, and I love data!

Also, I forget - will these show up only to a user while he or she is editing one of these fields, or will they be displayed to everyone in template form until edited? (Seems relevant somehow.)

On Tue, Dec 10, 2013 at 12:15 PM, mmcguinn notifications@github.com wrote:

My primary issue with these is they are not templates so much as instructions.

On Tue, Dec 10, 2013 at 11:36 AM, ivanrudnicki notifications@github.comwrote:

Here's my suggested text:

Please describe the visualization that you have saved, including what data are represented in the visualization and what trends or patterns the visualization appears to reveal.

Please describe the contents of this data set, including any relevant details about how, when, and where the data were collected, or (in the case of existing data sets) where the data were found.

Please describe yourself for other members of the iSENSE community. This information will be displayed only to users who are logged in to the iSENSE web site and who click on your profile page.

— Reply to this email directly or view it on GitHub< https://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30243494> .

— Reply to this email directly or view it on GitHubhttps://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30247516 .

[mmcguinn]

They will only show to the editor until the editor hits 'save'.

Your second set is more like examples than a template, though templates often contain examples so its reasonably close. Here's an example of the style I'm thinking in terms of a viz:

Relationships Talk about the relationships shown on the graph here - expanding on what the fields involved are in detail. For example: The Y axis shows the pH values of water gathered from the Merrimack River at the UML boathouse. The X axis shows the date these samples were taken.

Conclusions Talk about conclusions you have drawn from the visualization here. For example: There is a clear relationship between the season and pH value measured - pH levels seem to increase during the Fall months and decrease over the rest of the year.

On Tue, Dec 10, 2013 at 2:18 PM, ivanrudnicki notifications@github.comwrote:

True. Would the alternative - a description of a random viz, data set, and person - be weird, though?

For example:

This scatter plot shows the relationship between water temperature and dissolved oxygen in the Charles River over a two-year period. In general, higher temperatures are correlated with lower dissolved oxygen levels.

This data set includes temperature, pH, dissolved oxygen, salinity, and turbidity data from a sampling station by the Museum of Science in the Charles River's lower basin.

Hi. I'm Michael! I teach seventh-grade earth science at the Kathryn P. Stoklosa Middle School in Lowell, Massachusetts. I love rivers, and I love data!

Also, I forget - will these show up only to a user while he or she is editing one of these fields, or will they be displayed to everyone in template form until edited? (Seems relevant somehow.)

On Tue, Dec 10, 2013 at 12:15 PM, mmcguinn notifications@github.com wrote:

My primary issue with these is they are not templates so much as instructions.

On Tue, Dec 10, 2013 at 11:36 AM, ivanrudnicki notifications@github.comwrote:

Here's my suggested text:

Please describe the visualization that you have saved, including what data are represented in the visualization and what trends or patterns the visualization appears to reveal.

Please describe the contents of this data set, including any relevant details about how, when, and where the data were collected, or (in the case of existing data sets) where the data were found.

Please describe yourself for other members of the iSENSE community. This information will be displayed only to users who are logged in to the iSENSE web site and who click on your profile page.

— Reply to this email directly or view it on GitHub< https://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30243494> .

— Reply to this email directly or view it on GitHub< https://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30247516> .

— Reply to this email directly or view it on GitHubhttps://urldefense.proofpoint.com/v1/url?u=https://github.com/isenseDev/rSENSE/issues/1099%23issuecomment-30258525&k=wf2FkHoZDP5jrUw2KePZ5g%3D%3D%0A&r=nNRdahQEPhm3OqkwwRSy63CqFa704zIHxdEVCIYYR6k%3D%0A&m=%2FAGsC7poDTVmEAMprXTl6Z9CP0MCTN%2BZvYr2E0cJTvE%3D%0A&s=f5ab8804f0d13c175ec3c70487c81cb40b7b79ebcaaf7a180382a0929b5f88cc .

[ivanrudnicki]

Right. OK. Then following your template template, we end up with sort of a hybrid of instructions and examples in each category, along these lines...

Projects

OVERVIEW Please describe your project in detail, so that other users can find it. If applicable, please specify what academic subject(s) the project relates to and which grade level(s) it is appropriate for. (E.g., In this project, students will collect water quality data from the Charles River. This is an earth science and biology project suitable for students in middle school and high school.)

PROCEDURE If the project involves users collecting or visualizing data, please provide step-by-step instructions for these activities. (E.g., 1. Collect a sample of water. 2. Perform temperature, pH, and dissolved oxygen measurements on the sample. 3. Upload the data to iSENSE. 4. Make a scatter chart to look for relationships between different values.)

SOURCE If the project contains an existing data set, please specify the source of the data, including a web link or bibliographical reference. (E.g., http://www.crwa.org/water_quality.html)

Visualizations

DATA Please describe which data sets have been included in the saved visualization. (E.g., This scatter plot shows water temperature measurements and dissolved oxygen levels from two sampling stations in the Charles River.)

PATTERNS Please describe any patterns or trends that you see in the data. (E.g., There is a linear relationship between the values on the X axis and the values on the Y axis.)

OBSERVATIONS Please report any observations or conclusions you have drawn from the visualization here. (E.g., In general, higher water temperatures are correlated with lower dissolved oxygen levels.)

Data Sets

COLLECTION METHOD Please describe how, when, and where these data were collected. (E.g. This data set includes temperature, pH, dissolved oxygen, salinity, and turbidity measurements from water samples collected near the Museum of Science in the Charles River's lower basin.)

DATA SOURCE For existing data sets, please specify where the data were obtained. (E.g. These data were provided online by the Charles River Watershed Association. http://www.crwa.org/water_quality.html)

User Bios

INSTITUTIONAL AFFILIATION Please describe your institutional affiliation(s). (E.g., I teach seventh-grade earth science at the Kathryn P. Stoklosa Middle School in Lowell, Massachusetts.)

RELEVANT INTERESTS Please describe your specific interests in using iSENSE. (E.g., I am interested in incorporating iSENSE in my classroom science teaching.)

On Tue, Dec 10, 2013 at 4:18 PM, mmcguinn notifications@github.com wrote:

They will only show to the editor until the editor hits 'save'.

Your second set is more like examples than a template, though templates often contain examples so its reasonably close. Here's an example of the style I'm thinking in terms of a viz:

Relationships Talk about the relationships shown on the graph here - expanding on what the fields involved are in detail. For example: The Y axis shows the pH values of water gathered from the Merrimack River at the UML boathouse. The X axis shows the date these samples were taken.

Conclusions Talk about conclusions you have drawn from the visualization here. For example: There is a clear relationship between the season and pH value measured - pH levels seem to increase during the Fall months and decrease over the rest of the year.

On Tue, Dec 10, 2013 at 2:18 PM, ivanrudnicki notifications@github.comwrote:

True. Would the alternative - a description of a random viz, data set, and person - be weird, though?

For example:

This scatter plot shows the relationship between water temperature and dissolved oxygen in the Charles River over a two-year period. In general, higher temperatures are correlated with lower dissolved oxygen levels.

This data set includes temperature, pH, dissolved oxygen, salinity, and turbidity data from a sampling station by the Museum of Science in the Charles River's lower basin.

Hi. I'm Michael! I teach seventh-grade earth science at the Kathryn P. Stoklosa Middle School in Lowell, Massachusetts. I love rivers, and I love data!

Also, I forget - will these show up only to a user while he or she is editing one of these fields, or will they be displayed to everyone in template form until edited? (Seems relevant somehow.)

On Tue, Dec 10, 2013 at 12:15 PM, mmcguinn notifications@github.com wrote:

My primary issue with these is they are not templates so much as instructions.

On Tue, Dec 10, 2013 at 11:36 AM, ivanrudnicki < notifications@github.com>wrote:

Here's my suggested text:

Please describe the visualization that you have saved, including what data are represented in the visualization and what trends or patterns the visualization appears to reveal.

Please describe the contents of this data set, including any relevant details about how, when, and where the data were collected, or (in the case of existing data sets) where the data were found.

Please describe yourself for other members of the iSENSE community. This information will be displayed only to users who are logged in to the iSENSE web site and who click on your profile page.

— Reply to this email directly or view it on GitHub< https://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30243494>

.

— Reply to this email directly or view it on GitHub< https://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30247516> .

— Reply to this email directly or view it on GitHub< https://urldefense.proofpoint.com/v1/url?u=https://github.com/isenseDev/rSENSE/issues/1099%23issuecomment-30258525&k=wf2FkHoZDP5jrUw2KePZ5g%3D%3D%0A&r=nNRdahQEPhm3OqkwwRSy63CqFa704zIHxdEVCIYYR6k%3D%0A&m=%2FAGsC7poDTVmEAMprXTl6Z9CP0MCTN%2BZvYr2E0cJTvE%3D%0A&s=f5ab8804f0d13c175ec3c70487c81cb40b7b79ebcaaf7a180382a0929b5f88cc>

.

— Reply to this email directly or view it on GitHubhttps://github.com/isenseDev/rSENSE/issues/1099#issuecomment-30268853 .