add documentation, extremify bug shapes