Edits from review

Author: lwasser

tutorials/1-installable-code.md

@@ -1,4 +1,4 @@
-# Make your Python code pip installable
+# Make your Python code installable
 
 In the previous lesson, you learned about both what a Python package is. You also learned about the [benefits of creating a Python
 package](tutorials/intro.html#why-create-a-python-package) including:
@@ -50,30 +50,47 @@ environment. You are welcome to use any environment manager that you choose.
 you are a scientist, we suggest that you use `conda`, particularly if you are working with any sort of spatial data.
 :::
 
-## Make your package installable
+
+
+## Make a basic installable Python package
 
 
 :::{figure-md} packages-environment
 
 <img src="../images/tutorials/environment-package-install.png" alt="This diagram has two smaller boxes with arrows pointing to the right to a python environment. The small boxes read your-package and pip install package. The environment box on the right reads - your python environment. It them lists your-package along with a few other core packages such as matplotlib, numpy, pandas, xarray and geopandas." width="700px">
 
-Making your source code pip-installable is the first step towards creating a Python package. Once your code is pip-installable, it is a Python package and can be added to any Python environment on your computer and imported in the same way that you might import a package such as `Pandas` or `Geopandas`.
+Making your source code pip-installable is the first step towards creating a Python package. Once your code is pip-installable, it is a Python package and can be added to any Python environment on your computer and imported in the same way that you might import a package such as Pandas or GeoPandas.
 :::
 
-## Make a basic Python package
-
 It’s time to create the most basic version of a Python package.
-While this code can't be yet published to PyPI or conda and
-is not documented, it will be installable on your computer or
-anyone elses.
+
+What you'll be able to do with this package at the end of this lesson is:
+
+* Install it into any Python environment on your computer
+* If you share your code with someone else on GitHub or some other file/sharing or cloud based sharing platform, others will be able to install your package too.
+
+While installable code is the first step towards making a Python package, there are some limitations. What you won't be able to do
+by the end of this lesson is publish your package to PyPI and then conda-forge.
+
+The next 3 lessons in this series will teach you how to add the proper
+metadata and documentation that you will need to publish to PyPI.
+
+:::{admonition} Installing packages from GitHub
+
+If you wish to share your code without publishing to PyPI you can
+always install packages directly from GitHub using the syntax:
+
+`pip install git+https://github.com/user/repo.git@branch_or_tag``
+
+:::
 
 ### What does a basic package directory structure look like?
 To make your code installable you need:
 
-- A `pyproject.toml` file
-- An (optional but recommended) `__init__.py` file in your code directory
-- A specific directory structure
+- A `pyproject.toml` file.
+- A specific directory structure.
 - Some code.
+- An `__init__.py` file in your code directory.
 
 The directory structure you’ll create in this first section looks like this: