Difference between revisions of "Information Foraging Assignment: Nursery School"

From CSE256A Wiki
Jump to navigation Jump to search
 
(51 intermediate revisions by 3 users not shown)
Line 7: Line 7:
 
Specifically, we will study the following scenarios:
 
Specifically, we will study the following scenarios:
 
# '''Math:''' You are a parent considering sending your child to Washington University Nursery School. You’ve learned that the curriculum is play-based and you want to know how learning is incorporated into a play-based context. You have some ideas about how language learning might happen, but are less sure about math. Find some examples of how math learning is incorporated at Washington University Nursery School.
 
# '''Math:''' You are a parent considering sending your child to Washington University Nursery School. You’ve learned that the curriculum is play-based and you want to know how learning is incorporated into a play-based context. You have some ideas about how language learning might happen, but are less sure about math. Find some examples of how math learning is incorporated at Washington University Nursery School.
−
# '''School Day: ''' You are investigating pre-school options for your 4 year old. Both you and your spouse work, so you need to fully understand what scheduling constraints each option involves. One of your schools of interest is the Washington University Nursery School. When does school start and end each day? What is the longest period of time that your child can be there?
+
# '''School Day: ''' You are investigating pre-school options for your 4 year old. Both you and your spouse work, so you need to fully understand what scheduling constraints each option involves. One of your schools of interest is the Washington University Nursery School. When does school start and end each day? What is the longest period of time that your child can be there?
−
# '''Teacher Tenure: ''' You are investigating pre-school options for your 3 year old. You’ve been told that one of the hallmarks of a good program is teachers who have been there for a long time. Your child would join the Bear Cubs room. Who are the teachers for the Bear Cubs room and how long have they been at the school?
+
# '''Teacher Tenure: ''' You are investigating pre-school options for your 3.5 year old. You’ve been told that one of the hallmarks of a good program is teachers who have been there for a long time. You want your child to attend in the mornings only. Which teachers would your child have and how long have they been at the school?
 
# '''Summer Camp: ''' You are starting to look at summer camp options and have heard good things about Washington University Nursery School for young children. What are the daily camp hours? Are there any extended day opportunities?
 
# '''Summer Camp: ''' You are starting to look at summer camp options and have heard good things about Washington University Nursery School for young children. What are the daily camp hours? Are there any extended day opportunities?
 
# '''Discipline: ''' You are investigating pre-school options for your spirited 3 year old and want to understand their approach to discipline. How do teachers at Washington University approach discipline?
 
# '''Discipline: ''' You are investigating pre-school options for your spirited 3 year old and want to understand their approach to discipline. How do teachers at Washington University approach discipline?
−
# '''Spanish Song: ''' Your daughter is in the Teddy Bear class at Washington University Nursery School. She came home this week singing a song in Spanish about shapes, but you are pretty sure that she has some of the words wrong. What are the correct lyrics?
+
# '''Spanish Song: ''' Your daughter is in the Teddy Bear class at Washington University Nursery School. She came home this week singing a song in Spanish about shapes, but you are pretty sure that she has some of the words wrong. What are the correct lyrics?
−
#'''Books: ''' You have a daughter, age 3, who attends the Washington University Nursery School and is in the Teddy Bear classroom. You are planning a trip to the library and want to check out some books that connect with something she is doing in school. What are some potential book topics that relate to something that is going on in her classroom this week?
+
#'''Books: ''' It is mid-December, 2020 and you are thinking about things to do over your daughter's upcoming school break. She is 3 years old and attends the Washington University Nursery School and is in the Teddy Bear classroom. You are planning a trip to the library and want to check out some books that connect with something she is doing in school. What are some potential book topics that relate to something that is going on in her classroom this week?
 
#'''Admission-2: ''' You are a parent with a child who has just been accepted to attend as a full time student at the Washington University Nursery School. You want to accept the offer of admission. Figure out what you need to do at this time to finalize your child’s place at the school.
 
#'''Admission-2: ''' You are a parent with a child who has just been accepted to attend as a full time student at the Washington University Nursery School. You want to accept the offer of admission. Figure out what you need to do at this time to finalize your child’s place at the school.
 
#'''Deposit: ''' You are a parent with a child who has just been accepted to attend as a full time student at the Washington University Nursery School. You need to pay one month of tuition as a deposit. Find out how much one month of tuition is and whether or not it is possible to pay online.
 
