Skip to content

Conversation

@RenfengLiu
Copy link
Collaborator

No description provided.

wangra-google
wangra-google previously approved these changes Dec 9, 2025
@RenfengLiu RenfengLiu requested a review from GrantComm December 9, 2025 19:31
@RenfengLiu RenfengLiu enabled auto-merge (squash) December 9, 2025 19:37

### macOS

- Install build dependencies: `brew install cmake ninja python`
Copy link
Collaborator

Choose a reason for hiding this comment

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

This is the "##Environment Variables" section, I think we have platform independent prerequisites installation stuff under "#Prerequisites". I would suggest doing a bit of restructuring:

# Prerequisites

## Dependencies
General overview here
### Windows
### Linux
move the section "On Linux, set up environment variables for building GFXReconstruct as explained..."
### macOS
your new special info here for "brew install"

## Environment Variables
### Windows
### Linux
### macOS
your new section on env vars

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Personally, if I'm developing on Linux or MacOS, I'd prefer everything related to that platform at one places and in execution order. so that I can copy paste the commands, instead of read the whole doc and find each related sections, and worry about if I missing something somewhere

Copy link
Collaborator

Choose a reason for hiding this comment

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

Then I think maybe:

# Prerequisites
General overview
## Windows
## Linux
## macOS
specific instructions and env vars

Personally, if I'm developing on Linux or MacOS, I'd prefer everything related to that platform at one places and in execution order. so that I can copy paste the commands, instead of read the whole doc and find each related sections, and worry about if I missing something somewhere

But I will point out that this is the current organizational structure of the BUILD.md and the README.md. The docs do not have everything related to a platform at one place: we are branching the platform-dependent stuff as the lowest level header usually. If you want to do a rearrangement that's fine but I think it should be applied consistently.

@RenfengLiu RenfengLiu disabled auto-merge December 9, 2025 19:50
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