Update: add javadoc, fix some ref error

2026-08-13 22:13:27 +08:00 · 2023-10-15 13:25:06 +08:00
parent cc999a4092
commit 5c80da5487
4 changed files with 12 additions and 12 deletions
--- a/google-python-styleguide/python_language_rules.rst
+++ b/google-python-styleguide/python_language_rules.rst
@@ -664,7 +664,7 @@ True/False的求值
    
    避免装饰器自身对外界的依赖(即不要依赖于文件, 套接字, 数据库连接等), 因为执行装饰器时(即导入模块时. ``pydoc`` 和其他工具也会导入你的模块) 可能无法连接到这些环境. 只要装饰器的调用参数正确, 装饰器应该 (尽最大努力) 保证运行成功.
    
-    装饰器是一种特殊形式的"顶级代码". 参见关于 :ref:`Main <main>` 的章节.
+    装饰器是一种特殊形式的"顶级代码". 参见关于《Python风格规范》中“主程序”的章节.

    不得使用 ``staticmethod``, 除非为了兼容老代码库的 API 不得已而为之. 应该把静态方法改写为模块级函数.