WYRL: yet more documentation.  Actually feeling better about the Core now.