draft solution -- for review only -- do not merge!

@haf while this is not valid Ruby (which I do not master), this will hopefully allow you to get the ideas of the proposed solution. Your comments are appreciated. 
```
could not parse [|"metadataFormat"; "--generate"; "--dllFiles"; "Suave/bin/Release"; "--outDir";
  "gh-pages/api"; "--layoutRoots"; "gh-pages/_fs_formatting"; "--sourceRepo";
  "https://github.com/SuaveIO/suave/tree/master/Suave"; "--sourceFolder";
  "Suave"; "--parameter"; "page-description"; "F# Suave"; "page-author";
  "Ademar Gonzalez, Henrik Feldt"; "project-author";
  "Ademar Gonzalez, Henrik Feldt"; "github-link";
  "https://github.com/SuaveIO/suave"; "project-github";
  "https://github.com/SuaveIO/suave"; "project-nuget";
  "https://www.nuget.org/packages/Suave"; "root"; "http://suave.io";
  "project-name"; "Suave"|]
```