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. 
```
rake aborted!
Albacore::CommandFailedError: Command failed with status (255):
  mono buildsupport/FSharp.Formatting.CommandTool/tools/fsformatting.exe 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"

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""|]


fsformatting metadataFormat --generate [options]
------------------------------------------------

  --help                 Display this message. All options are
                         case-insensitive.
  --waitForKey           Wait for key before exit.
  --dllFiles             Required. DLL input file list.
  --outDir               Required. Ouput Directory.
  --layoutRoots          Required. Search directory list for the Razor Engine.
  --parameters           Property settings for the Razor Engine (optinal).
  --namespaceTemplate    Namespace template file for formatting, defaults to
                         'namespaces.cshtml' (optional).
  --moduleTemplate       Module template file for formatting, defaults to
                         'module.cshtml' (optional).
  --typeTemplate         Type template file for formatting, defaults to
                         'type.cshtml' (optional).
  --xmlFile              Single XML file to use for all DLL files, otherwise
                         using 'file.xml' for each 'file.dll' (optional).
  --sourceRepo           Source repository URL; silently ignored, if source
                         repository folder is not provided (optional).
  --sourceFolder         Source repository folder; silently ignored, if source
                         repository URL is not provided (optional).
  --libDirs              Search directory list for library references.

```