docs icon indicating copy to clipboard operation
docs copied to clipboard

Add a getting starting chapter

Open stof opened this issue 10 years ago • 5 comments

This chapter should show a working example using the Session and manipulating a page.

I suggest to use GoutteDriver to setup the Session in this example because it is the easier to setup (no mandatory constructor argument, no external steps to prepare the driver)

stof avatar Jan 07 '15 01:01 stof

This example should probably include that GoutteDriver no longer comes with Mink - After switching from Behat 2.5 to 3 on a new project it took me a while to figure out that the example on Mink's docs required yet another library that wasn't specified anywhere.

jmauerhan avatar Mar 02 '16 21:03 jmauerhan

@jmauerhan drivers have been extracted from Mink itself 4 years ago (in the Mink 1.4 release). So there is no point adding such upgrade mention in a doc written today. If you upgrade from a totally outdated version to an uptodate version, you should better read the changelog (and this is unrelated to the Behat version btw. Mink 1.7 can be used with Behat 2.5 too)

stof avatar Mar 03 '16 09:03 stof

@stof I'm sorry, I probably phrased it a little confusingly. What I meant was I had previously used Behat 2.5 and at the time I started learning it, it came with some drivers, maybe not Goutte. I approached setting up a new project using Behat and Mink from a clean slate, not upgrading.

Anyway, I found where on the main page of the docs it lists the different drivers with their package names - I think I just missed it the first time I read the page.

jmauerhan avatar Mar 03 '16 16:03 jmauerhan

What I meant was I had previously used Behat 2.5 and at the time I started learning it, it came with some drivers, maybe not Goutte.

That's not true:

  • Mink 1.4 was released 1 year before Behat 2.5. So you had drivers included automatically in your project only when using a version of Mink which was already unmaintained at that that (as it meant you were using Mink 1.3 or older)
  • behat 2.5 never came with Mink itself anyway. You always had to install Mink additionally, so the Behat version is unrelated

stof avatar Mar 03 '16 16:03 stof

shrug doesn't matter :) It was like 3 years ago that I started so probably remember it wrong. Could have been even older versions, who knows.

That wasn't exactly the point, and I clarified that I had found the section I was suggesting be added.

jmauerhan avatar Mar 03 '16 16:03 jmauerhan