Enhance documentation

- upgraded mkdocs and dependencise (+ add mermaid)
- linted markdown
- add more details

doc/docs/packages/parser.md

@@ -8,10 +8,10 @@ import "katenary/parser"
 
 Parser package is a wrapper around compose\-go to parse compose files.
 
-## func [Parse](<https://github.com/metal3d/katenary/blob/develop/parser/main.go#L25>)
+## func [Parse](<https://github.com/metal3d/katenary/blob/develop/parser/main.go#L29>)
 
 ```go
-func Parse(profiles []string, dockerComposeFile ...string) (*types.Project, error)
+func Parse(profiles []string, envFiles []string, dockerComposeFile ...string) (*types.Project, error)
 ```
 
 Parse compose files and return a project. The project is parsed with dotenv, osenv and profiles.