Difference between revisions of "Project Page Template and Creation Instructions"

From LearnLab
Jump to: navigation, search
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
===Naming Projects and Datasets ===
 +
* Keep the project name short (within reason).  Longer names are harder to remember and keep consistent.
 +
** Example: Zhang & MacWhinney - Chinese Pinyin Learning
 +
* Keep part of the project name in the name of the dataset. If possible (if room in the title), include the school name as well as "fall" and/or "spring" and the year to show when the study ran.  If multiple schools then skip the school name.
 +
** Example: Pinyin Fall 2008
 +
 
===Creating Project Pages===
 
===Creating Project Pages===
  
**This page is in progress**
+
Below are instructions for creating your project pages in the wiki.  A template is also included which you can cut and paste into a new pageEach project page is structured with the following headers:
 
 
Each project page is structured with the following headers:
 
 
 
  
 
+
'''Project Name'''
==  '''Project Name''' ==
+
#[[#Summary_Table_How_To| Summary Table]]
 
 
 
 
#Summary Table
 
 
#Abstract
 
#Abstract
#Background & Significance
+
#Background and Significance
 
#Glossary
 
#Glossary
 
#Research questions
 
#Research questions
 
#Independent Variables
 
#Independent Variables
 
#Dependent Variables
 
#Dependent Variables
#Hypotheses
+
#Hypothesis
 +
#Results
 
#Explanation
 
#Explanation
 
#Further Information
 
#Further Information
##Connections
+
##Connections to Other Studies
 
##Annotated Bibliography
 
##Annotated Bibliography
 
##References
 
##References
 
##Future Plans
 
##Future Plans
  
