api reference doc issues

[ixje]

List of known issues with mkapi we need to patch to improve the generated documentation

• [ ] typing.Optional are not parsed correctly. It only shows Optional not the containing type
• [ ] See Also links are not resolved correctly when referencing another document
• [x] Enum's do not show its members, but instead show all internal/inherited methods that are not useful
• [ ] add ability to filter unwanted modules
• [ ] Does not understand typing.Sequence, only shows Sequence not the containing type.
• [ ] class attributes are not documented