Skip to content

Conversation

@gjcolombo
Copy link
Contributor

Try to improve a few things about the documentation:

  • Lift the guest-internet-connection requirement into the top of the usage instructions
  • Move discussion of configuration options into a new document, CONFIGURING.md
  • Add some rudimentary troubleshooting guidelines (turn on the VGA console and see where it's stuck; instructions for getting at the OxidePrepBaseImage.ps1 output, since this is a common source of errors)

This includes the wimtools instructions added in #20 (but moves them to CONFIGURING.md) and instructions for selecting an edition to install via product key (as in #15).

@gjcolombo
Copy link
Contributor Author

Putting this in draft for now--there are a couple of bits of prose I'd like to tweak before merging, but most things should be ready for feedback.

@gjcolombo gjcolombo marked this pull request as ready for review August 6, 2024 16:27
@gjcolombo gjcolombo requested a review from sudomateo April 29, 2025 15:57
@qdzlug qdzlug self-assigned this May 8, 2025
gjcolombo added 4 commits May 8, 2025 22:37
Try to improve a few things about the documentation:

- Lift the guest-internet-connection requirement into the top of the usage
  instructions
- Move discussion of configuration options into a new document,
  CONFIGURING.md
- Add some rudimentary troubleshooting guidelines (turn on the VGA console
  and see where it's stuck; instructions for getting at the
  OxidePrepBaseImage.ps1 output, since this is a common source of errors)
@sudomateo sudomateo force-pushed the gjcolombo/rework-docs branch from 4816e78 to 50582e0 Compare May 9, 2025 02:37
Copy link
Contributor

@sudomateo sudomateo left a comment

Choose a reason for hiding this comment

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

I resolved the merge conflicts and the documentation looks good to me but I have not yet tried to use this windows-image-builder myself yet. @qdzlug I believe you tried to use this earlier this week. Would you be able to comment on these changes?

@sudomateo sudomateo requested a review from qdzlug May 9, 2025 03:00
@qdzlug
Copy link
Contributor

qdzlug commented May 29, 2025

Since this PR was opened, there have been a lot of changes to this repo - however, these changes do not impact this PR, primarily because we created a new adoc for the windows use case.

Will merge - #26 will track the cleanup.

@qdzlug qdzlug merged commit 2252c30 into main May 29, 2025
10 checks passed
@qdzlug qdzlug deleted the gjcolombo/rework-docs branch May 29, 2025 16:07
Copy link
Contributor

@qdzlug qdzlug left a comment

Choose a reason for hiding this comment

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

LGTM

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.

4 participants