两份文档存在表格结构缺陷:
① docs/en/user_guides/ge_python/api/Shape.md——三张表的分隔行均多出一个空首格(\| \| :--- \| :--- \|,3 格),与表头 2 列失配:
docs/en/user_guides/ge_python/api/Shape.md
\| \| :--- \| :--- \|
GFM 规范要求分隔行列数与表头一致,不一致时整张表不被识别为表格而渲染为普通文本。
② docs/zh/user_guides/dflow/dflow_api/cpp/udf_header_files_and_library_files.md——L17 Tensor类 行仅 3 格,缺第四列(其余各行均为 4 格,末列为 libflow_func.so)。
docs/zh/user_guides/dflow/dflow_api/cpp/udf_header_files_and_library_files.md
libflow_func.so
① 在规范符合的渲染器上三张 API 表整体退化为纯文本;② 该行"动态库"列缺失。
① 三处分隔行删去多余空首格改为 \| :--- \| :--- \|;② L17 补齐第四列 libflow_func.so。
\| :--- \| :--- \|
您好,您提出的问题确实存在,我们将尽快提出pr并关联issue进行修复。
问题背景
两份文档存在表格结构缺陷:
①
docs/en/user_guides/ge_python/api/Shape.md——三张表的分隔行均多出一个空首格(\| \| :--- \| :--- \|,3 格),与表头 2 列失配:GFM 规范要求分隔行列数与表头一致,不一致时整张表不被识别为表格而渲染为普通文本。
②
docs/zh/user_guides/dflow/dflow_api/cpp/udf_header_files_and_library_files.md——L17 Tensor类 行仅 3 格,缺第四列(其余各行均为 4 格,末列为libflow_func.so)。影响分析
① 在规范符合的渲染器上三张 API 表整体退化为纯文本;② 该行"动态库"列缺失。
修改建议
① 三处分隔行删去多余空首格改为
\| :--- \| :--- \|;② L17 补齐第四列libflow_func.so。