Valibot 文档优化：数字与小数验证的清晰指南

Valibot 作为一个优秀的数据验证库，其文档质量直接影响开发者体验。近期社区反馈指出，关于数字验证（digits）和小数验证（decimal）的文档存在改进空间，特别是对允许符号的说明不够直观。

数字验证（digits）的核心要点

数字验证通常用于确保输入值仅包含数字字符。在 Valibot 的实现中，digits 验证器应该明确说明：

1. 仅接受 0-9 的数字字符
2. 不接受任何其他符号（包括正负号、小数点等）
3. 典型的应用场景包括验证电话号码、纯数字ID等

小数验证（decimal）的关键细节

小数验证比纯数字验证更复杂，需要明确界定：

1. 允许的符号：正负号（+/-）
2. 小数点的处理：通常允许单个小数点
3. 科学计数法的支持情况（如是否允许1.23e4这样的表示）
4. 千分位分隔符的处理（如是否允许1,000.00这样的格式）

文档改进建议

优秀的验证库文档应该：

1. 提供简洁明了的符号说明表
2. 给出典型示例和边界案例
3. 说明与相关验证器的区别（如digits与number的区别）
4. 包含常见使用场景的代码示例

通过这样的文档改进，开发者能够更快理解验证规则，减少查阅外部参考的需要，提升开发效率。Valibot 团队已经响应社区反馈进行了优化，这体现了开源项目重视用户体验的良好态度。