Skip to content

docs: Add FAQ section for common questions#86

Open
meichuanyi wants to merge 1 commit into
nexu-io:mainfrom
meichuanyi:docs/add-faq-1779657276
Open

docs: Add FAQ section for common questions#86
meichuanyi wants to merge 1 commit into
nexu-io:mainfrom
meichuanyi:docs/add-faq-1779657276

Conversation

@meichuanyi

Copy link
Copy Markdown

This PR adds a FAQ section to the README covering:

  • What is HTML Anything
  • Key Features table
  • Getting Started
  • Key Concepts table
  • Supported Use Cases
  • License
  • Help & Resources

Each FAQ entry is tailored to HTML Anything's specific features (AI Agent Editor, Local Execution, Real-time Preview, Component Library, Custom Styling).

@lefarcen lefarcen requested a review from nettee May 24, 2026 21:16
@lefarcen lefarcen added size/S Small change: 20-99 changed lines risk/low Low-risk docs/assets/localization-only change type/docs Documentation-only changes labels May 24, 2026

@nettee nettee left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

A couple of the new FAQ entries currently point readers to commands and metadata that do not match this repository, so I’m requesting changes before this lands.

🔁 Powered by Looper · runner=reviewer · agent=opencode · An autonomous AI dev team for your GitHub repos.

Comment thread README.md
Comment on lines +527 to +532
```sh
# Clone and run
git clone https://github.com/nexu-io/html-anything
cd html-anything
npm install
npm start

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The new Getting Started snippet is not runnable for this repo as written. At the workspace root there is no npm start script (package.json only declares the workspace metadata), and the repo guidance above already uses pnpm -F @html-anything/next dev for local startup. As a result, someone following this FAQ will hit a dead end immediately. Please replace this block with the real root-level bootstrap commands for this workspace, e.g. pnpm install --frozen-lockfile followed by pnpm -F @html-anything/next dev.

🔁 Powered by Looper · runner=reviewer · agent=opencode · An autonomous AI dev team for your GitHub repos.

Comment thread README.md

### License

MIT License.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This FAQ entry changes the documented license from Apache-2.0 to MIT, which conflicts with the existing license badge, the root package.json, and the main ## License section directly above. Because license text is public-facing project metadata, publishing the wrong one can mislead downstream users about their rights and obligations. Please update this answer to match the repo’s actual Apache-2.0 license instead of introducing a second, conflicting license statement.

🔁 Powered by Looper · runner=reviewer · agent=opencode · An autonomous AI dev team for your GitHub repos.

Comment thread README.md

- [Documentation](https://github.com/nexu-io/html-anything#readme)
- [Issues](https://github.com/nexu-io/html-anything/issues)
- [Examples](https://github.com/nexu-io/html-anything/tree/main/examples)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The new Examples link points to tree/main/examples, but this repository does not have a top-level examples/ directory. That leaves the FAQ with a dead resource link in the same section that is supposed to help new users orient themselves. Please either remove this item or retarget it to an existing examples surface, such as the template/example files already under next/src/lib/templates/skills/**/example.html.

🔁 Powered by Looper · runner=reviewer · agent=opencode · An autonomous AI dev team for your GitHub repos.

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

Labels

risk/low Low-risk docs/assets/localization-only change size/S Small change: 20-99 changed lines type/docs Documentation-only changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants