Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

docs: Update intro paragraph to help improve first impressions and broaden audience #2602

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
paulhibbitts wants to merge 10 commits into docsifyjs:develop
base: develop
Choose a base branch
Loading
from paulhibbitts:develop

Conversation

Copy link
Collaborator

@paulhibbitts paulhibbitts commented Sep 5, 2025

Summary

Update intro paragraph to improve first impressions and broaden audience for Docsify v5

  • Lead with outcome instead of technical process
  • Use more welcoming, confident language
  • Targets both developers and less-technical users
  • Remove the comparison to a single similar tool

Happy to further iterate/refine based on feedback!

PREVIEW👇🏼

docsify

A magical documentation site generator.

What it is

Docsify turns your Markdown files into a documentation website instantly. Unlike most other documentation site generator tools, it doesn't need to build HTML files. Instead, it dynamically loads and parses your Markdown files and displays them as a website. To get started, create an index.html file and deploy it on GitHub Pages (for more details see the Quick start guide).

Related issue, if any:

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, renaming)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • Documentation content changes
  • Other (please describe):

For any code change,

  • Related documentation has been updated, if needed
  • Related tests have been added or updated, if needed

Does this PR introduce a breaking change?

  • Yes
  • No

Tested in the following browsers:

  • Chrome
  • Firefox
  • Safari
  • Edge

Copy link

vercel bot commented Sep 5, 2025
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docsify-preview Ready Ready Preview Comment Sep 5, 2025 7:00pm


## Features

- No statically built html files
- No statically built HTML files
Copy link
Member

@sy-records sy-records Sep 5, 2025

Choose a reason for hiding this comment

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

Should this be capitalized? If so, should /README.md also be modified?

Copy link
Collaborator Author

@paulhibbitts paulhibbitts Sep 6, 2025

Choose a reason for hiding this comment

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

Yes, I think it would be best to capitalize both instances on HTML on the ReadMe - I intended to do that.

sy-records reacted with thumbs up emoji
@sy-records sy-records changed the title (削除) Update intro paragraph to help improve first impressions and broaden audience (削除ここまで) (追記) docs: Update intro paragraph to help improve first impressions and broaden audience (追記ここまで) Sep 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@sy-records sy-records sy-records left review comments

At least 2 approving reviews are required to merge this pull request.

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /