try some kotlindoc stuff

README.md

@@ -45,7 +45,7 @@ Shoebox can be added easily to your Maven or Gradle project through Jitpack:
 
 ### Usage Example
 ```kotlin
-fun main(args : Array<String>) {
+fun usersGender(args : Array<String>) {
     val dir = Files.createTempDirectory("sb-")
     val userStore = Shoebox<User>(dir.resolve("users"))
     val usersByEmail = View(Shoebox(dir.resolve("usersByEmail")), userStore, viewBy = User::email)

build.gradle

@@ -61,7 +61,9 @@ dependencies {
 task dokkaJavadoc(type: org.jetbrains.dokka.gradle.DokkaTask) {
     outputFormat = 'html'
     outputDirectory = javadoc.destinationDir
-    inputs.dir 'src/main/kotlin'
+    inputs.dir 'src/usersGender/kotlin'
+    samples = ['com/github/sanity/shoebox/samples']
+    includes = ['packages.md']
 }
 
 task javadocJar(type: Jar, dependsOn: dokkaJavadoc) {

packages.md

@@ -0,0 +1,5 @@
+# Module shoebox
+
+ShoeBox is a [Kotlin](http://kotlinlang.org/) library for object persistence that supports the 
+[observer pattern](https://en.wikipedia.org/wiki/Observer_pattern) so your code can be notified immediately when 
+stored data is changed.

src/main/kotlin/com/github/sanity/shoebox/demos/one/one.kt → src/main/kotlin/com/github/sanity/shoebox/samples/usersGender.kt

@@ -1,4 +1,4 @@
-package com.github.sanity.shoebox.demos.one
+package com.github.sanity.shoebox.samples
 
 import com.github.sanity.shoebox.Shoebox
 import com.github.sanity.shoebox.View
@@ -8,7 +8,11 @@ import java.nio.file.Files
  * Created by ian on 3/9/17.
  */
 
-fun main(args : Array<String>) {
+fun main(args: Array<String>) {
+    usersGender()
+}
+
+fun usersGender() {
     val dir = Files.createTempDirectory("sb-")
     val userStore = Shoebox<User>(dir.resolve("users"))
     val usersByEmail = View(Shoebox(dir.resolve("usersByEmail")), userStore, viewBy = User::email)