SEO & Discoverability Backlog — remaining items after April 2026 audit

[mobileskyfi]

SEO Backlog — tikoci web properties

This issue tracks remaining SEO and discoverability improvements identified during the April 2026 audit (Google Search Console + Bing Webmaster Tools).

✅ Already Fixed (commit c90ebdb + restraml fa7a281)

• Sitemap injection was silently broken — src/sitemap.xml was missing the build marker; per-repo /p/*.html pages were never injected. Fixed.
• Atom feed added — atom.xml now generated at build time with one entry per repo. robots.txt references it as a second sitemap. Feed auto-discovered via <link rel="alternate"> on all pages.
• Short page titles (Bing Rule 114, 3 pages) — containers.html, virtualization.html, web-tools.html — all expanded to 50–60 char descriptive titles.
• Short meta description (Bing Rule 118) — virtualization.html expanded from ~80 chars to 200+ chars.
• OG tags + canonical URLs added to all 11 src/*.html pages (were missing except curl2rsc.html).
• restraml — added <meta name="description"> + OG tags to all 6 docs/*.html pages; fixed short title on index.html.
• twitter:card added sitewide + per-repo generated pages.

---

🔴 Requires Manual Step — IndexNow (Bing Rule 116, High Priority)

IndexNow lets Bing (and other IndexNow-compatible engines like Yandex) know about new/updated pages immediately rather than waiting for crawls.

Steps:

1. Go to Bing Webmaster Tools → IndexNow
2. Generate a key (UUID) and download the verification file {key}.txt
3. Add the file to src/ so it gets copied to dist/ on build
4. Optionally: add a GitHub Actions step to POST to the IndexNow API after deploy:

   POST https://api.indexnow.org/indexnow
   { "host": "tikoci.github.io", "key": "{key}", "urlList": [...] }
   

5. Also submit to Google via IndexNow plugin or Search Console

Expected impact: Faster indexing of new/updated pages (days vs weeks). High priority per Bing.

---

🟠 Structural — Structured Data / JSON-LD (Medium, bigger change)

Adding JSON-LD structured data helps both Google and Bing show rich results.

Candidates:

• index.html → Organization schema with name, url, sameAs (GitHub org)
• /p/*.html per-repo pages → SoftwareApplication or SoftwareSourceCode schema (name, description, url, programmingLanguage, license)
• chr-images.html → HowTo schema for install instructions

These would go into generate-pages.ts for per-repo pages and inline in the respective HTML files.

---

🟡 Core Web Vitals / Performance

Google Search Console may eventually flag CWV issues. Pre-emptive checks:

• All pages load Pico CSS + Google Fonts from CDN — consider preloading font CSS
• project-map.html loads D3 + full repo graph — LCP may be slow on mobile; could lazy-load
• No image optimization — docs/images/ are PNGs; could add loading="lazy" attributes

Tools: Lighthouse in DevTools, PageSpeed Insights

---

🟡 restraml Subsite — Atom Feed

The restraml tool pages (tikoci.github.io/restraml/) are in a separate repo. They now have OG tags (fixed above) but have no Atom/RSS feed of their own. The main site's atom.xml only covers tikoci.github.io repos, not restraml-specific updates.

Options:

• Add atom.xml to restraml repo and reference from its pages
• Add a <link rel="alternate"> on restraml pages pointing to the main site's atom.xml (simpler)

---

🟡 Google Search Console — Sitemap Status

After the build deploys, re-submit the sitemap in Google Search Console:

1. Open Search Console → Sitemaps
2. Submit https://tikoci.github.io/sitemap.xml
3. Submit https://tikoci.github.io/atom.xml (Atom feeds are valid as sitemaps)

Previously the sitemap was empty (injection was silently broken). Once the new build deploys, the sitemap should validate. Allow 1–2 weeks for Google to re-crawl.

---

🟢 Expected Improvements from Fixes Already Deployed

Fix	Expected outcome	Timeline
Sitemap with 20+ repo pages	Google indexes /p/*.html pages	2–4 weeks
OG tags sitewide	Better link previews on Slack/Twitter/iMessage	Immediate on share
Longer titles/descriptions	Higher CTR from search results, Bing rules resolved	1–2 weeks (re-crawl)
Atom feed	Feed readers discover content; may help Google News-style discovery	2–4 weeks
restraml OG tags + descriptions	restraml pages indexed with proper snippets	2–4 weeks