Comments (7)
I'm not sure I'm following... The settings file is there in the source. It should be picked up when the tests are run.
from event-store-client-http.
Please document how to invoke the tests
Sent from my iPhone
On Oct 19, 2015, at 8:53 AM, Scott Bellware [email protected] wrote:
I'm not sure I'm following... The settings file is there in the source. It should be picked up when the tests are run.
—
Reply to this email directly or view it on GitHub.
from event-store-client-http.
How about if we establish a convention where a library has a test.sh
file that runs the tests, and consequently demonstrates how they're run?
from event-store-client-http.
Sure. Sounds good. As long as it is documented somewhere. Are you resistant to using README's for that purpose in general? I have sensed a lot of resistance from you about using README's. We are writing these things for humans, so should communicate human to human about how these work (even if that consuming human is our future selves)
Sent from my iPhone
On Oct 19, 2015, at 9:21 AM, Scott Bellware [email protected] wrote:
How about if we establish a convention where a library has a test.sh file that runs the tests, and consequently demonstrates how they're run?
—
Reply to this email directly or view it on GitHub.
from event-store-client-http.
No, no resistance at all. Just that we have a lot of READMEs to write, and I don't want to just "ad hoc" them into existence through rapid response actions. I can see a quick path to another kind of mess if we don't put at least a little thought into the structure of READMEs.
from event-store-client-http.
Right. Maybe we need to treat these libraries with a little more respect. I know that you want as little resistance as possible to people generating libraries as their whims desire, but each library has a nonzero maintenance cost. We are spending so much time maintaining this set of libraries now, and yet essentially none of them are usable in the case that 1) the original author wants to use it again and so re-digs through the source code to understand it, 2) someone else wants to dig through the original author's source code, or 3) someone wants to coerce the original author into explaining it to them - in which case the original author reads through source code to reacquaint themselves with the project.
Making consumption of libraries dependent on reading someone else's source code is just naked geek hostility of the highest order. Let's please stop inflicting that violence on our coworkers.
from event-store-client-http.
Yep, I agree completely. It's really a bit of effort that hasn't bubbled up to the highest (pre-empting other work) level of priority yet. That's pretty much what it comes down to in the end: the time to make a document that does the job of explaining how to make a library work (and to not just do it to put a plausible-deniability checkmark next to the work item).
from event-store-client-http.
Related Issues (1)
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from event-store-client-http.