Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Cut v0.9.0: the site, README and docs describe 49 unreleased commits, so the landing-page commands fail on @latest

Đã đóng
  • Có gì không ổn?
#104 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
35/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker, github-actions, go
Lĩnh vực
ci-cd, cli, documentation, release

Hướng nghiên cứu

Read the GoReleaser pipeline referenced by #61, the Pages deployment workflow, and the documented commands in README.md, docs/index.html, docs/start.md, docs/labs.md, docs/monitoring.md, docs/library.md, and docs/cli.md. First check the latest tag and compare its published assets and behavior with main. Done when the release, container, pkg.go.dev package, and documented commands match the stated checks and future Pages updates cannot advertise unreleased behavior.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

area: docs area: release bug documentation priority: high

Why it matters

Every new visitor's first command fails. v0.8.0 is the latest tag, main is 49 commits ahead, and the Pages site (rebuilt in bd2aa16 and redeployed on every push to main) documents the unreleased behaviour. That undercuts the "honest tool" positioning the site is built on.

Evidence (checked against a v0.8.0 build)

  • subenum -simulate example.com (landing CTA, docs/index.html:224) exits 1 on v0.8.0 because -w is still required; the bundled 5k wordlist (data/subdomains-5k.txt) is unreleased.
  • -stats is an unknown flag in v0.8.0, so the hero command and the jq -e '.verdict == "complete"' gate fail.
  • DoT/DoH, -simulate-zone (docs/labs.md), -diff (docs/monitoring.md), takeover hints, resume, permute, config/env defaults: all only on main.
  • https://pkg.go.dev/github.com/TMHSDigital/subenum/pkg/subenum is 404 because no tag contains pkg/; docs/library.md:12 go get gives a module without the package.
  • "Static builds for ... FreeBSD" (docs/index.html:26, docs/start.md:21) and gh attestation verify subenum_<version>_linux_amd64.tar.gz (README.md:201) match no published v0.8.0 asset (v0.8.0 assets are the old subenum-linux-amd64 naming).

Suggested approach

  1. Tag v0.9.0 from main via the GoReleaser pipeline (#61). This also closes #46 and should include #102 (CITATION.cff version).
  2. Prevent recurrence: deploy Pages on release: published (or from the latest tag) rather than every push, or add a CI job that runs the docs' copy-paste commands against the @latest release.
  3. Optionally mark newer flags with "since vX.Y" in docs/cli.md.

Done when

  • go install github.com/TMHSDigital/subenum@latest && subenum -simulate example.com -stats s.json works.
  • ghcr.io/tmhsdigital/subenum:latest has the same flags.
  • pkg.go.dev resolves pkg/subenum.
  • The release lists FreeBSD archives, checksums.txt, SBOM and attestations matching README instructions.
Ngôn ngữ chính
Go
Star
1
Fork
1
Merge trung bình
5 ngày 2 giờ
Pull request đã merge (30 ngày)
3

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của TMHSDigital/subenum

Tất cả issue của TMHSDigital/subenum

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.