Skip to content

LSR-001.md

Latest commit

 

History

History
126 lines (83 loc) · 3.25 KB

LSR-001.md

File metadata and controls

126 lines (83 loc) · 3.25 KB

LSR 001 - LSR的目的和准则

基本信息

  • LSR 编号 001
  • 标题 LSR的目的和准则
  • 作者 Ziyang-Bai, Ange1PLSGreet, CGrakeski
  • 状态 草案
  • 类型 流程类
  • 创建日期 08-06-2025
  • Lamina 版本 全部

什么是LSR

LSR是Lamina Standard Recommendation（Lamina标准建议）的缩写，是描述Lamina编程语言新特性、流程和环境的设计文档。LSR应当为特性提供简洁的技术规范并描述特性的基本原理。

LSR的目的

LSR的主要目的是：

  1. 标准化流程 - 为Lamina的新特性提供标准化的提案和讨论机制
  2. 社区参与 - 让社区成员参与语言发展讨论
  3. 质量保证 - 确保新特性经过充分讨论和审查

LSR的类型

LSR分为3种类型：

标准规范

  • 描述语法、语义、标准库等
  • 描述Lamina的新特性或实现

信息类

  • 描述Lamina设计问题或向社区提供一般指导（可以是非强制性的）
  • 不提出新特性

流程类

  • 描述与Lamina相关的流程
  • 提出流程的改变（LSR流程本身、发布流程、治理模型）

LSR格式和模板

每个LSR必须包含以下部分：

LSR XXX - 标题

基本信息

  • 标题 简洁的描述性标题（标题可以是“Lamina的……功能”而非“Lamina应当有……功能”
  • 作者 作者的Github用户名，若有多个则用逗号隔开
  • 状态 草案|接受|撤回|拒绝
  • 类型 标准规范|信息类|流程类
  • 创建日期 MM-DD-YYYY
  • Lamina 版本 适用版本

摘要

简洁描述提案的核心内容 (200字以内)

技术规范 (标准规范类必需)

详细的技术描述

基本原理 (可选)

参考实现 (如适用)

LSR生命周期

状态流程

草案 ──────────── 接受 
 │         │
撤回      拒绝

状态定义

  • 草案 初始提案，开放讨论
  • 接受 通过审查，进入实施
  • 撤回 作者主动撤回
  • 拒绝 被维护者拒绝

LSR编号规则

  • 使用3位数字编号：001、002、003……等等。数字编号并不一定按照顺序分配，理论上，每个LSR可以任意选取编号，只要保证不重复。
  • 编号一旦分配不可重用
  • LSR-001 保留给本文档

提交流程

  1. 讨论 在issue中初步讨论
  2. 草案 创建LSR草案文档
  3. Pull Request 提交到仓库
  4. 社区审查 收集反馈与建议
  5. 修订 根据反馈进行修改
  6. 决定 维护者做出决定
  7. 实施 实现特性
  8. 接受 标记为接受状态

LSR维护者责任

  • 审查LSR质量和格式
  • 协调社区讨论
  • 做出接受/拒绝决定
  • 维护LSR索引
  • 确保实施质量

质量标准

LSR应该：

  • 清晰简洁 技术描述准确，语言简练
  • 完整性 包含所有必需部分
  • 可实施性 标准规范类应可实际实现
  • 兼容性 考虑向后兼容性影响
  • 测试用例 提供充分的测试用例

结语

LSR机制旨在确保Lamina语言的有序发展，平衡创新与稳定性。每个LSR都应该经过充分讨论，确保对Lamina生态系统的积极贡献。