SEO Optimisations

Đang mở
#323 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
github-actions

Hướng nghiên cứu

Bắt đầu bằng cách đối chiếu checklist với repository, đặc biệt là src/layouts/Layout.astro, robots.txt và deploy GitHub Action. Phân chia công việc thành các hạng mục có thể được kiểm tra độc lập, sau đó sử dụng các tiêu chí SEO, hiệu suất, khả năng truy cập và nội dung của audit để xác nhận rằng mỗi hạng mục đã chọn đã hoàn tất.

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

Mô tả

ipfs.tech SEO Audit

Schema / Structured Data

  • [Critical] Add Organization + WebSite + SoftwareApplication JSON-LD to src/layouts/Layout.astro

On-page / Search Experience (SXO)

  • [Critical] Add a self-contained "What is IPFS" definition block near the H1 (~150–250 words, must include the literal phrase "InterPlanetary File System," must stand alone without pronouns referring outside the passage)
  • [High] Add a decision-stage section for technical evaluators (CTO/decision-maker persona currently scores 40/100) — comparison framing vs. Filecoin/Arweave, business-outcome case studies, separate from the existing logo carousel
  • [Medium] Add a short trust/security passage — a Check Point phishing article ranks in the top 10 for "IPFS" itself, and nothing on-page addresses it
  • [Medium] Turn the "pick the tool" link list into a decision table (use case → recommended tool → one-line why)

AI Search Readiness (GEO)

  • [High] Rewrite hero stats ("400k+ public nodes," "1B+ CIDs," "17.1K GitHub stars") as full, source-attributed, dated sentences instead of bare <dl> pairs
  • [Medium] Differentiate AI crawler policy in robots.txt — decide deliberately whether to keep training-only bots (CCBot, anthropic-ai, cohere-ai) allowed alongside answer-engine bots (GPTBot, ClaudeBot, PerplexityBot)
  • [Medium] Surface the existing YouTube channel (@IPFSbot) and add LinkedIn to nav/footer — YouTube mentions carry the strongest documented correlation with AI citation likelihood
  • [Low] Add an optional llms.txt mirroring key homepage facts and doc links

Performance / Core Web Vitals

  • [Critical] Simplify or defer the hero's 393-node SVG gradient mesh (g.mesh) — it accounts for 2.35s of the 3.28s mobile LCP via pure element-render-delay, not resource loading
  • [High] Trim unused Commit Mono font weights from the render-blocking critical chain; preload only the weight used above the fold
  • [High] Right-size and convert oversized images to WebP/AVIF (worst offender: a 176.8KB portrait served at 70×70 display — ~360KB total savings available)
  • [Low] Add <link rel="preconnect" href="https://plausible.io">
  • [High] Set Cache-Control: public, max-age=31536000, immutable on all content-hashed assets under /_astro/* and /fonts/* (~534KB avoidable repeat-visit transfer today)

Technical SEO

  • [High] Evaluate fronting the apex domain with a header-capable CDN (e.g. Cloudflare) to add CSP, HSTS, X-Content-Type-Options, X-Frame-Options, Referrer-Policy, Permissions-Policy — GitHub Pages has no config file for these; alternatively, explicitly accept and document the risk
  • [Medium] Add an IndexNow key + a one-line ping step to the deploy GitHub Action

Content Quality / E-E-A-T

  • [High] Add a Privacy Policy / Terms link to nav or footer — the newsletter signup collects user data with no on-site link to data-handling terms
  • [Medium] Re-source the "Using IPFS in production at Wikipedia" claim — currently links to IPFS's own blog post, not an independent third-party confirmation
  • [Medium] Add author/maintainer attribution or a "reviewed by" signal for technical claims (CIDs, DHT, Bitswap, transport protocols)
  • [Low] Fix "Join the disussions" typo in the community footer CTA
  • [Low] Lengthen the meta description to use the full ~155-character budget

Visual / Mobile

  • [High] Enlarge mobile tap targets on the hamburger menu and theme toggle (currently 34×34 CSS px, used on every page load — under the 44×44/48×48 recommended minimums)
  • [High] Enlarge and space out the testimonial carousel's prev/next arrow buttons (same 34×34px issue, ~8px apart)
  • [Medium] Check contrast of the "Using IPFS in production" logo strip in dark mode (renders grey-on-near-black)

Sitemap & Content Architecture

  • [Medium] Resolve duplicate intent between docs.ipfs.tech/how-to/pin-files/ and docs.ipfs.tech/quickstart/pin/ — both compete for "how to pin files on IPFS"
  • [Medium] Build a blog.ipfs.tech comparison/use-case content cluster ("IPFS vs Filecoin," decentralized storage landscape, use cases beyond NFTs) to reclaim commercial-investigation queries currently owned by Filebase, Coinbase, and Medium
  • [Low] Add a real <lastmod> to ipfs.tech's own sitemap entry, tied to actual content edits
  • [Info] specs.ipfs.tech has no sitemap or robots.txt at all — external subdomain, not fixable from this repo; flag to whoever owns that deployment

Backlinks

  • [Low] Add a free Moz API key (MOZ_API_KEY / .config/claude-seo/backlinks-api.json) to unlock referring-domain count, DA/spam score, and anchor-text distribution — current read is Common-Crawl-only and reported as insufficient data for a health score
Ngôn ngữ chính
Astro
Star
35
Fork
18
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

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

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

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 ipfs/ipfs-website

Tất cả issue của ipfs/ipfs-website

Issue tương tự

Thêm issue về Content

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.