Skip to content

chore: folder and slug instructions on readme#333

Open
dhananjay6561 wants to merge 6 commits intokeploy:mainfrom
dhananjay6561:readme-structure
Open

chore: folder and slug instructions on readme#333
dhananjay6561 wants to merge 6 commits intokeploy:mainfrom
dhananjay6561:readme-structure

Conversation

@dhananjay6561
Copy link
Contributor

PR Description: Comprehensive README Revamp

Overview

This PR provides a complete overhaul of the project's root README.md. The objective was to transform the documentation from a generic setup guide into a developer-friendly, technically documented resource that accurately reflects the current state of the Keploy blog website.

Previous Issues

  • Generic Content: Documentation lacked specific details about the blog's architecture and feature set.
  • Unverified Tech Stack: Listed technologies were not cross-checked against the actual codebase.
  • Incomplete Site Map: Dynamic routes, API endpoints, and navigation structures were not documented.
  • Poor Organization: Setup instructions were buried under less critical information.

Key Changes & Improvements

1. Technical Audit & Verification

  • Tech Stack Table: Conducted a full audit of package.json and source code. Every library (GSAP, Framer Motion, React Spring, Radix UI, etc.) is now listed with its specific use case and primary file locations.
  • Removed Redundancy: Removed unreferenced libraries (e.g., highlight.js) to ensure documentation accuracy.

2. Deep Site Mapping

  • Pages Table: Documented 12 core routes with URL patterns and live examples (e.g., https://keploy.io/blog/tag/a2a).
  • API Documentation: Detailed 5 server-side endpoints with descriptions of their functionality (Search, Preview, Proxying).
  • Navigation Hierarchy: Documented the complex mega-menu structure and Resources dropdown, mapping internal segments to external ecosystem links.

3. Structural Reorganization

  • Configuration-First: Moved Prerequisites, Setup, and Environment variables to the top for immediate dev accessibility.
  • Annotated Project Structure: Added a detailed directory tree with annotations for core components and library logic.

4. Qualitative Enhancements

  • Added a "What is this?" section highlighting the Next.js (SSG + ISR) architecture.
  • Included Contributing guidelines and Deployment details (Vercel + CloudFront proxying).
  • Fixed typos and improved formatting for better readability.

Technical Details

  • Architecture: Next.js 18 (Pages Router)
  • Data Source: Headless WordPress (WPGraphQL)
  • Deployment: Vercel + AWS CloudFront (Base path: /blog)

Verification

  • Cross-verified all cited files and component paths.
  • Validated URL patterns against pages/ directory structure.

Copilot AI review requested due to automatic review settings February 24, 2026 12:15
@kilo-code-bot
Copy link

kilo-code-bot bot commented Feb 24, 2026

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Overview

This PR completely rewrites the README.md with comprehensive documentation including:

  • Project overview with badges
  • Configuration and setup instructions
  • Contributing guidelines
  • Deployment notes
  • Complete site map (12 pages, 5 API routes)
  • Tech stack documentation
  • Project structure
  • Key features list

The documentation is well-structured, accurate, and follows best practices for open-source project READMEs.

Files Reviewed (1 file)
  • README.md - Documentation rewrite, no issues found

@dhananjay6561
Copy link
Contributor Author

Hi @amaan-bhati , kindly review the PR.

@amaan-bhati amaan-bhati mentioned this pull request Feb 24, 2026
@amaan-bhati amaan-bhati changed the title Comprehensive README Revamp chore: folder and slug instructions on readme Feb 24, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR transforms the README.md from a basic WordPress + Next.js setup guide into a comprehensive technical documentation resource. The new README provides detailed information about the blog's architecture, tech stack, site structure, and deployment configuration, making it significantly more useful for developers working on the project.

Changes:

  • Complete restructuring with improved organization: prerequisites and setup moved to the top, followed by detailed site mapping, tech stack documentation, and project structure
  • Added extensive site map documentation covering 12 pages, 5 API routes, and navbar structure with live URL examples
  • Created comprehensive tech stack table with 20+ technologies, their specific use cases, and file locations
  • Enhanced with visual elements (logo, badges) and better markdown formatting throughout

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@amaan-bhati amaan-bhati self-requested a review February 24, 2026 12:21
Copy link
Member

@amaan-bhati amaan-bhati left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @dhananjay6561 Please fix the type of server, rest all looks good to me

Signed-off-by: Dhananjay Aggarwal <133662894+dhananjay6561@users.noreply.github.com>
Signed-off-by: Dhananjay Aggarwal <133662894+dhananjay6561@users.noreply.github.com>
@dhananjay6561
Copy link
Contributor Author

Hi @amaan-bhati implented all the suggestions as suggested by Copilot

- Click the **Upload Plugin** button at the top of the page and upload the WPGraphQL plugin.
- Once the plugin has been added, activate it from either the **Activate Plugin** button displayed after uploading or from the **Plugins** page.
<p align="center">
<a href="https://nextjs.org"><img src="https://img.shields.io/badge/Next.js-18-black?logo=next.js" alt="Next.js"/></a>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like this says "nextjs 18", it should be so, there is no nextjs 18 version released by vercel yet, we are still on 16 lol

Image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants