lemonad icon indicating copy to clipboard operation
lemonad copied to clipboard

Document something about this library's use

Open rektide opened this issue 12 years ago • 2 comments
trafficstars

There is no online documentation showing this library off or describing the capabilities it offers.

The tests would be a sufficient starting place, would that the source be visible and not just recite "pass.

rektide avatar Jun 28 '13 05:06 rektide

I don't understand the last sentence, but in any case I do agree with the need for docs. However, that is a task that shall be deferred as my attentions are drawn elsewhere at the moment. Thank you for the interest.

fogus avatar Jun 28 '13 11:06 fogus

Re, "tests would be a sufficient starting place"

The "spec" link on the homepage take us to http://fogus.github.io/lemonad/test.html

That page declares what various behaviors of the library are, but provides no visibility into what to do to get that behavior. If that page (a test runner) also linked or showed source for any given test, I believe it would serve excellently as documentation.

Is this "jasmine_reporter" stock in Jasmine, or did you supplement Jasmine with additional reporting libraries, and if so, what? I myself would consider hacking this upstream in Jasmine if applicable, but I am not sure how much of it is your own design, how much is Jasmine, and whether there's other test running libraries that might have gone into it's creation.

Thanks fogus.

rektide avatar Jun 28 '13 22:06 rektide