贡献指南
========

开发流程
--------

1. 在 ``jaon/`` 中修改源码。
2. 在 ``tests/`` 中添加或更新单元测试。
3. 在 ``examples/`` 中添加示例程序。
4. 更新 ``sphinx-docs/`` 中的文档。
5. 运行测试确保全部通过::

       python -m unittest discover tests

新增语法特性
------------

新增语法通常需要修改以下文件：

1. ``jaon/lexer.py``：添加 Token 类型
2. ``jaon/ast_nodes.py``：添加 AST 节点
3. ``jaon/parser.py``：添加解析规则
4. ``jaon/analyzer.py``：添加类型检查
5. ``jaon/compiler.py``：添加字节码生成
6. ``jaon/vm.py``：添加字节码执行
7. ``tests/``：添加测试
8. ``sphinx-docs/``：更新文档

构建文档
--------

在 ``sphinx-docs/`` 目录下执行::

    make html

生成的 HTML 位于 ``sphinx-docs/_build/html/``。