-
Notifications
You must be signed in to change notification settings - Fork 344
Complete functionality
Gracjan Polak edited this page Feb 21, 2016
·
5 revisions
A complete functionality has all the necessary components to be used directly by Haskell Mode users. It also has required support so that Haskell Mode community can support that functionality for prolonged periods of time.
A complete functionality satisfies the following checklist:
- functionality is available via a defined keybinding
- functionality is available via a menu option
- functionality is documented in the official manual
- interactive functions are well described in docstrings with end user in mind
- functionality does not require additional elisp code from user
- functionality works reasonably well with default settings
- code implementing the functionality has enough quality to not be a burden on Haskell Community
- code is sufficiently general to serve many users
- error handling is in place and is end user friendly
- code is reasonably well covered by unit tests
- functionality is discoverable
- functionality has low cognitive burden
For more information see Low cognitive burden and discoverability.
Transition period: currently haskell-mode has significant amount of code that does not satisfy many of the points above. Haskell Mode Community needs to decide if right decision for the overall being of the project is to improve the functionality or given limited amount of effort available to spend it is better to throw the towel and give up.