#'''Deposit: ''' You are a parent with a child who has just been accepted to attend as a full time student at the Washington University Nursery School. You need to pay one month of tuition as a deposit. Find out how much one month of tuition is and whether or not it is possible to pay online.
 +
#'''Personalized Help: '''You are moving to St. Louis from Beijing and looking for a Pre-K program for your daughter, age 5. She is very close to her friends and you are worried that the move might be hard on her. She may need some extra support from her new teachers learning English, adapting to American culture, and making new friends. How does the Washington University Nursery School staff approach providing extra help to students who need it? (note: answer is the curriculum overview where it talks about how to provide extra help for individual students)
 +
#'''Communication: '''You are looking at Nursery Schools for your soon to be 3 year old. He has never been in school or daycare before and you are somewhat worried about the transition. You'd like to ensure that you'll be able to have strong communication at his new school. How does the Washington University Nursery School handle communicating with parents? (note: answer is in the parent handbook under communication)
 +
#'''Science: '''It’s mid-December and your son, age 4, came home all excited about science class. They learned a new word, but he can’t actually remember the word they learned about. What was the topic of his recent science class?
 +
#'''Parent/Teacher Conferences: '''You are selecting a pre-school, but want to be sure that your daughter will be ready for kindergarten when it’s time. How does the nursery school assess children’s knowledge, support their growth, and share the results with parents?
 +
#'''Orientation: '''You have recently accepted a position for your child for the coming school year at the Washington University Nursery School. Up to this point, your child has been at home and you are somewhat worried about the transition. How does the nursery school support kids’ transitions into school?
  
−
=Prerequisite Readings=
+
=Grading=
−
Before starting this project, you should read the following:
+
For each project, you will get assigned three tasks to test for that round. For the first round, these will be randomly chosen. For subsequent rounds, we will carry two of your previous tasks forward. You can submit up to three versions (see deadlines on the calendar). For each task, we'll assign a score that captures the degree to which participants completed it correctly (got the right answer) and efficiently (took the fastest path to get there). To get credit for a task, you need to outperform the baseline score by 20% for that task. Overall project grades will be:
 +
* 93: 3 tasks that perform >20% over the baseline, spread across any iteration.
 +
* 88: 2 tasks that perform >20% over the baseline, spread across any iteration.
 +
* 83: 1 task that performs >20% over the baseline, in any iteration.
  
−
=Running the Site Locally=
+
Then you can earn bonus points as follows:
−
# Open a terminal window or the terminal in your code editor.
 
−
# Navigate to your repository folder. This should be something like: cse256a-s20-<YOURWUSTLKEY>.
 
−
# Type in:
 
−
<pre>python -m http.server 8000.</pre>
 
−
This starts a local webserver from that directory.
 
−
# Navigate to: ​ http://localhost:8000/information-foraging/files/index.HTML
 
  
−
=Project Set-up=
+
* +7: all three tasks in a single iteration (Note: only your largest multi-task bonus will count)
 +
* +3: two tasks in a single iteration (Note: only your largest multi-task bonus will count)
 +
* +2: one of the top 3 performing tasks in the class (Note: you can earn this bonus for multiple tasks)
  
−
=Introductory Studio=
+
=Prerequisite Readings=
−
The goal of this studio is to introduce you to the basic set of skills that you will need in order to begin modifying the nursery school site. While you won't emerge at the end of this knowing everything there is to know about HTML, CSS, and JavaScript, this should give you enough to be able to modify the starting code we've given you.
+
The goal of this assignment is use the ideas of information foraging to improve users' abilities to find information on the Washington University Nursery School site. As you work on your redesign you should be thinking about the information search process and trying to restructure and reorganize the information such that users can navigate it more easily.
  
−
==General model==
+
# [http://people.ischool.berkeley.edu/~hearst/research/scattergather.html Scatter/Gather]
−
For those who have never done any web programming before, we'll end up touching three kinds of files:
+
# [https://devaka.ru/wp-content/uploads/2008/11/UIR-1995-07-Pirolli-CHI95-Foraging.pdf Information Foraging in Information Access Environments]
−
* Html contains static information and it's organization (*.HTML)
 
−
* Css allows you to set the visual properties and control how different website elements look (*.CSS)
 
−
* JavaScript enables your site to have interactivity and respond to what users do (*.js)
 
  
−
==Running the Nursery School Site==
+
=Getting Started=
−
# Open a terminal window or the terminal in your code editor.
+
==Cloning the Information Foraging Baseline Code==
−
# Navigate to your repository folder. This should be something like: cse256a-s20-<YOURWUSTLKEY>.
+
We are hosting our repositories using github this semester. That means you will get a new repository for each of our three projects. When you accept an assignment through github classroom, it will create a repository for you based on the template that we've defined as the starting point for everyone.
−
# Start a local webserver by typing in (from your repository directory):
 
