improve discussion of the laws (doc comments only)