Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions beps/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,12 @@ Below is an auto-generated index of all BEPs.
<tr>
<td><a href="./proposals/BEP-007-mir/"><strong>BEP-007</strong>: Mid-level Intermediate Representation (MIR)</a> &nbsp; <img src="https://img.shields.io/badge/Status-Draft-lightgrey" alt="Draft"><br><br>This proposal introduces a Mid-level Intermediate Representation (MIR) between THIR and bytecode generation in the BAML compiler pipeline. MIR is a Control Flow Graph (CFG) based representation that simplifies the compilation of complex control flow constructs like `match` statements and error handling (`catch` expressions). By lowering high-level constructs into basic blocks connected by explicit jumps, MIR bridges the semantic gap between the tree-structured THIR and the linear bytecode, making codegen simpler, more maintainable, and easier to extend with new language features.<br><br><span style='font-size:0.8em; color:gray'>Shepherd(s): Antonio Sarosi <sarosiantonio@gmail.com></span></td>
</tr>
<tr>
<td><a href="./proposals/BEP-008-function-and-lambda-syntax-design/"><strong>BEP-008</strong>: Function and Lambda Syntax Design</a> &nbsp; <img src="https://img.shields.io/badge/Status-Draft-lightgrey" alt="Draft"><br><br><br><br><span style='font-size:0.8em; color:gray'>Shepherd(s): Language Design Team</span></td>
</tr>
<tr>
<td><a href="./proposals/BEP-009-function-and-lambda-syntax-design-ts-aligned/"><strong>BEP-009</strong>: Function and Lambda Syntax Design (TS-aligned)</a> &nbsp; <img src="https://img.shields.io/badge/Status-Proposed-yellow" alt="Proposed"><br><br><br><br><span style='font-size:0.8em; color:gray'>Shepherd(s): Language Design Team</span></td>
</tr>
Comment on lines +43 to +48
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick | 🔵 Trivial

Add descriptions for BEP-008 and BEP-009.

Both new BEP entries have empty descriptions (showing only <br><br> placeholders), while several other BEPs in the table include helpful summary text. For two competing proposals on function/lambda syntax, descriptions would help readers quickly understand the key differences:

  • BEP-008: Could note "Proposes unified -> syntax for declarations, lambdas, and types"
  • BEP-009: Could note "Proposes TypeScript-aligned : for declarations and => for lambdas/types"

Since the table header indicates this is auto-generated (line 7: "Do not edit the table below by hand"), you may need to either:

  1. Add description metadata to the BEP README frontmatter or content
  2. Update the generation script to extract summaries
  3. Manually add descriptions if auto-generation isn't fully implemented yet

</tbody>
</table>

Expand Down
Loading
Loading