Merge pull request #4 from IBM/cleue-getting-started-docs

doc: some docs

samples/README.md

@@ -0,0 +1,10 @@
+# Samples
+
+This folder is meant to contain examples that illustrate how to use the library. I recommend the following reading to get an idea of the underlying concepts. These articles talk about [fp-ts](https://github.com/gcanti/fp-ts) but the concepts are very similar, only syntax differs.
+
+### References
+
+- [Ryan's Blog](https://rlee.dev/practical-guide-to-fp-ts-part-1) - practical introduction into FP concepts
+- [Investigate Functional Programming Concepts in Go](https://betterprogramming.pub/investigate-functional-programming-concepts-in-go-1dada09bc913) - discussion around FP concepts in golang
+- [Investigating the I/O Monad in Go](https://medium.com/better-programming/investigating-the-i-o-monad-in-go-3c0fabbb4b3d) - a closer look at I/O monads in golang
+- 

samples/doc.go

@@ -0,0 +1,2 @@
+// Package sample contains examples that illustrate how to use fp-go
+package samples

samples/readfile/readfile_test.go

@@ -17,6 +17,8 @@ type RecordType struct {
 	Data string `json:"data"`
 }
 
+// TestReadSingleFile reads the content of a file from disk and parses it into
+// a struct
 func TestReadSingleFile(t *testing.T) {
 
 	data := F.Pipe2(