aslak hellesoy wrote:
Fernando P. wrote:
- It is impossible to make the difference between internal
just a mess for non-Rails people to read, and we really have
help other folks.
1) Move a lot of the random stuff from Home to separate pages
massive edits. Instead, I'd love to get input of an outline for
technical).
3) Learn the nomenclature - features, scenarios, steps (step
definitions later). Some style guidlines.
Totally agree. This is the “shoehorn” I was looking for - partly. Having
YOU write it would be far far better than anyone else, because of your
knowledge and communication skills. People like me can best serve by
giving feedback, as the writing proceeds.
4) What does a Cucumber feature look like (plain - no outlines or
tables). Learn how to write one in a simple text editor.
Absolutely.
5) How to install and run Cucumber (using the one from 3
you mean “4”?
as example. No Rake yet - just the cucumber command)
Yeah. Keep it minimal, but something that will actually run and produce
results to study. Which leads us to…
6) What does the output from Cucumber mean? (Learn to read the
deafault console output. Colours and error messages. Mention other
formatters)
yes yes yes
7) Learn to write step definitions (they are similar to defining
methods in most imperative languages like Ruby, Java, C, Pascal…).
Mention Regexps, Rubular.com.
Would be very very helpful.
8) How to implement the body of a step definition. Learn about RSpec’s
#should and #should_not - and matchers
Man, could I use this. Things go really dark for me at this point. Just
haven’t gotten there yet.
9) How to fix a failing (red) step definition by writing some code (in
lib for now since we’re not doing any Rails)
Yes. Especially the part about excluding Rails. And this, to me looks
like the end of the beginning. What follows is very helpful, but by this
point the boat is launched. I DO dearly want the rest of what you’ve
written, however, so don’t drop anything from the outline, if you have
the time to carry through to the end.
10) Mention DTSTTCPW and refactoring - with some external links. TDD
basics.
11) Learn how to use Rake (useful when you have more than one feature
file). Mention RCov.
Nos. 10-11 look especially interesting to me.
12) Learn about the various command-line switches
13) Learn about more advanced Gherkin (Cucumber language) features
such as Tables, PyString, Scenario Outlines and Background (coming soon)
I’m not sure, but I’m thinking that Tables and Scenario Outlines (to the
extent that I understand them) might well come earlier in the outline.
On the other hand, those of us who want to could simple skip ahead to
grab the material when we need it.
14) Learn about hooks (Before, After etc)
15) Various other features (CUCUMBER_COLORS, AutoTest, cucumber.yml
(profiles)
From here on, I think we’re into the “and it’d be nice if we had
something about…” territory. Dessert.
16) IDE support
Interesting. I work exclusively with the CLI, and love it. Used to work
with IDEs, but converted.
17) How to use other assertion tools like Test::Unit, Shoulda, etc.
18) How to use Cukes with non-Ruby platforms (Watir family, JRuby,
IronRuby, FunFX/Flex)
Terrific outline, I’d say. I cannot imagine not getting what I want,
from this material. It’ll suck people like me into the process, and when
we get into trouble we can shout out, which will lead to possible
additions (but I don’t think they’ll be major).
I’ll stay glued to me email inbox (and the wiki) to watch this develop.
This is a gift I simply didn’t expect, and especially not right when I
most need it.
This is going to be very very helpful, and to an increasing number of
people, I’ll predict.
I’m excited about this development. Thanks so much.
Tom
The reader will gradually learn about the recommended file layout
structure.
Maybe this is more like a 10-15 minute intro. I’ll try to keep it as
short as possible without skipping important concepts.
What’s missing? What’s in the wrong order? What should I remove?
Aslak
–
Tom C., MS MA, LMHC - Private practice Psychotherapist
Bellingham, Washington, U.S.A: (360) 920-1226
<< [email protected] >> (email)
<< TomCloyd.com >> (website)
<< sleightmind.wordpress.com >> (mental health weblog)