Consistent interface

Just wanted to get your feedback on API consistency. I think we could do a lot more to make the API consistent and intuitive to use. Some examples:

• to_past, to_present, to_past functions return a mutated wrapped instance but americanize and britishize return just the changed text. Is that by design?
• Sentence.to_past returns the mutated Sentence instance but same doesn’t apply for Text.to_past. (I don’t know if there’s any way to fix that other than extending Array.prototype)
• Unlike other wrappers, (new NLP.term(...)).text is a string property rather than a function.

Also, I think it might make things a lot less error-prone if we can make the entire library immutable (that’d break backwards compatibility, maybe offer an immutability helper?)

[spencermountain]

hey Matthew, yeah you know, we’ve got the api articulated over here, we should really just add a boolean for which methods are mutable right now. I’m re-doing the docs and will add that information in

[nateabele]

@zenflow Or you could check out Ramda.