more edits

ChronAm API Samples.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Purpose of the Guide\n",
+    "# Purpose of this Guide\n",
     "Chronicling America is a website containing historic newspapers and the Library of Congress has created an API to allow for automated processes to interact with that data."
    ]
   },
@@ -19,13 +19,11 @@
     }
    },
    "source": [
-    "## What is ChronAm's API?\n",
+    "## What is Chronicling America’s API?\n",
     "\n",
     "- a set of subroutine definitions, protocols, and tools for building software and applications...\n",
     "\n",
-    "Only kidding\n",
-    "\n",
-    "- It's some text on a screen. Go ahead, you can read it!\n",
+    "Only kidding! It's some text on a screen. Go ahead, you can read it!\n",
     "\n",
     "http://chroniclingamerica.loc.gov/lccn/sn85058396/1916-09-12/ed-1/seq-2.json\n",
     "Not only can you read it, so can different programs and applications, making it a flexible and powerful tool for researching within Chronicling America. To use the Chronicling America API, you'll need a\n",
@@ -49,14 +47,14 @@
     "There are a lot of possibillities! Look at some examples of what can be done with Chronicling America's API.\n",
     "You can:\n",
     "### Make stuff!\n",
-    "People made an interactive map of the United States that allows visitors to visualize Chronicling America search results across space and time. \n",
+    "For example, researchers made an interactive map of the United States that allows visitors to visualize Chronicling America search results across space and time. \n",
     "### Discover stuff!\n",
     "In 2016, challenge participants were asked \"How can you use open data to explore history?\" Members of the public were invited to craft web-based projects that demonstrated the potential for using the data found in Chronicling America. \n",
     "\n",
     "Learn more about these and other successful projects from this challenge at this blogpost on The Signal https://blogs.loc.gov/thesignal/2016/08/the-neh-chronicling-america-challenge-using-big-data-to-ask-big-questions/\n",
     "# Let's Discover and Make\n",
     "Ready to explore? Let's go!\n",
-    "What's the first step? Suppose you want to find out how many pages of newspapers we have for Arizona? You'll see that we ask for results by state, and specifically those from Arizona.\n",
+    "Suppose you want to find out how many pages of newspapers we have for Arizona? You'll see that we ask for results by state, and specifically those from Arizona.\n",
     "In the next block you just need to fill in the API URL. For example, put \"http://chroniclingamerica.loc.gov/search/pages/results/?state=Arizona&format=json\" in there. By looking at the JSON that is returned we can see that we are getting the first page of results, which includes 20 items."
    ]
   },
@@ -205,8 +203,7 @@
     }
    },
    "source": [
-    "The result, about 1828960.\n",
-    "Hmmm. Well, that seems like quite a few pages of dogs... Let's look at one example. Remember, if we want the first result, we'll ask for \"0\":"
+    "About 1.8 million results…hmmm. Well, that seems like quite a few pages of dogs... Let's look at one example. Remember, if we want the first result, we'll ask for \"0\":"
    ]
   },
   {
@@ -270,7 +267,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Well, that's an interesting argument, to be sure.\n",
     "At any rate, there's some mounting evidence for the dog side of the debate. You still want to explore the frequency of cat mentions. But first, you decide to check in on a more complicated question like \"which state likes dogs?\" We will measure this by volume of mentions. You decide to take just the first twenty results for the search \"dog\" on Chronicling America (because it would take too long to do them all)."
    ]
   },
@@ -466,6 +462,17 @@
     "In the meantime, you can give your friends Illinois, Kentucky, Virginia, and New York as consolation!"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "collapsed": true
+   },
+   "source": [
+    "# Further Research\n",
+    "Now you’re ready to tackle answers in other debates. Remember you can explore more from Chronicling America here: http://chroniclingamerica.loc.gov/about/\n",
+    "You can also Ask A Librarian: https://www.loc.gov/rr/askalib/"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,

IIIF.ipynb

@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Purpose of the Guide\n",
+    "# Purpose of this Guide\n",
     "IIIF is a powerful and flexible way to serve, explore, manipulate, and improve images. \n",
     "This guide outlines several ways you can use the Library of Congress IIIF API to manipulate images from Library of Congress collections. "
    ]
@@ -19,7 +19,7 @@
     "\n",
     "Or in other terms, it is a standard way to get an image using a API.\n",
     "\n",
