Stream: git-wasmtime

Topic: wasmtime / issue #4135 Cranelift: modernize documentation

Wasmtime GitHub notifications bot (May 11 2022 at 00:08):

cfallin opened issue #4135:

We should update our documentation in cranelift/docs at least in the following ways:

• We should make a pass to ensure that outdated concepts related to the old backend framework, like encodings and recipes, are removed;
• We should fill out documentation about the new backend framework's architecture, beyond the doc-comments in the source (but likely borrowing from them);
• We should provide more "purpose-directed guides":
  • How to add a new backend (#4126);
  • How to add a new instruction to CLIF;
  • How to add a new instruction to a machine backend;
  • How to add a new lowering from CLIF to a machine backend;
  • Strategies to debug codegen issues (minimization, diffing output, using "optimization fuel" (#4134)).

Wasmtime GitHub notifications bot (May 11 2022 at 00:08):

cfallin labeled issue #4135:

We should update our documentation in cranelift/docs at least in the following ways:

• We should make a pass to ensure that outdated concepts related to the old backend framework, like encodings and recipes, are removed;
• We should fill out documentation about the new backend framework's architecture, beyond the doc-comments in the source (but likely borrowing from them);
• We should provide more "purpose-directed guides":
  • How to add a new backend (#4126);
  • How to add a new instruction to CLIF;
  • How to add a new instruction to a machine backend;
  • How to add a new lowering from CLIF to a machine backend;
  • Strategies to debug codegen issues (minimization, diffing output, using "optimization fuel" (#4134)).

Wasmtime GitHub notifications bot (May 11 2022 at 00:08):

cfallin labeled issue #4135:

We should update our documentation in cranelift/docs at least in the following ways:

• We should make a pass to ensure that outdated concepts related to the old backend framework, like encodings and recipes, are removed;
• We should fill out documentation about the new backend framework's architecture, beyond the doc-comments in the source (but likely borrowing from them);
• We should provide more "purpose-directed guides":
  • How to add a new backend (#4126);
  • How to add a new instruction to CLIF;
  • How to add a new instruction to a machine backend;
  • How to add a new lowering from CLIF to a machine backend;
  • Strategies to debug codegen issues (minimization, diffing output, using "optimization fuel" (#4134)).

Wasmtime GitHub notifications bot (May 11 2022 at 00:08):

cfallin labeled issue #4135:

We should update our documentation in cranelift/docs at least in the following ways:

• We should make a pass to ensure that outdated concepts related to the old backend framework, like encodings and recipes, are removed;
• We should fill out documentation about the new backend framework's architecture, beyond the doc-comments in the source (but likely borrowing from them);
• We should provide more "purpose-directed guides":
  • How to add a new backend (#4126);
  • How to add a new instruction to CLIF;
  • How to add a new instruction to a machine backend;
  • How to add a new lowering from CLIF to a machine backend;
  • Strategies to debug codegen issues (minimization, diffing output, using "optimization fuel" (#4134)).

Last updated: Nov 22 2024 at 16:03 UTC