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

Build a guides content system (routes, metadata, JSON-LD, OG, sitemap)

Đang mở
  • Có gì không ổn?
#35 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
48/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
json, next.js, typescript
Lĩnh vực
documentation, full-stack

Hướng nghiên cứu

Start by reading lib/tools.ts and the existing metadata, JSON-LD, OG, sitemap, and README patterns named in the issue. Then inspect the app/ routing structure and run the stated lint, test, and build commands. Done means a sample guide renders with metadata, JSON-LD, and an OG image, appears in the sitemap, and the guides index and README instructions are included.

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

Mô tả

enhancement hacktoberfest help wanted seo

Context

Part of the SEO growth initiative (#18): Phase 2: Coverage engine (guides and internal linking).
Guides are the biggest coverage lever: how-to content ranks for informational queries and funnels readers into the tools. This is the foundation the guide articles depend on.

What to do

  • Add a typed guides registry (mirroring lib/tools.ts) and routes under app/guides/.
  • Reuse the existing patterns: metadata via a helper like lib/toolMetadata.ts, structured data via lib/jsonLd.ts (add Article/HowTo + BreadcrumbList), and per-guide OG images via lib/og.tsx.
  • Extend app/sitemap.ts to include guides.
  • Ship a guides index page and update the README "Add a" docs.

Where

New: lib/guides.ts, app/guides/. Extend: lib/jsonLd.ts, app/sitemap.ts, lib/og.tsx, lib/toolMetadata.ts (or a sibling). Follow the single-registry approach in lib/tools.ts.

Acceptance criteria

  • A sample guide renders with correct metadata, JSON-LD, OG image, and appears in the sitemap
  • npm run lint && npm run test && npm run build passes

Notes

Want to work on this? Comment below and I'll assign it to you. Please take one issue at a time, branch off develop, and open your PR against develop with Closes #35 in the description.
This blocks the individual guide-writing tasks and the guides-to-tools linking task.

Ngôn ngữ chính
TypeScript
Star
1
Fork
9
Merge trung bình
9 giờ 50 phút
Pull request đã merge (30 ngày)
105

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

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 codercops/toolbelt

Tất cả issue của codercops/toolbelt

Issue tương tự

Thêm issue về TypeScript

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.