User docs reference internal FB Workplace instance

[knorrium]

The following links are inaccessible to external users, could the talks and CLI examples please be posted elsewhere?

https://github.com/facebookexperimental/hermit/blob/95b3ac7be2c464fc7be595c8548f4dd11167600b/docs/Users.md?plain=1#L30-L33

[jasonwhite]

Great suggestion. We'll try to publish those things soon. There shouldn't be any legal reasons not to.

[rrnewton]

Also, as part of porting more documentation to be external, we need to figure out some way to get this plantuml stuff to work, as well as generally fleshing out the bit of documentation that has currently been externalized under that docs/ directory.

For example, the Architecture.md file should render like this:

Update: Looks like there is some advice for combining plantuml and github markdown in this Gist.

[sanmai-NL]

Publishing an mdBook would allow for rich documentation with good UX.