update installation details in readme

README.md

@@ -11,18 +11,21 @@ The project is inspired by [behat][behat] and [cucumber][cucumber] and is based
 
 ### Install
 
-    go install github.com/DATA-DOG/godog/cmd/godog
+    go get github.com/DATA-DOG/godog/cmd/godog
-
-### Be aware that
-
-The work is still in progress and is not functional yet, neither it is intended for production usage.
-The general public API may brake.
 
 ### Documentation
 
-See [godoc][godoc] and [gherkin godoc][godoc_gherkin].
+See [godoc][godoc] and [gherkin godoc][godoc_gherkin] for general API details.
 See **.travis.yml** for supported **go** versions.
 
+The public API is stable enough, but it may break until **1.0.0** version, see `godog --version`.
+
+### Contributions
+
+Feel free to open a pull request. Note, if you wish to contribute an extension to public (exported methods or types) -
+please open an issue before to discuss whether these changes can be accepted. All backward incompatible changes are
+and will be treated cautiously.
+
 ### License
 
 All package dependencies are **MIT** or **BSD** licensed.

example/README.md

@@ -2,6 +2,6 @@
 
 In order to test our **ls** feature with **Godog**, run:
 
-    go install github.com/DATA-DOG/godog/cmd/godog
+    go get github.com/DATA-DOG/godog/cmd/godog
     $GOPATH/bin/godog ls.feature
 

gherkin/README.md

@@ -8,17 +8,16 @@ specification. It parses a feature file into the it's structural representation.
 creates an AST tree of gherkin Tokens read from the file.
 
 With gherkin language you can describe your application behavior as features in
-human-readable and machine friendly language. See the example directory.
+human-readable and machine friendly language.
-
-### Be aware that
-
-The work is still in progress and is not functional yet, neither it is intended for production usage.
-The general public API may brake.
 
 ### Documentation
 
 See [godoc][godoc].
 
+The public API is stable enough, but it may break until **1.0.0** version, see `godog --version`.
+
+Has no external dependencies.
+
 ### License
 
 Licensed under the [three clause BSD license][license]