* Use a definitions list * Do we need the term "downstream" * Clone from your fork, not from the MetOffice * rework flow diagram (make it code?) * give "before you start" section a refresh * think about new users