Skip to content

docs: update introduction for clarity and engagement#1

Open
gaurav-nelson wants to merge 1 commit into
mainfrom
autodocs
Open

docs: update introduction for clarity and engagement#1
gaurav-nelson wants to merge 1 commit into
mainfrom
autodocs

Conversation

@gaurav-nelson

Copy link
Copy Markdown
Contributor

This pull request updates the Introduction page of the DocsLit documentation to improve clarity, make the messaging more engaging, and better highlight the product's benefits and workflow. The changes focus on rewriting descriptions, enhancing feature explanations, and streamlining the getting started steps to create a more inviting and informative experience for new users.

Content and Messaging Improvements:

  • Rewrote the introductory paragraphs and feature tiles to better communicate DocsLit's value proposition, focusing on ease of use, interactive components, and fast deployment.
  • Added a prominent callout for technical teams, emphasizing a low-friction writing workflow and a modern documentation experience.

Feature Highlights and Workflow:

  • Updated the feature accordion group to clarify benefits such as built-in search, theme adaptation, SEO/AI readiness, hot reload, and scalability for growing docs projects.
  • Improved the "How it works" section to emphasize Markdown-first authoring and the simplicity of using native web components, removing references to imports and build steps. [1] [2]

Getting Started Flow:

  • Refined the quickstart steps and language for installing DocsLit, building a site, and exploring components, making them more concise and user-focused.

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
❌ Deployment failed
View logs
docslit-docs 8695750 Jun 17 2026, 02:38 AM

@gaurav-nelson gaurav-nelson left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

DraftView review: 2 comments, 0 edits

DocsLit is a documentation framework that combines Markdown with interactive web components. You write content in Markdown, drop in `<wc-*>` components for rich interactions, and deploy a fast static site — no build tools, no JSX, no imports.
DocsLit turns plain Markdown into polished, interactive docs that teams actually enjoy writing and users actually enjoy reading.

You stay in Markdown. You drop in powerful `<wc-*>` components when needed. You ship a fast documentation site without wrestling with build tools, JSX, or import chains.

@gaurav-nelson gaurav-nelson Jun 17, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Too many You's. Make this clearer.


Review by abc@duck.com · verified & pushed by gaurav-nelson via DraftView

</wc-columns>

No imports. No build step. No configuration. The components just work because they are standard web components rendered by the browser.
No imports. No JS boilerplate. No component setup. The browser renders standard web components directly, so your authoring workflow stays clean.

@gaurav-nelson gaurav-nelson Jun 17, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Sound like AI wrote it.


Review by abc@duck.com · verified & pushed by gaurav-nelson via DraftView

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yup. this is an AI generated PR.

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.

1 participant