Several chapters' exercises.

Author: dham

doc/source/3_objects.rst

@@ -462,7 +462,7 @@ user might type in order to recreate the object. For example::
 
 `type(self).__name__` simply evaluates to the class name, in this case
 `Polynomial`. This is better than hard-coding the class name because, as we will
-see in :numref:`week %s <inheritance>`, this implementation of
+see in :numref:`Chapter %s <inheritance>`, this implementation of
 :meth:`~object.__repr__` might well end up being inherited by a class with a
 different name. Notice that in order to help ensure consistency of
 representations we call :func:`repr` on the coefficients in this case, whereas
@@ -876,19 +876,27 @@ Glossary
 Exercises
 ---------
 
-.. only:: html
+.. .. only:: html
 
-   .. panels::
-       :card: quiz shadow
+..    .. panels::
+..        :card: quiz shadow
 
-       .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2054444_1
-           :text: This week's quiz
-           :classes: stretched-link 
+..        .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2054444_1
+..            :text: This week's quiz
+..            :classes: stretched-link 
 
+.. only:: not book
 
-Obtain the `skeleton code for these exercises from GitHub Classroom <https://classroom.github.com/a/mElLR0AD>`__. 
-The skeleton code contains a :mod:`polynomial` package with a version of 
-the :class:`Polynomial` class.
+    Using the information on the `book website 
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__
+    obtain the skeleton code for these exercises. The skeleton code contains a
+    :mod:`polynomial` package with a version of the :class:`Polynomial` class.
+
+.. only:: book
+
+    Using the information on the `book website` [#exercise_page]_,
+    obtain the skeleton code for these exercises. The skeleton code contains a
+    :mod:`polynomial` package with a version of the :class:`Polynomial` class.
 
 .. proof:exercise::
 
@@ -909,15 +917,16 @@ the :class:`Polynomial` class.
 
 .. proof:exercise::
 
-    Define a function `derivative` in :file:`polynomials.py` which takes a
-    :class:`Polynomial` and returns a new :class:`Polynomial` which is its
-    derivative. Also define a :meth:`dx` method on the :class:`Polynomial` class
-    which returns the derivative of that :class:`Polynomial`. Rather than
-    duplicating code, you should implement the function by calling the method.
+    Define a :meth:`dx` method on the :class:`Polynomial` class which returns a
+    new :class:`Polynomial` which is the derivative of that
+    :class:`Polynomial`. Also define a function `derivative` in
+    :file:`polynomials.py` which takes a :class:`Polynomial` and returns  its
+    derivative. Rather than duplicating code, you should implement the function
+    by calling the method.
 
 .. proof:exercise::
 
-    Inside the exercise repository for this week, create a new :mod:`shape`
+    Inside the exercise repository, create a new :mod:`shape`
     package containing a :mod:`circle` module. 
 
     1. Create a :class:`Circle` class
@@ -945,7 +954,10 @@ the :class:`Polynomial` class.
 .. proof:exercise::
 
     Make the :mod:`circle` and :mod:`polynomial` packages installable. As with
-    last week's exercise, pytest can't test this so you'll need to push to
+    last chapter's exercise, Pytest can't test this so you'll need to push to
     GitHub and check that the autograding tests pass there.
 
-        
+.. rubric:: Footnotes
+
+.. [#exercise_page] `https://object-oriented-programming.github.io/edition1/exercises.html
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__

doc/source/4_style.rst

@@ -1228,42 +1228,36 @@ Glossary
 Exercises
 ---------
 
-.. only:: html
+.. .. only:: html
 
-   .. panels::
-       :card: quiz shadow
+..    .. panels::
+..        :card: quiz shadow
 
-       .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2070388_1&mode=cpview
-           :text: This week's quiz
-           :classes: stretched-link 
+..        .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2070388_1&mode=cpview
+..            :text: This week's quiz
+..            :classes: stretched-link 
 
 .. proof:exercise::
 
     Install flake8, pep8-naming, and flake8-docstrings.
     Configure your Python editor to use flake8.
 
