Update binding contribution instructions

Author: jonas

build.sbt

@@ -224,14 +224,16 @@ lazy val libiconv = bindingProject("iconv")
     }
   )
 
-//#sbt-binding-project
+//#sbt-binding-project-multi-header
 lazy val libposix = bindingProject("posix")
   .configure(binding("fnmatch.h"))
   .configure(binding("regex.h"))
-//#sbt-binding-project
+//#sbt-binding-project-multi-header
 
+//#sbt-binding-project
 lazy val libutf8proc = bindingProject("utf8proc")
   .configure(binding("utf8proc.h", Some("utf8proc")))
+//#sbt-binding-project
 
 def project(name: String, plugged: AutoPlugin*) = {
   val unplugged = Seq(ScriptedPlugin).filterNot(plugged.toSet)

docs/src/paradox/bindings/index.md

@@ -2,6 +2,8 @@
 
 The following bindings have been generated with bindgen.
 
+If you would like to contribute a binding see the @ref:[Contributing Bindings] page.
+
 @@ toc { depth=1 }
 
 @@@ index
@@ -10,4 +12,6 @@ The following bindings have been generated with bindgen.
 * [iconv](iconv.md)
 * [utf8proc](utf8proc.md)
 
-@@@
+@@@
+
+ [Contributing Bindings]: ../contrib/bindings.md

docs/src/paradox/contrib/bindings.md

@@ -2,10 +2,14 @@
 
 ## Adding a new Bindings
 
-To add a new binding add a new project in `build.sbt` with the name of the artifact as well as a binding configuration for each header file and optionally the library to link with. The following example shows how it is possible to generate multiple bindings per project. For most libraries a single binding should be sufficient.
+To add a new binding, add a new project in `build.sbt` with the name of the artifact as well as a binding configuration for each header file and optionally the library to link with.
 
 @@snip [build.sbt](../../../../build.sbt) { #sbt-binding-project }
 
+It is also possible to generate multiple bindings per project. For most libraries a single binding should be sufficient.
+
+@@snip [build.sbt](../../../../build.sbt) { #sbt-binding-project-multi-header }
+
 The new sbt project should also be added to the `bindings` project's list of aggregated projects.
 
 Optionally update the top-level `Dockerfile` to install the binding library's `-dev` package. 
@@ -22,16 +26,16 @@ Next, run `nativeBindgen` to generate the bindings. Note, to ensure consistency
 This can be done by running:
 
 ```sh
-docker-compose run --rm ubuntu-18.04-llvm-6.0 sbt bindings/$BINDING/nativeBindgen
+docker-compose run --rm ubuntu-18.04-llvm-6.0 sbt lib$BINDING/nativeBindgen
 ```
 
 Then write tests for the generated bindings. The test class should be in the `org.scalanative.bindgen.bindings.tests` package to make it easier to write examples for the binding documentation. Verify that the tests pass:
 
 ```sh
-docker-compose run --rm ubuntu-18.04-llvm-6.0 sbt bindings/$BINDING/test
+docker-compose run --rm ubuntu-18.04-llvm-6.0 sbt lib$BINDING/test
 ```
 
-Finally, add a page in the `bindings` folder and document the binding, ideally with an example or two of how to use it.
+Finally, add a Markdown file in the `bindings` folder and document the binding, ideally with an example or two of how to use it. Remember to add the new file to the index in `bindings/index.md`.
 
 ## Update all Bindings