doc updates
documented ferenda.Facet and made some more tests while at it