docs/extending, fixes