−
<pre>python -m http.server 8000.</pre>
 
−
'''Then, open:''' ​ http://localhost:8000/information-foraging/files/index.HTML
 
  
−
==Finding Content in HTML==
+
# First, accept the assignment from github. Once the assignment is ready to go live, we will update the link here.
−
[[File:ComeVisitStart.jpg|border|right|300px]]
+
# Navigate to your cloned repository on github. You can get there by reloading the "generating your repository" page. Git hub will give you a link when it's ready. It should have a url something like: <nowiki>https://github.com/cse-256-f22/information_foraging-YOUR_GITHUB_ID-wustl</nowiki>.
−
Today's web browsers provide developer tools that can be handy in finding things you want to modify in the nursery school site. For purposes of this studio, we'll assume you are using Chrome. We're going to start by changing the "come visit" call to action in the center of index.HTML. In some cases, you can just search for text in the page within VSCode. In other cases, you may need to navigate around more in the HTML structure. For this, the developer tools can be extremely helpful.
 
  
−
[[File:OpenDeveloperTools.jpg|border|right|300px]]
+
==Setting Up Pages==
−
'''Opening the Developer Tools: '''First, we'll open the developer tools. From the three dots menu all the way on the top right, choose "More tools" and then "Developer tools."
+
To see what your version of the nursery school site looks like, you can view it through github pages. This will also be how your user-testerss will view and interact with your site, so it's important to get going even if you plan to develop fully locally.
 +
# Go the the settings tab
 +
# Click on pages in the left-hand list of options
 +
# Select 'deploy from a branch' and the branch you want users to see (likely main).
 +
# Enable github Pages by hitting save
 +
# Once you hit save, github will add a link to your hosted pages so that you can see them.
  
−
[[File:DeveloperToolsRight.jpg|border|right|300px]]
+
Note that it can take a while (sometimes ~30 minutes) for the site to get updated. Other times, it can be within a minute or two. Once you have it enabled, when you push changes to your repository, that should trigger a site refresh.
−
'''A Quick Tour of the Element Pane:'''Now, you should see a panel open on the right hand side. The elements area of the developer tools shows the structure of the HTML document open in Chrome. Using the element pane, you can look at the structure of the information in the document. In HTML, different types of information are enclosed in tags. For example, a link looks like this:
 
  
−
<pre><a class="site-title" href="/information-foraging/files/index.HTML">Nursery School</a> </pre>
+
=Baseline Code=
 +
