From the docs: features/bootstrap/FeatureContext.php is for testing the Drupal Extension itself

[amitaibu]

So where should my FeatureContext.php exist? And how should I add it (i guess through context in behat.yml -- but an example with namespaces would be appreciated)

[jhedstrom]

That comment is quite confusing. The intent there is to refer to the one that comes with the Drupal Extension itself--features/bootstrap/FeatureContext.php is still the preferred place for custom contexts.

In most examples I've read, custom contexts are not namespaced.

We're about to do a docs cleanup, so I'll make sure that is clarified.

[amitaibu]

features/bootstrap/FeatureContext.php is still the preferred place for custom contexts.

And for Behat to pick this file up -- should I add something in behat.yml's context - cause it seems it is ignored.

[jhedstrom]

Yes, unlike in Behat 2, the FeatureContext (or WhateverContext) must be specified in each suite:

default:
  suites:
    default:
      contexts:
        - Drupal\DrupalExtension\Context\DrupalContext
        - FeatureContext
        - WhateverContext

[amitaibu]

I think it's worth adding in the README .. :)

[eliza411]

I think I've added what was requested. If not, please reopen with concrete suggestions! Thanks for taking time to help improve this.