Migrate architecture documents to artifact

[vitiral]

Fixes #149

This is currently a POC (and thus only ports Phase1)

[vitiral]

Here is what the design docs would look like: ARCHITECTURE-NEW.md.

[vitiral]

Notice the .compile, etc links -- they go directly to source code, both tracking the "progress" of architecture completion as well as helping folks find the links when viewing the architecture docs.

Example

The main entry point is .compile, but the machinery is really in the default compiler,
the .clif_compiler.

[xmclark]

@vitiral thanks for submitting this. The team will be reviewing/evaluating artifact tool sometime this week.

[vitiral]

@xmclark ping

[xmclark]

Hi @vitiral. We've been pretty busy, so the evaluation has been delayed a bit. I installed the art tool on windows, and am trying to run basic commands. I'm on windows 10, and I installed art with scoop. I can't get many of them to execute correctly.

C:\Users\macke\dev\wasmer>art ls
Encountered Error:

unknown field `code_url`, expected one of `artifact_paths`, `exclude_artifact_paths`, `code_paths`, `exclude_code_paths`

C:\Users\macke\dev\wasmer>art serve
Encountered Error:

unknown field `code_url`, expected one of `artifact_paths`, `exclude_artifact_paths`, `code_paths`, `exclude_code_paths`

[vitiral]

Hey xmclark, windows support has some known bugs. Let me fix them and get back to you.

[syrusakbary]

Closing the PR as it has become stale.

I will be happy to research more on how we can use artifact for our docs @vitiral. Send me an email to syrus@wasmer.io and we can follow the conversation there :)