-
Notifications
You must be signed in to change notification settings - Fork 4.9k
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
Overhaul Main Workflow Docs #107415
Overhaul Main Workflow Docs #107415
Conversation
…xed a couple spelling and grammatical mistakes.
…ements one, and got far enough on the Windows requirements one.
…nd fixed a few broken links.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it's useful right off the bat to establish that for some workflows cross-compilation is the expected approach.
…oss-compiling to the general workflow introduction segment.
…/or outdated details.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for putting this together!
…g to make the docs more friendly and clear as per received feedback.
* Started the Quality Week work of improving the workflow docs. * Made more progress on the general workflow README doc, as well as the CoreCLR one. * Rephrased some things to make them roll off the tongue better, and fixed a couple spelling and grammatical mistakes. * Basically finished the main workflow README, and the CoreCLR building docs. * Almost done with the CoreCLR building docs, finished the MacOS requirements one, and got far enough on the Windows requirements one. * Finished the first pass on the Windows requirements doc. * Finished the first pass of the Linux Environment Requirements. * Finished the first pass of the Linux requirements doc. * Made good progress on the 'Using Docker' new doc. * Finished the first pass of the Using Docker doc. * Initial merging of the new docs with the existing documentation. * Improved the redaction of some sentences, improved some formatting, and fixed a few broken links. * Forgot to commit a NativeAOT note. * Removed the cross signs in the tables and added general info about cross-compiling to the general workflow introduction segment. * Added some redaction improvements, and corrected a few misleading and/or outdated details. * Linked the Workflow's README to the CoreCLR Building README. * Added a few additional details, and improved some wording and phrasing to make the docs more friendly and clear as per received feedback. * Fixed typo in the -DCLR_CMAKE_APPLE_DYSM=TRUE flags.
* Started the Quality Week work of improving the workflow docs. * Made more progress on the general workflow README doc, as well as the CoreCLR one. * Rephrased some things to make them roll off the tongue better, and fixed a couple spelling and grammatical mistakes. * Basically finished the main workflow README, and the CoreCLR building docs. * Almost done with the CoreCLR building docs, finished the MacOS requirements one, and got far enough on the Windows requirements one. * Finished the first pass on the Windows requirements doc. * Finished the first pass of the Linux Environment Requirements. * Finished the first pass of the Linux requirements doc. * Made good progress on the 'Using Docker' new doc. * Finished the first pass of the Using Docker doc. * Initial merging of the new docs with the existing documentation. * Improved the redaction of some sentences, improved some formatting, and fixed a few broken links. * Forgot to commit a NativeAOT note. * Removed the cross signs in the tables and added general info about cross-compiling to the general workflow introduction segment. * Added some redaction improvements, and corrected a few misleading and/or outdated details. * Linked the Workflow's README to the CoreCLR Building README. * Added a few additional details, and improved some wording and phrasing to make the docs more friendly and clear as per received feedback. * Fixed typo in the -DCLR_CMAKE_APPLE_DYSM=TRUE flags.
This PR aims to make the experience of the Workflow documentation of the runtime repo simpler and more accessible to the general public.
A summary of the changes made in this PR:
Ideas for follow-up work (in this PR and/or other subsequent PR's):