合规做法是用标记时间，每条更新包裹在独立中，置于主内容末尾、版权前，并用和更新日志结构化。
HTML里怎么加更新日志？直接用<time></time>和语义化段落
HTML本身没有<changelog></changelog>这种标签，也不该用<div class="changelog">硬套。真正合规又实用的做法，是用<code><time></time>标记时间点，配合<section></section>或<article></article>组织条目，让更新记录既可读、又可被机器识别（比如爬虫、屏幕阅读器）。
常见错误是把日志塞进<pre class="brush:php;toolbar:false;"></pre>或一堆<p></p>堆砌——看着整齐，但丢失了“哪条是哪天改的”这个关键信息，也难做自动化提取。
-
<time datetime="2024-05-20">2024年5月20日</time>必须带datetime属性，格式为YYYY-MM-DD（ISO 8601），否则无法被正确解析 - 每条更新建议包在
<article></article>里，比<section></section>更贴合“独立可分发的更新项”语义 - 避免用
<ul></ul>或<ol></ol>——列表暗示顺序/层级，而更新日志的核心是时间+动作，不是步骤
更新日志放在HTML哪个位置最合适？
不推荐塞在里（不可见）、也不建议丢到页脚最底部（用户很难主动翻到底）。最佳实践是放在主内容区末尾、版权信息之前，用<section aria-labelledby="changelog-title"></section>包裹，并配一个<h2 id="changelog-title">更新日志</h2>。
这样既保证视觉可见性，又通过aria-labelledby让辅助技术能准确定位——比单纯靠id更可靠。
- 如果页面是文档型（如API参考），可把更新日志放在每个章节下方，用
<aside></aside>标注“本节更新” - 别用
display: none或visibility: hidden隐藏日志——搜索引擎和无障碍工具会跳过，等于白写 - 动态生成的页面（如Jekyll、Hugo），优先用模板变量注入
datetime值，避免手填出错
怎么让更新日志支持机器读取和自动聚合？
关键在<time></time>的datetime属性和结构一致性。只要每条记录都含有效datetime，外部工具（比如CI脚本、RSS生成器）就能用CSS选择器article time[datetime]精准提取时间戳和对应内容。
容易被忽略的是：更新描述文本不能全靠<time></time>后紧接文字来隐式关联——得用明确的容器隔离。否则XPath或JS查询时容易错位。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 每条更新必须有独立
<article></article>，禁止多个<time></time>挤在一个<article></article>里 - 描述文字建议用
<p></p>包裹，不要裸文本；若含链接（如“修复#123”），链接需在<p></p>内，而非游离在外 - 避免使用
datetime值为2024-05-20T14:30:00Z这种带时分秒的格式——除非真需要精确到分钟，否则纯日期更稳定、更易比对
要不要加版本号？怎么加才不破坏语义？
可以加，但别用<h3>v2.1.0</h3>这种标题式写法——它会让结构变成“日志→子标题→内容”，语义混乱。正确方式是把版本号作为<time></time>的title属性值，或放在<time></time>标签内作为补充说明。
例如：<time datetime="2024-05-20" title="v2.1.0">2024年5月20日（v2.1.0）</time>。这样既保留人类可读，又不干扰机器解析主时间。
- 版本号不应替代时间戳，两者是互补关系：时间表示“什么时候改的”，版本表示“改到了哪个发布节点”
- 如果项目用语义化版本（SemVer），建议把
title设为完整版本字符串，方便后续正则提取 - 千万别把版本号写成
<data value="v2.1.0"></data>——<data></data>需要value为机器值，但这里版本号本身已是文本，冗余且无益
datetime属性的格式校验和<article></article>的严格单条封装——这两点一错，整个日志就从“可用”退化成“看起来像日志”。