Your repository contains the baseline version of the Nursery School site. Your assignment is to adapt that codebase to improve users' task performance. Within your top level repository directory you will find a subfolder called '''files''' that contains all of the HTML and CSS files you should need to edit for this project. If you would like to edit the JS of your site then do so in the '''scripts/ts/dynamic-dom''' folder.
  
−
*The '''<a>''' and '''</a>''' define the beginning and end of the link information.  
+
To run the site locally, do these steps:
−
*Inside the '''<a>''' tag, there are some properties defined: the address to link to (href) and a class that can link to CSS formatting instructions.
+
# Open a terminal window or the terminal in your code editor.
−
*Between '''<a>''' and '''</a>''', we see the link text that appears on the page: Nursery School
+
# Navigate to your repository folder. This should be something like: information-foraging-<YOUR_GITHUB_ID>-wustl.
 +
# Type in:
 +
'''npm install'''
 +
'''npm run dev'''
 +
# This will open the Nursery School site running at http://localhost:3000/ in a web browser.
 +
## You may notice a couple of alerts that pop up in your browser. This is because the URL is missing some information that the site expects to be there. If you would like these alerts not to show up, then use something like this URL in your browser instead: http://localhost:3000/?wustl_key=riley.mccuen.testing&sandbox=false&project=information-foraging&iteration=1&tag=books
 +
## Feel free to configure the query string in in that url if you would like, but either way it should get rid of the alerts that show up on page reload.
 +
# When you want to stop the web server you can press 'CTRL+C' and the server should shut down.
  
−
If you want to find a specific item on the page there are two ways to do so:
+
=Introductory Studio=
−
# You can hover over elements in the element pane, and they will get highlighted in the page. Note that HTML is hierarchical, so you may need to tunnel into child elements to find what you need.
+
The goal of this studio is to introduce you to the basic set of skills that you will need in order to begin modifying the nursery school site. While you won't emerge at the end of this knowing everything there is to know about HTML, CSS, and JavaScript, this should give you enough to be able to modify the starting code we've given you.
−
# You can also right click on the element you want to find and choose '''Inspect''' from the pop-up menu.
 
−
 
 
−
'''Task: ''' Use the developer tools to find the visit call to action.
 
−
 
 
−
'''Question: ''' What is the opening HTML tag for the entire gray region?  Note: this should be something like: <tagType propertyName="propertyValue">
 
−
 
 
−
==Changing Menu Names==
 
−
Some of the HTML elements are replicated in a number of pages, meaning that when you make changes to them in one place, you need to propagate those changes across the other pages on the site. The header is one such page.
 
−
 
 
−
'''Task: '''Change the menu item "Parent Resources" to "Recommended Reading". Then use replace in files to copy the modified header to all pages.
 
−
 
 
−
'''Question: ''' What does the html for the menu header look like now?
 
−
 
 
−
==Adding New HTML Content==
 
−
Should this have an example from the studio last semester?
 
  
−
==Finding and Modifying CSS Properties==
+
[[Information Foraging Studio]]
−
When you select an HTML element in the Elements pane, you can see its relevant CSS styling information in the pane immediately below. Note that these can also be hierarchical, so the Styles scrollpane shows you all of the relevant CSS for the selected element. Many of the names are self-explanatory, but searching for "<HTML TagName> <propertyName>" is a good way to find documentation and examples. So, for example, a search for "p line-height" explains that it's basically a way to change the line spacing, specified in pixels.
 
  
−
Sometimes, the properties currently used in CSS won't do what you want. You can also look up how which properties are available for a given HTML element. Searching for "<HTML TagName> properties" like "p properties" can help you determine what kinds of styling options are available.
+
=Adding Javascript to Your Site=
 +
When you find yourself wanting to add javascript there is one way we recommend doing it ('''NOTE''' if you do not do it this way it may not work as expected).
 +
# Create a new file in the information-foraging/scripts/ts/dynamic-dom/ directory in your repository. If you are only using javascript then feel free to make a .js file, but it is recommended to use typescript which would be a .ts file. Both types of files will be included if used and imported properly. ('''NOTE''' regardless of whether or not you use TS you need to include it in the '''ts'''/dynamic-dom/ directory and import it into dynamic-dom.ts otherwise the build script will not bundle it.)
 +
# Write your code in that new file.
 +
# Import that file into dynamic-dom.ts and initialize it using a static initializer like you see is being done with the accordion and slideshow elements.
 +
## Alternatively, if you only have a small amount of code and do not think that you need a whole new file then you can put your code directly in the information-foraging/scripts/ts/dynamic-dom/dynamic-dom.ts file.
 +
# If your code is in script tags inlined into the html or not initialized through the dynamic-dom.ts file it will either not show up on your page or cause numerous runtime errors. Keep in mind, if you open your developer's console in your browser and there are red errors then that means your code is broken and needs to be fixed.
 +
# Your code will need to be rebuilt in order to see these changes on your site.
 +
Here is how you should write your code and import it, there is an example for both a .js file and .ts file but you only need to have one of them:
  
−
'''Troubleshooting: ''' Browsers like to cache .CSS files and are often fairly aggressive about not reloading them. So, if you change things and they don't show up when you reload the page, you may need to clear your cache information. On Chrome you can do this from the three dots menu. Select '''More tools''' and then'''Clear browsing data.'''
+
This is for the javascript version in the file /information-foraging/scripts/ts/dynamic-dom/sticky.js
 +
export function setupSticky() {
 +
    // TODO: Copy and paste your sticky code in here!!
 +
}
  
−
'''Task: ''' Currently, there's an 80 pixel border around "Visit Our School", the "Our students..." sentence and the "Contact Us" button. Figure out how to change it to a 60 pixel border. Then, make it so that "Our students..." text has a larger inset from the border.  Note: To accomplish this, you will need to change one existing CSS property value and at least one new one.
+
This is for the typescript version in the file /information-foraging/scripts/ts/dynamic-dom/sticky.ts
 +
  export function setupSticky() {
 +
    // TODO: Copy and paste your sticky code in here!!
 +
}
  
−
'''Question: '''What are the modified CSS specifications needed to accomplish this? (Just the ones for classes you changed.)
+
Now that you have your code in sticky.(j|t)s, put the bolded code below in the file /information-foraging/scripts/ts/dynamic-dom/dynamic-dom.ts:
 +
import { Accordion } from './accordion';
 +
import { Slideshow } from './slideshow';
 +
'''import { setupStickey } from './stickey';'''
 +
 +
// Put all function calls that need to be made on every page load inside the setupAll function body.
 +
export function PutStudentPageLoadOperationsInsideThisStudentBody() {
 +
    // TODO: Put all operations that you want to happen on ever page load in this function.
 +
    // For example you could write: Sticky.setup()
 +
    '''setupStickey();'''
 +
}
 +
Like the comment says you can ''Put all function calls that need to be made on every page load inside the setupAll function body'' or you can put it into the PutStudentPageLoadOperationsInsideThisStudentBody function, either way it will work and is up to you.
  
−
==Defining New CSS Properties==
+
=Testing Your Site=
−
CSS styles are hierarchical, with more specific formatting rules taking precedence over more general ones. So, for example if a specification for a paragraph element sets a font and font color and then a paragraph element for a specific class sets different values for these things, the specific class's values win for that class. For more details, check out: [https://developer.mozilla.org/en-US/docs/Web/CSS/Specificity Specificity] and [https://developer.mozilla.org/en-US/docs/Web/CSS/Cascade The Cascade].
 
  
−
===An Example Style That Cascaded===
+
To test your site, you need to do two things:
−
'''Task: ''' Use the web developer tools to find the HTML element for "Our students" and look at it's styling.  
+
# Commit and push your code to Github. It may take a couple of minutes, but your changes will eventually be reflected in your Github pages site.
 +
<!-- # Submit a sandbox hit that you can try out. ([[Submitting Sandbox HITs]])-->
 +
# If you open your developer's console in your browser and see red errors, then something is broken and will be broken when you submit your hits. You must fix it.
  
−
'''Question:''' Where is the CSS specification that defines it's font? Hint: if you've found the right thing, you should see that the font property is defined on an ancestor.
+
==Uploading to Github Pages==
 +
To test or submit your project, you'll first need to upload your to Github.
  
−
===Making a New Style===
+
# If you've made changes to javascript and/or typescript code, please rebuild your code to get the new changes. (see [[Node Setup]] - step 6)
−
'''Task: ''' The Announcements and Classroom News headers don't really stand out and, as such, are less effective as headers to identify their respective section. Define a new style specification to make their font size twice as big as the standard font size. '''Hint:''' '''Hint: '''You may need to assign a class to the relevant HTML and define a style for that class.
+
# Test your site locally via localhost (see [[Running Sites Locally]])
 +
# Commit and push your changes (see [https://code.visualstudio.com/docs/editor/versioncontrol Version Control in VS Code])
 +
# It will take a few minutes but your Github pages site will eventually reflect your changes.
  
−
'''Question:''' What does your CSS code look like?
+
<!-- ==Making a Sandbox HIT==
 +
If you want to see what your MTurk workers will see, you can submit a sandbox hit.
  
−
==JavaScript==
+
# This page offers a walkthrough on how to do that. ([[Submitting Sandbox HITs]])
−
Sometimes, it's helpful to change the visual properties of something as a user interacts with a page. One example of this is a sticky header. A sticky header does something very simple: it defines two different styles for a given html element. Then it uses a simple listener to figure out when the header isn't visible on the screen. If the header is visible, it uses the normal style with the header on top of the body element. If it isn't, then it uses a different style that displays the header at the top of the screen, even if it is over part of the body element.  
 
  
−
'''Task: ''' Follow this tutorial on how to create a sticky tutorial and adapt it to work with the Nursery School site. [https://www.w3schools.com/howto/howto_js_sticky_header.asp Sticky Header Tutorial]
+
[[File:Screenshot (14).png|thumb|Worker Sandbox with relevant ui elements highlighted.]] -->
  
−
Some hints: You'll need to determine which html element is the header - use the one that shows the menu of navigation options. Then, you'll need to figure out how to make a sticky style that can be used for that element. Finally, you'll need to add the javascript. You can insert it directly in the page. Or, you can make a new js file and instead insert that page.
+
=Ground Rules=
  
−
'''Question: ''' What is the id for the html element associated with the header?
+
The nursery school has selected what content they make available on their website. We may not entirely agree with that selection, but it is our job to figure out how to present it in a way that enables end users to find the information they need. So, it is fair game (and encouraged) to reorganize the structure of the information. However, you may not remove access to information, even if it is not needed for the tasks we are testing. Further, I reserve the right to introduce new tasks without warning. Your best strategy is to holistically work towards a well structured site with good information scent.
  
−
'''Question: ''' What is the css definition for sticky as defined for your header element?
+
=Best Practice Videos=
 +
It seems pretty clear from looking at the sites you guys created that everyone has gotten the basic ideas around increasing the information density related to a given topic by grouping related information and increasing the information scent through the use of the right words and surrounding content. In going through the comments and the top solutions, I was looking to pull out some best practices that might not have been as obvious to give you one more set of tools that can help you think about information foraging into the future. These are a set of quick videos discussing some best practices in the context of the Nursery School Site.
  
−
=Submission=
+
#[https://drive.google.com/file/d/1M7SRGYxawdlQrGtgNsKmC_MNmZzoifZV/view?usp=sharing Visible Exits]
−
When you submit, you’ll submit your site and the (unique) “correct path” for each of the tasks.
+
#[https://drive.google.com/file/d/1HydDPrebZfj8d5yOHJiOl7IcSh4_VqB0/view?usp=sharing Intrapage Scent]
−
We will randomly choose three of the tasks to test. For future iterations, we’ll keep two tasks the
+
#[https://drive.google.com/file/d/1rpw0dRaADY7MzDwp6F6aIqNf_PxJyQFF/view?usp=sharing Promote High-Value Information]
−
same and then choose a different third task. This is intended to keep disincentivize degenerate
+
#[https://drive.google.com/file/d/1FjGN5NNVvsW2fQTnR60a-zyh_tr2evZz/view?usp=sharing Overfitting]
−
designs while also giving you an opportunity to iterate.
 

Latest revision as of 18:02, 18 February 2024

Task Description

Washington University hosts and on-site nursery school for children ages 2.5-5 years old. In this project, we are going to work to improve nursery school site visitors’ ability to find relevant information using Information Foraging Theory. Information Foraging Theory describes how users search for information using different cues.

Specifically, we will study the following scenarios:

  1. Math: You are a parent considering sending your child to Washington University Nursery School. You’ve learned that the curriculum is play-based and you want to know how learning is incorporated into a play-based context. You have some ideas about how language learning might happen, but are less sure about math. Find some examples of how math learning is incorporated at Washington University Nursery School.
  2. School Day: You are investigating pre-school options for your 4 year old. Both you and your spouse work, so you need to fully understand what scheduling constraints each option involves. One of your schools of interest is the Washington University Nursery School. When does school start and end each day? What is the longest period of time that your child can be there?
  3. Teacher Tenure: You are investigating pre-school options for your 3.5 year old. You’ve been told that one of the hallmarks of a good program is teachers who have been there for a long time. You want your child to attend in the mornings only. Which teachers would your child have and how long have they been at the school?
  4. Summer Camp: You are starting to look at summer camp options and have heard good things about Washington University Nursery School for young children. What are the daily camp hours? Are there any extended day opportunities?
  5. Discipline: You are investigating pre-school options for your spirited 3 year old and want to understand their approach to discipline. How do teachers at Washington University approach discipline?
  6. Spanish Song: Your daughter is in the Teddy Bear class at Washington University Nursery School. She came home this week singing a song in Spanish about shapes, but you are pretty sure that she has some of the words wrong. What are the correct lyrics?
  7. Books: It is mid-December, 2020 and you are thinking about things to do over your daughter's upcoming school break. She is 3 years old and attends the Washington University Nursery School and is in the Teddy Bear classroom. You are planning a trip to the library and want to check out some books that connect with something she is doing in school. What are some potential book topics that relate to something that is going on in her classroom this week?
  8. Admission-2: You are a parent with a child who has just been accepted to attend as a full time student at the Washington University Nursery School. You want to accept the offer of admission. Figure out what you need to do at this time to finalize your child’s place at the school.
  9. Deposit: You are a parent with a child who has just been accepted to attend as a full time student at the Washington University Nursery School. You need to pay one month of tuition as a deposit. Find out how much one month of tuition is and whether or not it is possible to pay online.
  10. Personalized Help: You are moving to St. Louis from Beijing and looking for a Pre-K program for your daughter, age 5. She is very close to her friends and you are worried that the move might be hard on her. She may need some extra support from her new teachers learning English, adapting to American culture, and making new friends. How does the Washington University Nursery School staff approach providing extra help to students who need it? (note: answer is the curriculum overview where it talks about how to provide extra help for individual students)
  11. Communication: You are looking at Nursery Schools for your soon to be 3 year old. He has never been in school or daycare before and you are somewhat worried about the transition. You'd like to ensure that you'll be able to have strong communication at his new school. How does the Washington University Nursery School handle communicating with parents? (note: answer is in the parent handbook under communication)
  12. Science: It’s mid-December and your son, age 4, came home all excited about science class. They learned a new word, but he can’t actually remember the word they learned about. What was the topic of his recent science class?
  13. Parent/Teacher Conferences: You are selecting a pre-school, but want to be sure that your daughter will be ready for kindergarten when it’s time. How does the nursery school assess children’s knowledge, support their growth, and share the results with parents?
  14. Orientation: You have recently accepted a position for your child for the coming school year at the Washington University Nursery School. Up to this point, your child has been at home and you are somewhat worried about the transition. How does the nursery school support kids’ transitions into school?

Grading

For each project, you will get assigned three tasks to test for that round. For the first round, these will be randomly chosen. For subsequent rounds, we will carry two of your previous tasks forward. You can submit up to three versions (see deadlines on the calendar). For each task, we'll assign a score that captures the degree to which participants completed it correctly (got the right answer) and efficiently (took the fastest path to get there). To get credit for a task, you need to outperform the baseline score by 20% for that task. Overall project grades will be:

  • 93: 3 tasks that perform >20% over the baseline, spread across any iteration.
  • 88: 2 tasks that perform >20% over the baseline, spread across any iteration.
  • 83: 1 task that performs >20% over the baseline, in any iteration.

Then you can earn bonus points as follows:

  • +7: all three tasks in a single iteration (Note: only your largest multi-task bonus will count)
  • +3: two tasks in a single iteration (Note: only your largest multi-task bonus will count)
  • +2: one of the top 3 performing tasks in the class (Note: you can earn this bonus for multiple tasks)

Prerequisite Readings

The goal of this assignment is use the ideas of information foraging to improve users' abilities to find information on the Washington University Nursery School site. As you work on your redesign you should be thinking about the information search process and trying to restructure and reorganize the information such that users can navigate it more easily.

  1. Scatter/Gather
  2. Information Foraging in Information Access Environments

Getting Started

Cloning the Information Foraging Baseline Code

We are hosting our repositories using github this semester. That means you will get a new repository for each of our three projects. When you accept an assignment through github classroom, it will create a repository for you based on the template that we've defined as the starting point for everyone.

  1. First, accept the assignment from github. Once the assignment is ready to go live, we will update the link here.
  2. Navigate to your cloned repository on github. You can get there by reloading the "generating your repository" page. Git hub will give you a link when it's ready. It should have a url something like: https://github.com/cse-256-f22/information_foraging-YOUR_GITHUB_ID-wustl.

Setting Up Pages

To see what your version of the nursery school site looks like, you can view it through github pages. This will also be how your user-testerss will view and interact with your site, so it's important to get going even if you plan to develop fully locally.

  1. Go the the settings tab
  2. Click on pages in the left-hand list of options
  3. Select 'deploy from a branch' and the branch you want users to see (likely main).
  4. Enable github Pages by hitting save
  5. Once you hit save, github will add a link to your hosted pages so that you can see them.

Note that it can take a while (sometimes ~30 minutes) for the site to get updated. Other times, it can be within a minute or two. Once you have it enabled, when you push changes to your repository, that should trigger a site refresh.

Baseline Code

Your repository contains the baseline version of the Nursery School site. Your assignment is to adapt that codebase to improve users' task performance. Within your top level repository directory you will find a subfolder called files that contains all of the HTML and CSS files you should need to edit for this project. If you would like to edit the JS of your site then do so in the scripts/ts/dynamic-dom folder.

To run the site locally, do these steps:

  1. Open a terminal window or the terminal in your code editor.
  2. Navigate to your repository folder. This should be something like: information-foraging-<YOUR_GITHUB_ID>-wustl.
  3. Type in:
npm install
npm run dev
  1. This will open the Nursery School site running at http://localhost:3000/ in a web browser.
    1. You may notice a couple of alerts that pop up in your browser. This is because the URL is missing some information that the site expects to be there. If you would like these alerts not to show up, then use something like this URL in your browser instead: http://localhost:3000/?wustl_key=riley.mccuen.testing&sandbox=false&project=information-foraging&iteration=1&tag=books
    2. Feel free to configure the query string in in that url if you would like, but either way it should get rid of the alerts that show up on page reload.
  2. When you want to stop the web server you can press 'CTRL+C' and the server should shut down.

Introductory Studio

The goal of this studio is to introduce you to the basic set of skills that you will need in order to begin modifying the nursery school site. While you won't emerge at the end of this knowing everything there is to know about HTML, CSS, and JavaScript, this should give you enough to be able to modify the starting code we've given you.

Information Foraging Studio

Adding Javascript to Your Site

When you find yourself wanting to add javascript there is one way we recommend doing it (NOTE if you do not do it this way it may not work as expected).

  1. Create a new file in the information-foraging/scripts/ts/dynamic-dom/ directory in your repository. If you are only using javascript then feel free to make a .js file, but it is recommended to use typescript which would be a .ts file. Both types of files will be included if used and imported properly. (NOTE regardless of whether or not you use TS you need to include it in the ts/dynamic-dom/ directory and import it into dynamic-dom.ts otherwise the build script will not bundle it.)
  2. Write your code in that new file.
  3. Import that file into dynamic-dom.ts and initialize it using a static initializer like you see is being done with the accordion and slideshow elements.
    1. Alternatively, if you only have a small amount of code and do not think that you need a whole new file then you can put your code directly in the information-foraging/scripts/ts/dynamic-dom/dynamic-dom.ts file.
  4. If your code is in script tags inlined into the html or not initialized through the dynamic-dom.ts file it will either not show up on your page or cause numerous runtime errors. Keep in mind, if you open your developer's console in your browser and there are red errors then that means your code is broken and needs to be fixed.
  5. Your code will need to be rebuilt in order to see these changes on your site.

Here is how you should write your code and import it, there is an example for both a .js file and .ts file but you only need to have one of them:

This is for the javascript version in the file /information-foraging/scripts/ts/dynamic-dom/sticky.js

export function setupSticky() {
   // TODO: Copy and paste your sticky code in here!!
}

This is for the typescript version in the file /information-foraging/scripts/ts/dynamic-dom/sticky.ts

export function setupSticky() {
   // TODO: Copy and paste your sticky code in here!!
}

Now that you have your code in sticky.(j|t)s, put the bolded code below in the file /information-foraging/scripts/ts/dynamic-dom/dynamic-dom.ts:

import { Accordion } from './accordion';
import { Slideshow } from './slideshow';
import { setupStickey } from './stickey';

// Put all function calls that need to be made on every page load inside the setupAll function body.
export function PutStudentPageLoadOperationsInsideThisStudentBody() {
    // TODO: Put all operations that you want to happen on ever page load in this function.
    // For example you could write: Sticky.setup()
    setupStickey();
}

Like the comment says you can Put all function calls that need to be made on every page load inside the setupAll function body or you can put it into the PutStudentPageLoadOperationsInsideThisStudentBody function, either way it will work and is up to you.

Testing Your Site

To test your site, you need to do two things:

  1. Commit and push your code to Github. It may take a couple of minutes, but your changes will eventually be reflected in your Github pages site.
  2. If you open your developer's console in your browser and see red errors, then something is broken and will be broken when you submit your hits. You must fix it.

Uploading to Github Pages

To test or submit your project, you'll first need to upload your to Github.

  1. If you've made changes to javascript and/or typescript code, please rebuild your code to get the new changes. (see Node Setup - step 6)
  2. Test your site locally via localhost (see Running Sites Locally)
  3. Commit and push your changes (see Version Control in VS Code)
  4. It will take a few minutes but your Github pages site will eventually reflect your changes.


Ground Rules

The nursery school has selected what content they make available on their website. We may not entirely agree with that selection, but it is our job to figure out how to present it in a way that enables end users to find the information they need. So, it is fair game (and encouraged) to reorganize the structure of the information. However, you may not remove access to information, even if it is not needed for the tasks we are testing. Further, I reserve the right to introduce new tasks without warning. Your best strategy is to holistically work towards a well structured site with good information scent.

Best Practice Videos

It seems pretty clear from looking at the sites you guys created that everyone has gotten the basic ideas around increasing the information density related to a given topic by grouping related information and increasing the information scent through the use of the right words and surrounding content. In going through the comments and the top solutions, I was looking to pull out some best practices that might not have been as obvious to give you one more set of tools that can help you think about information foraging into the future. These are a set of quick videos discussing some best practices in the context of the Nursery School Site.

  1. Visible Exits
  2. Intrapage Scent
  3. Promote High-Value Information
  4. Overfitting