At the very least, separate out the example of writing an equivalency into a separate section. Though I notice there is already a section ``Writing new equivalencies`` - maybe you could try and make this clearer, or show an example there of writing a more complicated equivalency. If you do decide to keep this example, don't call it ``ghz_kms`` though, since the equivalency will actually work for all equivalent units. My *personal* vote is to simply remove the example altogether though, and clarify the ``Writing new equivalencies`` section if you think it could be made clearer.