Ruby类方法的文档与注释：使用`.`还是`::`更合适？

在Ruby中，.和::均可用于调用类方法。根据我的经验，.的使用更为普遍，因此我习惯在文档及RSpec的describe/context/expect字符串中采用该形式。但Ruby官方API文档却使用::，这是否意味着在上述场景中更推荐使用::？

注：此问题并非《Ruby中调用类方法时.和::有区别吗？》的重复问题，后者讨论的是Ruby源码中的使用场景，而本文聚焦于**文档及文本描述（如RSpec字符串）**中的使用选择。

在代码与文档中可能存在不同选择的原因，例如在代码中.更清晰地表示消息调用而非常量访问，而在文档中::可能更便于区分类方法与实例方法。

内容的提问来源于stack exchange，提问作者Keith Bennett