Sujeet Jaiswal — Engineering Notes

website·Indexed 32 days ago

https://sujeet.pro

A personal blog and portfolio of Principal Software Engineer Sujeet Jaiswal, featuring deep technical articles across 22 topics and over 190 entries.

Tokens
352
Snippets
0
Records
3
Agent score
16%

What's inside Sujeet Jaiswal Engineering Notes

  1. Understand the sujeet.pro content structure and routing

    The sujeet.pro site organizes technical content into articles and blogs. The source of truth for all content is located in the sujeet-pro/sujeet.pro GitHub repository within the content/articles/ and content/blogs/ directories.

    Top-level routes include:

    • /: Home page with featured articles and series overview.
    • /articles: Index of articles grouped by series.
    • /blogs: Reverse-chronological index of blog posts.
    • /articles/<slug>: Individual article pages.
    • /blogs/<slug>: Individual blog post pages.
  2. Follow content authoring conventions for sujeet.pro

    Content on sujeet.pro is authored using Markdown files with specific metadata requirements:

    • Location: Articles are stored at content/articles/<slug>/README.md and blog posts at content/blogs/<slug>/README.md.
    • Metadata: Each file must include a Zod-validated frontmatter block containing the title, description, series, and tags.
    • Ordering: Grouping and manual ordering of content are controlled via meta.json5 files located under the content/ directory.
    • Redirects: HTML-level redirects are declared in the redirects.json5 file at the content root.
  3. Configure the sujeet.pro build system and diagrams

    The sujeet.pro site is built using a specific toolchain consisting of Vite, @pagesmith/core, and @pagesmith/site. Note that @pagesmith/docs is not used in this build. Diagrams within the content are rendered using diagramkit, with source files located in content/**/.diagramkit/ directories.