Add initial documentation for C tooling

[seanisom]

Fixes #38

Creating as a draft for now as I would like to see #44 merged first as that will change the structure of /language-support - I will update the table of contents to match that once I can rebase from that.

[kate-goldenring]

Thanks @seanisom! I was able to get this all working and running on the example host! There were a few parts where i deviated from the flow and a little bit more information we can add

[kate-goldenring]

The adapter may have evolved in Wasmtime 13 as I am able to successfully create a component when adding print and the adapter automatically imports the wasi worlds

[kate-goldenring]

My output does not have any of the WASI imports:

package root:component

world root {
  export add: func(x: s32, y: s32) -> s32
}

however, if i add print (necessitating the wasi cli imports) then my output matches

[sunfishcode]

@seanisom It looks like #44 is merged now; are you able to continue working on this? In any case, would you like help finishing finishing this PR? There's good content here that would be great to have published; let me know if there's anything I can do to help!

[seanisom]

Hey @sunfishcode @kate-goldenring , sorry for letting this go stale! Will rebase on top of the latest post #44 and incorporate the feedback.

Regarding host component support for C in wasmtime, I need to follow up on bytecodealliance/wasmtime#6987 - Bailey mentioned Alex may have already started this work. If that is complete or a significant uplift I can address that in a follow-up PR.

[rylev]

@seanisom @kate-goldenring what's the state of this PR - is this blocked on anything in particular?

[breckcs]

If this PR is going to be merged, don't forget to update the links on the landing page in introduction.md.

Go wasn't included there and at first I thought support for Go didn't exist. See: #128.

[rajsite]

I think it would be great to start getting some docs in for C development that can grow over time. There really doesn't seem to be a good source generally (compared to other languages which have detailed docs elsewhere) and in the time this has been in review it's gotten outdated:

• target names have changed in wasi-sdk
• wasi-sdk has a dedicated p2 target
• changes have been made to the wasi targets such that folks have expected workflows that don't seem well documented (it's expected users know to strip debug symbols that are always included now).

Those kind of updates would be easier to make in small PRs if the C docs became available.

[kate-goldenring]

@rajsite would you be willing to take on updating the docs? You could also open a new PR with the content and @seanisom could potentially jump in to review it

[rajsite]

@rajsite would you be willing to take on updating the docs? You could also open a new PR with the content and @seanisom could potentially jump in to review it

Created a PR that I believe should resolve the remaining discussion from this thread and merges from main: #147