Deprecated SuiteContext and ConcurrentFormatter

fmt.go

@@ -77,6 +77,9 @@ type Formatter interface {
 
 // ConcurrentFormatter is an interface for a Concurrent
 // version of the Formatter interface.
+//
+// Deprecated: The formatters need to handle concurrency
+// instead of being copied and synchronized for each thread.
 type ConcurrentFormatter interface {
 	Formatter
 	Copy(ConcurrentFormatter)

suite_context.go

@@ -25,6 +25,8 @@ import (
 // need this, rather it is provided for those developing add-on libraries for godog.
 //
 // For an example of how to use, see godog's own `features/` and `suite_test.go`.
+//
+// Deprecated: Use InitializeScenario instead.
 func SuiteContext(s *Suite, additionalContextInitializers ...func(suite *Suite)) {
 	c := &suiteContext{
 		extraCIs: additionalContextInitializers,

suite_context_test.go

@@ -16,6 +16,14 @@ import (
 	"github.com/stretchr/testify/assert"
 )
 
+// InitializeScenario provides steps for godog suite execution and
+// can be used for meta-testing of godog features/steps themselves.
+//
+// Beware, steps or their definitions might change without backward
+// compatibility guarantees. A typical user of the godog library should never
+// need this, rather it is provided for those developing add-on libraries for godog.
+//
+// For an example of how to use, see godog's own `features/` and `suite_test.go`.
 func InitializeScenario(ctx *ScenarioContext) {
 	tc := &godogFeaturesScenario{}