Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

Trend-tracking jq recipe prints evaluation_completed=false as 'n/a', because jq's // operator treats false like null (F-W1-DOCS-TRAIN-16)

未关闭 适合新手
  • 哪里不对？
#884 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
1/5
预计耗时
1-3 小时
新手友好度
80/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
python
领域
documentation

调研方向

有问题的 jq 视图位于 docs/usermanuals/en/evaluation/trend-tracking.md 的第 47 行，土耳其语副本 docs/usermanuals/tr/evaluation/trend-tracking.md 的同一行需要相同的修改。使用 jq 1.7.1 对三个输入 {"evaluation_completed": false}、{"evaluation_completed": true} 和 {} 运行文档中的表达式，以查看当前输出。当三种情况分别输出 false、true 和 n/a，并且两个语言页面在同一次修改中更新时，即为完成。

由索引模型根据 Issue 内容生成。

描述

documentation good first issue severity: low source: review-2026-09 wave: 4

Wave 4 · group W4 Docs · highest severity Low · 1 finding(s) · effort docs fix

Summary

The page explains that evaluation_completed: false marks a safety run that produced no usable evidence, then gives a jq view that renders the field with .evaluation_completed // "n/a". jq's alternative operator falls back on false as well as null, so exactly the rows the view is meant to expose print as completed=n/a, indistinguishable from older rows that lack the field.

Primary finding

F-W1-DOCS-TRAIN-16 — The trend query hides an explicit evaluation failure as missing telemetry

severity Low · confidence high · reproduced with jq 1.7.1

What happens. docs/usermanuals/en/evaluation/trend-tracking.md:47 and the Turkish mirror at the same line. Rows with evaluation_completed: false do occur: the safety orchestrator sets it when the classifier abstains (forgelm/safety/_orchestrator.py:359-361) and _append_trend_entry writes it to safety_trend.jsonl (forgelm/safety/_results.py:168).

Where.

Evidence (re-verified on 2026-10-09).

  • With jq 1.7.1 the documented expression prints completed=n/a for {"evaluation_completed": false}, completed=true for true, and completed=n/a when the field is absent.

Recommended fix. Render the field without the alternative operator, for example completed=\(if .evaluation_completed == null then "n/a" else .evaluation_completed end), which prints true, false and n/a for the three cases.

Acceptance criteria

  • The jq view prints true, false and n/a for true, false and missing values.
  • Documentation listed above is corrected in English and in its Turkish mirror in the same PR.
  • The finding is resolved or explicitly closed with a reason.

Found by the September 2026 independent review of ForgeLM against commit cab2947 and re-verified against development at f94595f on 2026-10-09. Code links point at cab2947; line numbers may have moved since. Finding IDs (F-W1-…) are stable references for this backlog.

主要语言
Python
星标
9
派生
1
平均合并
10 小时 40 分钟
30 天内合并 PR
12

环境准备

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

HodeTech/ForgeLM 的其他 Issue

查看 HodeTech/ForgeLM 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。