@@ -16,25 +16,8 @@ cd forge
 pip install -e .
 ```
 
-# Examples
-
-```python
-from mdf_forge.forge import Forge
-
-mdf = Forge()
-
-# free text query
-r = mdf.search("materials commons")
-
-# structured query
-r_2 = mdf.search_by_elements(elements=["Al","Cu"], sources=["oqmd"])
-```
-
-More examples are available in the docs/examples directory.
-
-
-# Documentation
-Documentation is available in the docs directory.
+# Documentation and examples
+Documentation, including tutorials and examples, can be found in the `docs` directory.
 
 # Requirements
 * Forge requires Python 2.7 or >=3.3 
 
@@ -34,7 +34,7 @@
     "\n",
     "In order to use `globus_download()` to download to your computer, you must be running [Globus Connect Personal](https://www.globus.org/app/endpoints/create-gcp) . If you want to download to a different computer (which must be a Globus Endpoint), you have to specify `dest_ep=ID_of_destination_endpoint`.\n",
     "\n",
-    "Please note that while _almost_ all data in MDF is accessible through a Globus Endpoint, there may be some entries that are not. A few datasets may be hosted elsewhere and only accessible through HTTP (see `http_download()`) or hosted elsewhere in a custom, non-programmatic configuration. You may have to use the `\"mdf.links.landing_page\"` web address to fetch these datasets."
+    "Please note that while _almost_ all data in MDF is accessible through a Globus Endpoint, there may be some entries that are not. A few datasets may be hosted elsewhere and only accessible through HTTP (see `http_download()`) or hosted elsewhere in a custom, non-programmatic configuration."
    ]
   },
   {
@@ -44,7 +44,7 @@
    "outputs": [],
    "source": [
     "# Running this example will save a file in the current directory.\n",
-    "res = mdf.search(\"dft.converged:true AND mdf.resource_type:record\", limit=1)\n",
+    "res = mdf.search(\"dft.converged:true AND mdf.resource_type:record\", limit=10)\n",
     "mdf.globus_download(res)"
    ]
   },
Original file line number	Diff line number	Diff line change
`@@ -34,7 +34,7 @@`
`34`	`34`	`"\n",`
`35`	`35`	"In order to use `globus_download()` to download to your computer, you must be running [Globus Connect Personal](https://www.globus.org/app/endpoints/create-gcp) . If you want to download to a different computer (which must be a Globus Endpoint), you have to specify `dest_ep=ID_of_destination_endpoint`.\n",
`36`	`36`	`"\n",`
`37`		- "Please note that while _almost_ all data in MDF is accessible through a Globus Endpoint, there may be some entries that are not. A few datasets may be hosted elsewhere and only accessible through HTTP (see `http_download()`) or hosted elsewhere in a custom, non-programmatic configuration. You may have to use the `\"mdf.links.landing_page\"` web address to fetch these datasets."
	`37`	+ "Please note that while _almost_ all data in MDF is accessible through a Globus Endpoint, there may be some entries that are not. A few datasets may be hosted elsewhere and only accessible through HTTP (see `http_download()`) or hosted elsewhere in a custom, non-programmatic configuration."
`38`	`38`	`]`
`39`	`39`	`},`
`40`	`40`	`{`
`@@ -44,7 +44,7 @@`
`44`	`44`	`"outputs": [],`
`45`	`45`	`"source": [`
`46`	`46`	`"# Running this example will save a file in the current directory.\n",`
`47`		`- "res = mdf.search(\"dft.converged:true AND mdf.resource_type:record\", limit=1)\n",`
	`47`	`+ "res = mdf.search(\"dft.converged:true AND mdf.resource_type:record\", limit=10)\n",`
`48`	`48`	`"mdf.globus_download(res)"`
`49`	`49`	`]`
`50`	`50`	`},`