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

Adjust the language used in some of the documentation #31583

Merged
merged 11 commits into from Mar 8, 2024

Conversation

six-shot
Copy link
Contributor

@six-shot six-shot commented Mar 8, 2024


  • ./mach build -d does not report any errors
  • ./mach test-tidy does not report any errors
  • These changes do not require tests because they just update docs.

@six-shot six-shot changed the title Six shot Fixed various inaccuracies and inconsistencies in the documentation Mar 8, 2024
Comment on lines 17 to 20
* [surfman](https://github.com/servo/webxr/blob/main/webxr/glwindow/mod.rs#L448-L452) is a crate that abstracts away platform-specific details of OpenGL hardware-accelerated rendering
* a [surface](https://doc.servo.org/surfman/platform/unix/default/surface/type.Surface.html) is a hardware buffer that are tied to a specific OpenGL context
* a [surface texture](https://doc.servo.org/surfman/platform/unix/default/surface/type.SurfaceTexture.html) is an OpenGL texture that wraps a surface. Surface textures can be shared between OpenGL contexts.
* a [surfman context](https://doc.servo.org/surfman/platform/unix/default/context/type.Context.html) represents a particular OpenGL context, and is backed by platform-specific implementations (such as EGL on Unix-based platforms)
Copy link
Member

Choose a reason for hiding this comment

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

I don't think it makes sense to capitalize surfman here since the name of the project starts with lower-case letter.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

i Would fix it now sir

Comment on lines 3 to 4
This document provides an overview of Servo's style system. For more extensive details, refer to the [style doc comments][style-doc], or the [Styling
Overview][wiki-styling-overview] in the wiki, which includes a conversation between
Copy link
Member

Choose a reason for hiding this comment

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

Please try to preserve the line length here.

README.md Outdated Show resolved Hide resolved
@@ -11,7 +11,7 @@ Only arguments that need more explanation will be documented here.

# Run
## Enable Experimental Features
Use `--pref` to enable experimental features like experimental DOM API, JavaScript API and CSS properties.
Use `--pref` to enable experimental features like the experimental DOM API, JavaScript API and CSS properties.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Use `--pref` to enable experimental features like the experimental DOM API, JavaScript API and CSS properties.
Use `--pref` to enable experimental features like experimental DOM APIs, JavaScript APIs and CSS properties.

docs/components/webxr.md Outdated Show resolved Hide resolved
@mrobinson mrobinson changed the title Fixed various inaccuracies and inconsistencies in the documentation Adjust the language used in some of the documentation. Mar 8, 2024
@mrobinson mrobinson changed the title Adjust the language used in some of the documentation. Adjust the language used in some of the documentation Mar 8, 2024
six-shot and others added 4 commits March 8, 2024 13:15
Copy link
Contributor Author

@six-shot six-shot left a comment

Choose a reason for hiding this comment

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

Fixed them all already

docs/COMMAND_LINE_ARGS.md Outdated Show resolved Hide resolved
@mrobinson mrobinson added this pull request to the merge queue Mar 8, 2024
Merged via the queue into servo:main with commit 0327d46 Mar 8, 2024
9 checks passed
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.

None yet

2 participants