~ $ cd craft/the-post-is-the-test && cat README.md

A sentence is a step.
The post is the test.

A behaviour test written in plain sentences needs, for every sentence, a piece of code that knows what to do with it, and the usual way to find that piece is a regular expression written to match the sentence. That is where my students got stuck: on the expressions, and on naming the functions behind the steps.

So the course's platform stopped matching sentences, and read them instead. Every word goes into the name of a method; a quoted string becomes an argument and an S in the name, a number an argument and an N. There is nothing to match, because the sentence is the name. The post is the test, and each of its sentences a step: write one, a step a line, and see what it becomes:

* Go to the blog section,
* You should see a list of posts,
* The last post title should be "Hello Blog", this post

The test, for the server

@Test
public void post() {
  context.goToTheBlogSection();                             // Go to the blog section,
  context.youShouldSeeAListOfPosts();                       // You should see a list of posts,
  context.theLastPostTitleShouldBeSThisPost("Hello Blog");  // The last post title should be "Hello Blog", this post
}

The test, for the client

test("post", () => {
  context.goToTheBlogSection();                             // Go to the blog section,
  context.youShouldSeeAListOfPosts();                       // You should see a list of posts,
  context.theLastPostTitleShouldBeSThisPost("Hello Blog");  // The last post title should be "Hello Blog", this post
});

What is left to write, in Java

public void goToTheBlogSection() {
  // to write
}

public void youShouldSeeAListOfPosts() {
  // to write
}

public void theLastPostTitleShouldBeSThisPost(String expected) {
  // to write
}

And in JavaScript

goToTheBlogSection() {
  // to write
}

youShouldSeeAListOfPosts() {
  // to write
}

theLastPostTitleShouldBeSThisPost(expected) {
  // to write
}

The test is the same for the server and for the client, one call a step, with the step's sentence beside it — so a line that fails says, in the student's own words, what did not happen. What is left to write are the methods at the bottom, and writing them is the work. The rest of that course is in the post comes first.

Where it went