diff --git a/GOALS_2.0.md b/GOALS_2.0.md deleted file mode 100644 index afbb60dc..00000000 --- a/GOALS_2.0.md +++ /dev/null @@ -1,64 +0,0 @@ -# (Vague) Jasmine 2.0 Goals/(Guidelines) - -1. No globals! - * jasmine library is entirely inside `jasmine` namespace - * globals required for backwards compatibility should be added in `boot.js` (EG, var describe = jasmine.getCurrentEnv().describe lives in boot.js) -1. Don't use properties as getters. Use methods. - * Properties aren't encapsulated -- can be mutated, unsafe. -1. Reporters get data objects (no methods). - * easier to refactor as needed -1. More unit tests - fewer nasty integration tests - -## Remaining non-story-able work: -* Make a `TODO` list - -### Hard -* Finish killing Globals - * Guidelines: - * New objects can have constructors on `jasmine` - * Top level functions can live on `jasmine` - * Top level (i.e., any `jasmine` property) should only be referenced inside the `Env` constructor - * should better allow any object to get jasmine code (Node-friendly) -* review everything in base.js -* Remove isA functions: - * isArray_ - used in matchers and spies - * isString_ - * isDOMNode_ - * isA_ - * unimplementedMethod_, used by PrettyPrinter -* jasmine.util should be util closure inside of env or something - * argsToArray is used for Spies and matching (and can be replaced) - * inherit is only for PrettyPrinter now - * formatException is used only inside Env/spec - * htmlEscape is for messages in matchers - should this be HTML at all? -* Pretty printing - * move away from pretty printer and to a JSON.stringify implementation? - * jasmineToString vs. custom toString ? - -### Easy - -* unify params to ctors: options vs. attrs. -* This will be a lot of the TODOs, but clean up & simplify Env.js (is this a 2.1 task?) - -### DONE -* Matchers improvements - * unit testable DONE - * better equality (from Underscore) DONE - * addCustomMatchers doesn't explode stack DONE - * refactor equals function so that it just loops & recurses over a list of fns (custom and built-in) - 2.1? (Tracker story) -* Spies - * break these out into their own tests/file DONE - - -## Other Topics - -* Docs - * Docco has gone over well. Should we annotate all the sources and then have Pages be more complex, having tutorials and annotated source like Backbone? Are we small enough? - * Need examples for: - * How to build a Custom Matcher - * How to add a custom equality tester - - - - -