-    "# What the different parts of the URL mean?\n",
+    "# What do the different parts of the URL mean?\n",
     "The url that you request to get a image has several parts that determine what and how the image is returned. Here is a brief overview of the various parts. To learn more in-depth please see http://iiif.io/api/image/2.1/\n",
     "\n",
     "`{scheme}://{server}{/prefix}/{identifier}/{region}/{size}/{rotation}/{quality}.{format}`\n",
@@ -262,6 +262,7 @@
    },
    "source": [
     "# Gotchas\n",
+    "There are some nuances to keep in mind as you’re working with IIIF images. Here are a few things to watch:\n",
     "* Images define the x-axis differently then you might expect. For example, 0 in the y-axis is the top of the image, not the bottom. And increasing the y-axis moves the starting point *down* the image, not up like you would normally expect.\n",
     "* The IIIF specification allows for many neat actions, however not all images support all actions so be sure to check the info.json response to make sure your action is supported."
    ]

LOC.gov JSON.ipynb → LOC.gov JSON API.ipynb

@@ -20,7 +20,7 @@
     "# What can you do with it?\n",
     "Explore, discover, and make cool stuff! Let's look at some examples you can try:\n",
     "\n",
-    "## Let's look at the trending content\n",
+    "## A look at the trending content\n",
     "What's the latest on the Library of Congress homepage? We can explore what's happening by asking for the JSON data about the trending content:"
    ]
   },
@@ -76,7 +76,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Ok so I got some text that looks like giberish, now what?\n",
+    "## Ok so I got some text that looks like gibberish, now what? \n",
     "Now we can use a bit of Python to do cool stuff with it! Want to see all of the titles of the Library of Congress collections? Sure, let's try it!"
    ]
   },
@@ -143,7 +143,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Why does it stop after 40?\n",
+    "## Why does it stop after 40?\n",
     "You might be thinking \"there must be colletions after \"B\"... and you're correct. \n",
     "If we were to give you the data for all our collections it would take a really long time to return the information. So instead we break it into pages. The _pagination_ section of the json contains the information that you need to really get everything (this list is going to be LONG!):"
    ]
@@ -392,8 +392,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Looking more closely at Collections\n",
-    "Now you're exclaiming \"Ohh cool, you have World War I Sheet Music! \"\n",
+    "## Looking more closely at Collections\n",
+    "We hear you saying \"Ohh cool, you have World War I Sheet Music! \"\n",
     "Yes we do! Let's grab the titles and the front covers:"
    ]
   },
@@ -842,7 +842,7 @@
    "metadata": {},
    "source": [
     "## Asking another question\n",
-    "You noticed that the sheet music covers sometimes include publishers. Can we get more details about that? Yes, you can!\n",
+    "You noticed that the sheet music covers sometimes include publishers. You wonder if you can get more details about that. Yes, you can!\n",
     "Much of the sheet music was published by multiple organizations or people and around the country and world. \n",
     "We'll use some python code to display the list of publishers and created date of the titles:"
    ]
@@ -950,7 +950,8 @@
     "collapsed": true
    },
    "source": [
-    "Well, this chart may have confused a few things. Did you know you can get in touch with our Library staff for further research support?! Check out the \"ask a librarian\" section of our website: https://www.loc.gov/rr/askalib/"
+    "## Further Research\n",
+    "Check out the \"ask a librarian\" section of our website: https://www.loc.gov/rr/askalib/"
    ]
   },
   {

OpenSearch.ipynb

@@ -4,19 +4,19 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# What is OpenSearch?\n",
-    "OpenSearch is a collection of simple formats for the sharing of search results. The Library of Congress uses OpenSearch formats to help people discover and use our search engine. It also means we can syndicate search results across the web.\n",
+    "# Purpose of this Guide\n",
+    "OpenSearch is a collection of simple formats for the sharing of search results. The Library of Congress uses OpenSearch formats to help people discover and use our search engine. It also means we can syndicate search results across the web. This guide explains how to apply OpenSearch so you can explore more Library of Congress collections\n",
     "\n",
     "# What do I need to use OpenSearch? \n",
     "* A web browser like Chrome or Firefox\n",
     "* A willingness to try\n",
     "* Curiosity\n",
     "\n",
     "# What can you do with it?\n",
-    "OpenSearch will help you find cool stuff on the Library of Congress website -- https://loc.gov -- website without hassle. \n",
+    "OpenSearch will help you find cool stuff on the Library of Congress website -- https://loc.gov -- without hassle. \n",
     "\n",
     "# Ready to try it?\n",
-    "Find the browser you use below and give it a try. Check out the browser examples below:"
+    "Find the browser you use below to give it a try:"
    ]
   },
   {