Skip to content
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

Updates to the getting started sections of the openvmm developer guide #216

Merged
merged 1 commit into from
Oct 30, 2024

Conversation

mattkur
Copy link
Contributor

@mattkur mattkur commented Oct 30, 2024

This is a collection of several small changes to the OpenVMM developer guide. I am setting up a new clone of this environment and following the instructions in linear order. What prompted me to first make this change is that I encountered an error running cargo xflowey restore-packages: it seemed to need a linker. I found going "out of order" a bit jarring. Since the same core dependencies are required to build OpenVMM and OpenHCL (I think), and we expect contributors to set up their environment first, I moved this up. And, I noticed a broken link.

  • Fix broken link to the contributing guide.
  • Move the Linux compiler / linker prereqs to the Linux / WSL2 setup page. These are necessary before the xflowey restore.
  • Use the fancy new admonish plugin for the cross compile tip.

* Move the Linux compiler / linker prereqs to the Linux / WSL2 setup page. These are necessary before the xflowey restore.
* Use the fancy new admonish plugin for the cross compile tip.
@mattkur mattkur requested a review from a team as a code owner October 30, 2024 18:50
@mattkur mattkur merged commit 78d50d6 into microsoft:main Oct 30, 2024
22 checks passed
@@ -43,6 +43,23 @@ over to it.

Please follow the [official instructions](https://www.rust-lang.org/tools/install) to do so.

## \[Linux] Additional Dependencies
Copy link
Contributor

Choose a reason for hiding this comment

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

there was intentionality behind having this section live in build_openvmm rather than in getting_started/linux.

Namely: these deps are only needed when building openvmm, but not openhcl. build-igvm will make sure all necessary apt commands are invoked as part of the build... but since there is no equivalent tool for openvmm, this manual invocation is required. (tihs is what the restore-packages comment alluded to).

I might look into reverting this move in a future PR, and rewriting some of the comments to better communicate intent behind this organization

@mattkur mattkur deleted the minor-doc-updates branch February 7, 2025 22:54
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.

3 participants