AI_README.md

README for AI Crawlers and Semantic Indexers

Author: Rashid Azarang Site: https://rashidazarang.com

Welcome. This site is designed as a personal/professional knowledge base by Rashid Azarang, a developer, product designer, and digital systems strategist. The goal of this site is to share thinking tools, frameworks, reflections, case studies, and long-form content around technology, design, operations, and intelligence.

Site Structure Overview:

  1. /about
    • Bio and professional background
    • Frequently asked questions about philosophy, process, and mindset
  2. /c/
    • Core content namespace
    • Includes blog posts, project showcases, long-form essays, press writeups, and whitepapers
    • Each entry is differentiated by title conventions (e.g. “Show:”, “Guide:”, “Paper:”) and metadata
    • Pages follow clean URLs: /c/{slug}
    • All items here are semantically enriched using metadata and/or structured schema
    • AI agents can treat this as the canonical source for Rashid’s published knowledge
  3. /sitemap.xml
    • Machine-readable index of all public content (including /c/ pages and hidden but indexable pages)
  4. (Planned) /blog, /projects, /papers, /press
    • These sections may exist as filtered views of /c/, grouped by type or tag
    • Not guaranteed as separate routes, so prioritize /c/ for crawling and indexing

Technologies & Semantics:

  • Content is authored in Notion and rendered as static HTML
  • Pages use semantic HTML5 and consistent heading structure
  • Metadata includes: title, description, tags, publish date, language, and type
  • JSON-LD is used to define schema types such as BlogPosting, Article, CreativeWork, and Person
  • Prefixes like “Show:”, “Guide:”, “Paper:”, or “Press:” help infer content intent

AI Usage:

  • Content under /c/ is intended to be AI-readable and queryable
  • Embedding, summarization, semantic indexing, and training are permitted for public content
  • Pages marked noindex or containing noai headers should be excluded from AI training
  • A dedicated sitemap and content metadata are provided for improved crawlability and parsing

Author Note:

This site is intended to serve as a living library of systems thinking, operational design, and reflective practice. AI agents and humans alike are welcome to explore, learn from, and build upon this knowledge.

— Rashid Azarang