Your hypothesis section should make reference to at least one of the [[Instructional Principles and Hypotheses | instructional principle pages]].  You should edit your hypothesis section to be sure it points to an instructional principle page.  Then you should edit that instructional principle page so that it at least (1) has the structure above (even if all sections aren't filled in -- a template you can copy is provided further below) and (2) points to your study with a brief summary of the results.  You should also (3) read the entry carefully and fill in or edit sections so they are consistent with your findings and with relevant theory.   
+
Your hypothesis section should make reference to at least one of the [[Instructional Principles and Hypotheses | instructional principle pages]].  Then you should edit that instructional principle subpage (not the main instructional principle page) so that it at least (1) has the structure in shown in the page for[[InstructionalPrinciples#Creating_Instructional_Principle_and_Hypothesis_Pages | creating instructional principles]] (even if all sections aren't filled in) and (2) the subpage points to your study with a brief summary of the results.  You should also (3) read the entry carefully and fill in or edit sections so they are consistent with your findings and with relevant theory.   
  
We want to keep the number of principles down, at least at the highest level of generalization, so try to reference the most general instructional principle that is appropriate.  In addition to facilitating our goal of greater shared vocabulary and unification, doing so will also make it so you have less editing work to do!  By pointing to more general instructional principles, others will be contributing to structuring and filling in that page in addition to you.  You may also point to (from your hypothesis section) more specific instructional principle pages relevant to your study.
+
Be sure that the *Examples* and *Experimental Support* sections of the instructional principle subpage you point to also points back to your study page.
 
 
Be sure that the *Examples* and *Experimental Support* sections of the instructional principle page you point to also points back to your study page.
 
  
 
Please also add references to literature beyond your own work to the *Reference* section of instructional principles pages you edit.  You might simply copy these from your study page's reference section and/or papers you have written.  By doing so, you can help others (and others can help you) identify relevant research in the field.
 
Please also add references to literature beyond your own work to the *Reference* section of instructional principles pages you edit.  You might simply copy these from your study page's reference section and/or papers you have written.  By doing so, you can help others (and others can help you) identify relevant research in the field.
  
 
====Project Page Template====
 
====Project Page Template====
You can copy the following into an instructional principle page you want to edit and then insert existing text into appropriate sections and add text in other sections.
+
You can copy the following into an project page you want to edit and then insert existing text into appropriate sections and add text in other sections.
  
<pre>
 
 
For the wiki project pages, we use the following standard PSLC format
 
For the wiki project pages, we use the following standard PSLC format
  
 
+
<pre>
'''== Project Name =='''
+
Project Name
 
+
==Summary Table==
 
+
==Abstract==
    * 1.1 Summary Table
+
==Background & Significance==
    * 1.2 Abstract
+
==Glossary==
    * 1.3 Background & Significance
+
==Research questions==
    * 1.4 Glossary
+
==Independent Variables==
    * 1.5 Research questions
+
==Dependent Variables==
    * 1.6 Independent Variables
+
==Hypothesis==
    * 1.7 Dependent Variables
+
==Results==
    * 1.8 Hypotheses
+
==Explanation==
    * 1.9 Explanation
+
==Further Information==
    * 1.10 Further Information
+
===Connections to Other Studies===
          o 1.10.1 Connections
+
===Annotated Bibliography===
          o 1.10.2 Annotated Bibliography
+
===References===
          o 1.10.3 References
+
===Future Plans===
          o 1.10.4 Future Plans
+
</pre>
 
 
 
 
  
  
 
If you have more than one study, you can modify it to a format like the one below.
 
If you have more than one study, you can modify it to a format like the one below.
  
 +
<pre>
 
Project Name
 
Project Name
==Background==
+
==Summary Table==
 +
==Abstract==
 +
==Background & Significance==
 +
==Glossary==
 +
==Research questions==
 
===Study One===
 
===Study One===
 
           ====Hypothesis====
 
           ====Hypothesis====
Line 77: Line 78:
 
           ====Results====
 
           ====Results====
 
           ====Explanation====
 
           ====Explanation====
==Contributions==
+
==Further Information==
==References==
+
===Connections to Other Studies===
==Future Plans==
+
===Annotated Bibliography===
 +
===References===
 +
===Future Plans===
 
</pre>
 
</pre>
 +
 +
=== How to fill in the Summary Table ===
 +
 +
The summary table should include information about the study or studies associated with your project.  Below are examples both for projects with just one study as well as those with multiple studies.  Once your data is in DataShop, please include a link to your dataset in your wiki summary table.  We also expect that you will attach your pre/post-test data to your dataset in DataShop.  In your summary table, please indicate whether your pre/post-test data (and the other test-related documents listed) have been attached to your dataset (e.g., TBD, No, or Yes).<br>
 +
====Data available in DataShop====
 +
 +
Start this table cell with a link to your DataShop data set (if it exists yet). Then answer the following questions.
 +
 +
* '''Pre/Post Test Score Data:''' A spreadsheet or tab-delimited file that gives a pre and post test score for each student. Is it attached to the dataset(s) in DataShop?
 +
* '''Paper or Online Tests:''' Should be either 'Paper' or 'Online', depending on the format of the tests that were given.
 +
* '''Scanned Paper Tests:''' If paper tests were given, are they scanned and attached to the dataset(s) in DataShop?
 +
* '''Blank Tests:''' Are blank tests attached to the dataset(s) in DataShop?
 +
* '''Answer Keys: ''' Are answer keys attached to the dataset(s) in DataShop?
 +
 +
Use 'TBD' if something is in the future.
 +
 +
====Examples====
 +
 +
===== Example for Project with One Study =====
 +
{| border="1" cellspacing="0" cellpadding="5" style="text-align: left;"
 +
| '''PIs''' || Yvonne Kao
 +
|-
 +
| '''Other Contributors''' || none
 +
|-
 +
| '''Study Start Date''' || Jan 2009
 +
|-
 +
| '''Study End Date''' || June 2009
 +
|-
 +
| '''LearnLab Site''' || North Hills Junior High School
 +
|-
 +
| '''LearnLab Course''' || Bridge to Algebra
 +
|-
 +
| '''Number of Students''' || 55
 +
|-
 +
| '''Total Participant Hours''' || 295.58
 +
|-
 +
| '''Data available in DataShop''' || [https://pslcdatashop.web.cmu.edu/DatasetInfo?datasetId=315 Dataset: Perceptual Fluency in Geometry Achievement Spring 2009]<br>
 +
* '''Pre/Post Test Score Data:''' Yes
 +
* '''Paper or Online Tests:''' Paper
 +
* '''Scanned Paper Tests:''' Yes
 +
* '''Blank Tests:''' Yes
 +
* '''Answer Keys: ''' Yes
 +
|}
 +
 +
===== Project with Multiple Studies - Use Multiple Tables =====
 +
* '''PIs: ''' Yvonne Kao
 +
* '''Other Contributors:''' n/a
 +
{| border="1" cellspacing="0" cellpadding="5" style="text-align: left;"
 +
| '''Study Name/Number''' || Study One In Vivo
 +
|-
 +
| '''Study Start Date''' || Jan 2009
 +
|-
 +
| '''Study End Date''' || June 2009
 +
|-
 +
| '''LearnLab Site''' || North Hills Junior High School
 +
|-
 +
| '''LearnLab Course''' || Bridge to Algebra
 +
|-
 +
| '''Number of Students''' || 55
 +
|-
 +
| '''Total Participant Hours''' || 295.58
 +
|-
 +
| '''Data available in DataShop''' || [https://pslcdatashop.web.cmu.edu/DatasetInfo?datasetId=315 Dataset: Perceptual Fluency in Geometry Achievement Spring 2009]<br>
 +
* '''Pre/Post Test Score Data:''' Yes
 +
* '''Paper or Online Tests:''' Paper
 +
* '''Scanned Paper Tests:''' Yes
 +
* '''Blank Tests:''' Yes
 +
* '''Answer Keys: ''' Yes
 +
|}
 +
<br>
 +
{| border="1" cellspacing="0" cellpadding="5" style="text-align: left;"
 +
| '''Study Name/Number''' || Study Two Lab Pullout
 +
|-
 +
| '''Study Start Date''' || Sept 2011
 +
|-
 +
| '''Study End Date''' || Dec 2011
 +
|-
 +
| '''LearnLab Site''' || North Hills Junior High School
 +
|-
 +
| '''LearnLab Course''' || Bridge to Algebra
 +
|-
 +
| '''Number of Students''' || TBD
 +
|-
 +
| '''Total Participant Hours''' || TBD
 +
|-
 +
| '''Data available in DataShop''' || TBD<br>
 +
* '''Pre/Post Test Score Data:''' TBD
 +
* '''Paper or Online Tests:''' Paper
 +
* '''Scanned Paper Tests:''' TBD
 +
* '''Blank Tests:''' TBD
 +
* '''Answer Keys: ''' TBD
 +
|}

Latest revision as of 13:31, 11 March 2011

Naming Projects and Datasets

  • Keep the project name short (within reason). Longer names are harder to remember and keep consistent.
    • Example: Zhang & MacWhinney - Chinese Pinyin Learning
  • Keep part of the project name in the name of the dataset. If possible (if room in the title), include the school name as well as "fall" and/or "spring" and the year to show when the study ran. If multiple schools then skip the school name.
    • Example: Pinyin Fall 2008

Creating Project Pages

Below are instructions for creating your project pages in the wiki. A template is also included which you can cut and paste into a new page. Each project page is structured with the following headers:

Project Name

  1. Summary Table
  2. Abstract
  3. Background and Significance
  4. Glossary
  5. Research questions
  6. Independent Variables
  7. Dependent Variables
  8. Hypothesis
  9. Results
  10. Explanation
  11. Further Information
    1. Connections to Other Studies
    2. Annotated Bibliography
    3. References
    4. Future Plans

Your hypothesis section should make reference to at least one of the instructional principle pages. Then you should edit that instructional principle subpage (not the main instructional principle page) so that it at least (1) has the structure in shown in the page for creating instructional principles (even if all sections aren't filled in) and (2) the subpage points to your study with a brief summary of the results. You should also (3) read the entry carefully and fill in or edit sections so they are consistent with your findings and with relevant theory.

Be sure that the *Examples* and *Experimental Support* sections of the instructional principle subpage you point to also points back to your study page.

Please also add references to literature beyond your own work to the *Reference* section of instructional principles pages you edit. You might simply copy these from your study page's reference section and/or papers you have written. By doing so, you can help others (and others can help you) identify relevant research in the field.

Project Page Template

You can copy the following into an project page you want to edit and then insert existing text into appropriate sections and add text in other sections.

For the wiki project pages, we use the following standard PSLC format

Project Name
==Summary Table==
==Abstract==
==Background & Significance==
==Glossary==
==Research questions==
==Independent Variables==
==Dependent Variables==
==Hypothesis==
==Results==
==Explanation==
==Further Information==
===Connections to Other Studies===
===Annotated Bibliography===
===References===
===Future Plans===


If you have more than one study, you can modify it to a format like the one below.

Project Name
==Summary Table==
==Abstract==
==Background & Significance==
==Glossary==
==Research questions==
===Study One===
          ====Hypothesis====
          ====Independent Variables====
          ====Dependent Variables====
          ====Results====
          ====Explanation====
===Study Two===
          ====Hypothesis====
          ====Independent Variables====
          ====Dependent Variables====
          ====Results====
          ====Explanation====
==Further Information==
===Connections to Other Studies===
===Annotated Bibliography===
===References===
===Future Plans===

How to fill in the Summary Table

The summary table should include information about the study or studies associated with your project. Below are examples both for projects with just one study as well as those with multiple studies. Once your data is in DataShop, please include a link to your dataset in your wiki summary table. We also expect that you will attach your pre/post-test data to your dataset in DataShop. In your summary table, please indicate whether your pre/post-test data (and the other test-related documents listed) have been attached to your dataset (e.g., TBD, No, or Yes).

Data available in DataShop

Start this table cell with a link to your DataShop data set (if it exists yet). Then answer the following questions.

  • Pre/Post Test Score Data: A spreadsheet or tab-delimited file that gives a pre and post test score for each student. Is it attached to the dataset(s) in DataShop?
  • Paper or Online Tests: Should be either 'Paper' or 'Online', depending on the format of the tests that were given.
  • Scanned Paper Tests: If paper tests were given, are they scanned and attached to the dataset(s) in DataShop?
  • Blank Tests: Are blank tests attached to the dataset(s) in DataShop?
  • Answer Keys: Are answer keys attached to the dataset(s) in DataShop?

Use 'TBD' if something is in the future.

Examples

Example for Project with One Study
PIs Yvonne Kao
Other Contributors none
Study Start Date Jan 2009
Study End Date June 2009
LearnLab Site North Hills Junior High School
LearnLab Course Bridge to Algebra
Number of Students 55
Total Participant Hours 295.58
Data available in DataShop Dataset: Perceptual Fluency in Geometry Achievement Spring 2009
  • Pre/Post Test Score Data: Yes
  • Paper or Online Tests: Paper
  • Scanned Paper Tests: Yes
  • Blank Tests: Yes
  • Answer Keys: Yes
Project with Multiple Studies - Use Multiple Tables
  • PIs: Yvonne Kao
  • Other Contributors: n/a
Study Name/Number Study One In Vivo
Study Start Date Jan 2009
Study End Date June 2009
LearnLab Site North Hills Junior High School
LearnLab Course Bridge to Algebra
Number of Students 55
Total Participant Hours 295.58
Data available in DataShop Dataset: Perceptual Fluency in Geometry Achievement Spring 2009
  • Pre/Post Test Score Data: Yes
  • Paper or Online Tests: Paper
  • Scanned Paper Tests: Yes
  • Blank Tests: Yes
  • Answer Keys: Yes


Study Name/Number Study Two Lab Pullout
Study Start Date Sept 2011
Study End Date Dec 2011
LearnLab Site North Hills Junior High School
LearnLab Course Bridge to Algebra
Number of Students TBD
Total Participant Hours TBD
Data available in DataShop TBD
  • Pre/Post Test Score Data: TBD
  • Paper or Online Tests: Paper
  • Scanned Paper Tests: TBD
  • Blank Tests: TBD
  • Answer Keys: TBD