This is a useful example, but I think the bulk of it should be outside the challenge - the before/after example and accompanying text are lesson, and only the last paragraph is challenge. Can you please refactor and resubmit?

I like this example a lot: I even used it today in a SWC workshop to motivate the discussion for documentation. I think inserting it before the Testing and Documentation section would be good. I only worry that the term 'self-documenting code' may create the perception that as long as the names are human readable we do not need documentation, so I suggest removing the sentence which mentions it.

I merged and made the changes suggested by @gvwilson and @valentina-s. Thanks for your contribution @stuckyb!