Skip to content

add faqs pages to docs#1691

Open
OmkarDeshpande7 wants to merge 3 commits intogh-pagesfrom
private/gh-pages/add-faqs
Open

add faqs pages to docs#1691
OmkarDeshpande7 wants to merge 3 commits intogh-pagesfrom
private/gh-pages/add-faqs

Conversation

@OmkarDeshpande7
Copy link
Collaborator

@OmkarDeshpande7 OmkarDeshpande7 commented Mar 16, 2026

What this PR does / why we need it

Which issue(s) this PR fixes

(optional, in fixes #<issue number>(, fixes #<issue_number>, ...) format, will close the issue(s) when PR gets merged)

fixes #

Special notes for your reviewer

Testing done

please add testing details (logs, screenshots, etc.)


Note

Low Risk
Low risk documentation-only change that updates site navigation and adds new troubleshooting/FAQ content; no runtime or backend logic is modified.

Overview
Adds a dedicated FAQ page to the docs and links it from the Introduction sidebar, while removing the previously embedded FAQ content from prerequisites.md in favor of a pointer to the new page.

Expands troubleshooting docs by adding a new guide for nbdcopy disk-copy failures (commonly due to ESXi DNS//etc/hosts resolution issues) and linking it from the main Troubleshooting page.

Written by Cursor Bugbot for commit 33b79f9. This will update automatically on new commits. Configure here.

Copy link
Contributor

@windsurf-bot windsurf-bot bot left a comment

Choose a reason for hiding this comment

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

💡 To request another review, post a new comment with "/windsurf-review".


See the troubleshooting guide: [nbdcopy fails during disk copy (often DNS resolution)](../../guides/Troubleshooting/nbdcopy-fails-after-vm-moved-esxi-host/).

### What do when virt-v2v fails with `rename: /sysroot/etc/resolv.conf ... Operation not permitted`?
Copy link
Contributor

Choose a reason for hiding this comment

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

There's a grammatical error in this heading. Consider rewording to 'What to do when virt-v2v fails with...' or 'What should I do when virt-v2v fails with...'

- This is a known and documented `virt-v2v` issue. [See here](https://libguestfs.org/virt-v2v.1.html#linux%3A-rename%3A-sysroot-etc-resolv.conf-failure)
- If configuration management or security hardening marks `/etc/resolv.conf` immutable, ensure this is unset before conversion, or adjust your automation so that VMs intended for conversion do not have `/etc/resolv.conf` marked immutable.

### How does Vjailbreak handle flavors of the vm in the target openstack environment?
Copy link
Contributor

Choose a reason for hiding this comment

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

For consistency with the rest of the document, 'Vjailbreak' should be 'vJailbreak' (lowercase 'v', uppercase 'J').

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix prepared a fix for the issue found in the latest run.

  • ✅ Fixed: Broken links due to uppercase directory in URL path
    • Updated both FAQ links to use lowercase troubleshooting so they match Starlight’s generated lowercase route slugs on case-sensitive hosts.

Create PR

Or push these changes by commenting:

@cursor push 1c06a8cbfe
Preview (1c06a8cbfe)
diff --git a/docs/src/content/docs/introduction/faq.md b/docs/src/content/docs/introduction/faq.md
--- a/docs/src/content/docs/introduction/faq.md
+++ b/docs/src/content/docs/introduction/faq.md
@@ -37,9 +37,9 @@
 failed to run nbdcopy: exec: already started

-See: Debug Logs.
+See: Debug Logs.

-See the troubleshooting guide: nbdcopy fails during disk copy (often DNS resolution).
+See the troubleshooting guide: nbdcopy fails during disk copy (often DNS resolution).

What do when virt-v2v fails with rename: /sysroot/etc/resolv.conf ... Operation not permitted?


</details>


<sub>This Bugbot Autofix run was free. To enable autofix for future PRs, go to the <a href="https://www.cursor.com/dashboard?tab=bugbot">Cursor dashboard</a>.</sub>
<!-- BUGBOT_AUTOFIX_REVIEW_FOOTNOTE_END -->


See: [Debug Logs](../../guides/Troubleshooting/debuglogs/).

See the troubleshooting guide: [nbdcopy fails during disk copy (often DNS resolution)](../../guides/Troubleshooting/nbdcopy-fails-after-vm-moved-esxi-host/).
Copy link

Choose a reason for hiding this comment

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

Broken links due to uppercase directory in URL path

Medium Severity

The links on lines 40 and 42 use ../../guides/Troubleshooting/debuglogs/ and ../../guides/Troubleshooting/nbdcopy-fails-after-vm-moved-esxi-host/ with an uppercase T in Troubleshooting. Starlight's docsLoader() normalizes all content slugs to lowercase, so the actual generated URLs use guides/troubleshooting/.... On case-sensitive hosts (like GitHub Pages on Linux), these links will produce 404 errors. The path component needs to use lowercase troubleshooting.

Fix in Cursor Fix in Web

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