-The `skeleton code for this chapter's exercises on GitHub Classroom
-<https://classroom.github.com/a/GCKdXtVA>`__ contains a package :mod:`life`
-which implements Conway's Game of Life. Accept the assignment, and clone the
-repository. Install the package in editable mode. This will also install some
-additional packages that the :mod:`life` package depends on. This is achieved
-using an additional argument to :func:`setuptools.setup`.
+.. only:: not book
+
+    The skeleton code on GitHub for this chapter's exercises contains a package
+    :mod:`life` which implements Conway's Game of Life. Using the information on the `book website 
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__
+    obtain the skeleton code for these exercises. Clone the repository into
+    your working folder and install the package in editable mode.
+
+.. only:: book
+
+    The skeleton code on GitHub for this chapter's exercises contains a package
+    :mod:`life` which implements Conway's Game of Life. Using the information
+    on the book website [#exercise_page]_
+    obtain the skeleton code for these exercises. Clone the repository into
+    your working folder and install the package in editable mode.
 
-.. code-block:: python3
-    :caption: `setup.py` for the :mod:`life` package. The `install_requires`
-        parameter is used to install other packages that :mod:`life` needs.
-
-    from setuptools import setup, find_packages
-    setup(
-        name="life",
-        version="0.1",
-        packages=find_packages(),
-        install_requires=[
-            "matplotlib",
-            "scipy",
-            "numpy"
-        ]
-    )
 
 A couple of example scripts are provided which demonstrate the game of life.
 This one shows a glider flying across the board:
@@ -1349,7 +1343,9 @@ neverending sequence of gliders:
     two parameters, a :class:`Pattern` and a pair of integers representing a
     square on the game board. The method should modify the game board so as to
     insert the pattern provided at a location centred on the location given by
-    the pair of integers.
+    the pair of integers. :numref:`glider_inserted` illustrates this operation.
+
+    .. _glider_inserted:
 
     .. figure:: images/glider_inserted.png
         :width: 60%
@@ -1376,3 +1372,6 @@ six oscillating blinkers:
           such, they are usually of little interest to most Python
           users. However the PEPs having to do with style have wider
           significance.
+
+.. [#exercise_page] `https://object-oriented-programming.github.io/edition1/exercises.html
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__

doc/source/5_abstract_data_types.rst

@@ -828,20 +828,29 @@ Glossary
 Exercises
 ---------
 
-.. panels::
-    :card: quiz shadow
+.. .. panels::
+..     :card: quiz shadow
 
-    .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2077681_1&mode=cpview
-        :text: This week's quiz
-        :classes: stretched-link 
+..     .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2077681_1&mode=cpview
+..         :text: This week's quiz
+..         :classes: stretched-link 
 
+.. only:: not book
 
-Obtain the `skeleton code for these exercises from GitHub classroom
-<https://classroom.github.com/a/eHigwP_C>`__. You will also need to install the pytest-timeout package.
+    Using the information on the `book website 
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__
+    obtain the skeleton code for these exercises. You will also need to install
+    the pytest-timeout package.
+
+.. only:: book
+
+    Using the information on the book website [#exercise_page]_ obtain the
+    skeleton code for these exercises. You will also need to install the
+    pytest-timeout package.
 
 .. proof:exercise::
 
-    In this week's skeleton repository, create a :term:`package` called
+    In the exercise repository, create a :term:`package` called
     :mod:`adt_examples` with a :term:`module` called
     :mod:`adt_examples.fibonacci`. Make the package installable and install it
     in editable mode. Create a class :class:`Fib` implementing the iterator
@@ -863,7 +872,7 @@ Obtain the `skeleton code for these exercises from GitHub classroom
 
 .. proof:exercise::
 
-    In this week's skeleton repository, create a :term:`module`
+    In the exercise repository, create a :term:`module`
     :mod:`adt_examples.rpcalc` containing a class :class:`RPCalc` implementing a
     reverse Polish calculator. The calculator should have the following methods:
 
@@ -891,7 +900,7 @@ Obtain the `skeleton code for these exercises from GitHub classroom
 
 .. proof:exercise::
 
-    In this week's skeleton repository, create a :term:`module`
+    In the exercise repository, create a :term:`module`
     :mod:`adt_examples.deque` containing a class :class:`Deque` implementing a
     :term:`deque`. Your implementation should use a ring buffer implemented
     as a Python list. In order to make things somewhat simpler, we will use a
@@ -950,3 +959,8 @@ Obtain the `skeleton code for these exercises from GitHub classroom
     .. note::
 
         You may not use :class:`collections.deque` to implement this exercise.
+
+.. rubric:: Footnotes
+
+.. [#exercise_page] `https://object-oriented-programming.github.io/edition1/exercises.html
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__

doc/source/6_exceptions.rst

@@ -797,17 +797,33 @@ Glossary
         in each :term:`stack frame`, with the current frame at the
         bottom and the outermost frame at the top.
 
+.. only:: book
+
+    .. raw:: latex
+
+        \clearpage
+
 Exercises
 ---------
 
-.. panels::
-    :card: quiz shadow
+.. .. panels::
+..     :card: quiz shadow
+
+..     .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2083792_1&mode=cpview
+..         :text: This week's quiz
+..         :classes: stretched-link 
 
-    .. link-button:: https://bb.imperial.ac.uk/webapps/assessment/take/launchAssessment.jsp?course_id=_25965_1&content_id=_2083792_1&mode=cpview
-        :text: This week's quiz
-        :classes: stretched-link 
+.. Obtain the `skeleton code for these exercises from GitHub classroom <https://classroom.github.com/a/JqFsKmoR>`__. 
+.. only:: not book
 
-Obtain the `skeleton code for these exercises from GitHub classroom <https://classroom.github.com/a/JqFsKmoR>`__. 
+    Using the information on the `book website 
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__
+    obtain the skeleton code for these exercises.
+
+.. only:: book
+
+    Using the information on the book website [#exercise_page]_ obtain the
+    skeleton code for these exercises.
 
 .. proof:exercise::
 
@@ -825,7 +841,7 @@ Obtain the `skeleton code for these exercises from GitHub classroom <https://cla
     iteration should fail if :math:`n` exceeds a user-specified number of
     iterations.
 
-    The skeleton code for this week contains a function
+    The skeleton code for this chapter contains a function
     :func:`nonlinear_solvers.solvers.newton_raphson` which takes as arguments a
     function, its derivative and a starting point for the iteration. It can also
     optionally be passed a value for :math:`\epsilon` and a maximum number of
@@ -866,3 +882,6 @@ Obtain the `skeleton code for these exercises from GitHub classroom <https://cla
 
 .. [#function] "Function call" here includes :term:`method` calls and
                operations implemented using a :term:`special method`.
+
+.. [#exercise_page] `https://object-oriented-programming.github.io/edition1/exercises.html
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__

doc/source/7_inheritance.rst

@@ -517,6 +517,7 @@ Consider the :meth:`__str__` method of :class:`~example_code.groups.Group`:
     :lineno-start: 19
 
     def __str__(self):
+        """Return a string in the form symbol then group parameter."""
         return f"{self.symbol}{self.n}"
 
 This code uses `self.symbol`, but this attribute isn't defined anywhere on
@@ -772,15 +773,24 @@ Glossary
 Exercises
 ---------
 
-Obtain the `skeleton code for these exercises from GitHub classroom <https://classroom.github.com/a/VXIC_gES>`__. 
+.. only:: not book
+
+    Using the information on the `book website 
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__
+    obtain the skeleton code for these exercises.
+
+.. only:: book
+
+    Using the information on the book website [#exercise_page]_ obtain the
+    skeleton code for these exercises.
 
 .. proof:exercise::
 
     The symmetric group over `n` symbols is the group whose members are all the
     permutations of `n` symbols and whose group operation is the composition of
     those permutations: :math:`a \cdot b = a(b)`.
 
-    In this week's skeleton code repository, create package called
+    In the exercise repository, create package called
     :mod:`groups` containing a module called :mod:`symmetric_groups`. Define a
     new class :class:`SymmetricGroup` which inherits from
     :class:`example_code.groups.Group` and implements the symmetric group of
@@ -799,7 +809,7 @@ Obtain the `skeleton code for these exercises from GitHub classroom <https://cla
 
         You will need to :keyword:`import` :class:`example_code.groups.Group`
         from the `object_oriented_programming` repository that you installed
-        :ref:`in week 2 <course_repo>`. You should also `git pull` in that
+        :ref:`in Chapter 2 <course_repo>`. You should also `git pull` in that
         repository in order to get any changes that have happened in the
         intervening period.
 
@@ -815,7 +825,7 @@ Obtain the `skeleton code for these exercises from GitHub classroom <https://cla
     :class:`set` class which are only valid for values which pass a certain
     test. For example, one might have a set which can only contain integers.
 
-    1. In this week's repository, create a package called :mod:`sets` containing a
+    1. In the exercise repository, create a package called :mod:`sets` containing a
        module `verified_sets`. Create a subclass of the inbuilt :class:`set`,
        :class:`sets.verified_sets.VerifiedSet`. :class:`VerifiedSet` will itself 
        be the parent of other classes which have particular verification rules.
@@ -851,3 +861,8 @@ Obtain the `skeleton code for these exercises from GitHub classroom <https://cla
        should create a new exception :class:`UniquenessError`, a subclass of
        :class:`KeyError`. :class:`UniqueSet._verify` should raise this if an
        operation would add a duplicate value to the :class:`UniqueSet`.
+
+.. rubric:: Footnotes
+
+.. [#exercise_page] `https://object-oriented-programming.github.io/edition1/exercises.html
+    <https://object-oriented-programming.github.io/edition1/exercises.html>`__