minkphp / docs

Mink documentation
https://mink.behat.org
83 stars 44 forks source link

Add a getting starting chapter #38

Open stof opened 9 years ago

stof commented 9 years ago

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)

jmauerhan commented 8 years ago

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.

stof commented 8 years ago

@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)

jmauerhan commented 8 years ago

@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.

stof commented 8 years ago

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:

jmauerhan commented 8 years ago

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.