docs
docs copied to clipboard
Add a getting starting chapter
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)
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 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 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.
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
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.