Beyond "Clean Code": Why Your Comments Matter2 months agohttps://blog.moertel.com/posts/2026-07-27-beyond-clean-code-why-your-comments-ma...注释是必要的,用于表达意图和'为什么'的信息,这些是逻辑本身无法传达的。Bob大叔声称'注释总是失败的'过于极端,而且可能有害。逻辑只显示代码做了什么,而不显示程序员的意图或决策背后的推理。注释应该用于自然地沟通,而不扭曲逻辑。关于注释说谎或过时的反对意见,比起完全没有注释来说问题更小。注释既能改善好代码也能改善坏代码;它们不是糟糕代码的拐杖。作者挑战批评者:在不丢失信息或扭曲逻辑的情况下删除注释。
Beej's Bit Bucket2 months agohttp://beej.us/blog/data/mastodon-comments/作者从博客中移除了Disqus评论,因为Disqus终止了免费无广告选项,对于低使用量来说不值得付费。他们用从Mastodon拉取评论的系统取代了Disqus,利用了Mastodon用户与博客读者之间的重叠。该解决方案使用Mastodon的公共API以JSON格式获取评论,无需认证,然后JavaScript解析数据并构建评论HTML。Mastodon帖子ID通过占位符嵌入静态HTML中,在站点生成过程中使用shell脚本替换。评论在用户点击时加载(而非页面加载时),以减少服务器负载,函数fetch()从API端点检索JSON。每条评论显示用户头像、显示名称、账户名、内容(已HTML编码)以及媒体附件(作为带表情符号图标的简单链接)。黑名单功能允许通过将ID存储在环境变量中过滤特定评论或账户,该变量转换为JavaScript Set进行过滤。部署过程存在先有鸡还是先有蛋的问题:博客必须先上线才能从Mastodon链接,然后使用帖子ID重新构建并重新部署博客条目。这是第一篇使用新评论系统的帖子,因此作者正在测试其是否存在故障。
How the Chinese use wires to catch rocket boosters2 months agohttps://old.reddit.com/r/interestingasfuck/comments/1utyo87/how_the_chinese_use_...这段文本看起来是 Reddit 用户名和评论分数的列表,可能来自评论帖子或讨论论坛。用户名用破折号呈层次结构显示,表示嵌套回复。大多数用户的评论分数被标记为“hidden”,可能是由于用户设置或子版块规则造成的。最后一部分包含一个提示或邀请:“想要参与讨论吗?发表评论吧!”, "这段文本的目的可能是显示评论树或鼓励参与在线讨论。"
Blatant nepotism among various groups of Indians in Amazon2 months agohttps://old.reddit.com/r/amazonemployees/comments/1uoj25w/blatant_nepotism_among...文本似乎是Reddit风格的评论线程列表,包含用户名和投票分数。每条评论都包含用户名,以及表示赞同票和反对票的数值。其结构类似于在线讨论论坛中嵌套的评论链。除了讨论元数据的格式外,没有实质性的内容或主要观点。