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

[Merged by Bors] - Documentation Updates #2463

Closed
wants to merge 18 commits into from

Conversation

nekevss
Copy link
Member

@nekevss nekevss commented Nov 26, 2022

Submitting this as a draft for feedback/second opinions. This draft contains some changes to the documentation.

Quick Overview:

  • Potential Boa header for Boa's crates added to boa_engine.
  • Changes the wording to a lot of module headers (See builtins module and object/builtins module).
  • Updating built-in wrapper's code examples to use ? operator.
  • Adds the doc logo URL to a few crates that didn't have it.

The main idea of this draft is to move away from the "This module implements" wording as it feels a bit duplicative when listed under the Modules section (mainly focusing around changes in boa_engine to start).

While working on this, I had a question about whether we should be using JavaScript or ECMAScript in the Boa's documentation. We do seem to currently use both, and this draft uses JavaScript heavily in the wording.

@codecov
Copy link

codecov bot commented Nov 26, 2022

Codecov Report

Merging #2463 (02b9212) into main (8da46a9) will increase coverage by 0.20%.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             main    #2463      +/-   ##
==========================================
+ Coverage   52.50%   52.71%   +0.20%     
==========================================
  Files         332      330       -2     
  Lines       34924    34764     -160     
==========================================
- Hits        18338    18326      -12     
+ Misses      16586    16438     -148     
Impacted Files Coverage Δ
boa_ast/src/declaration/mod.rs 62.96% <ø> (ø)
boa_ast/src/declaration/variable.rs 74.41% <ø> (ø)
boa_ast/src/expression/identifier.rs 88.88% <ø> (ø)
boa_ast/src/expression/literal/mod.rs 70.00% <ø> (ø)
boa_ast/src/expression/literal/object.rs 26.62% <ø> (ø)
boa_ast/src/expression/mod.rs 49.51% <ø> (ø)
boa_ast/src/expression/operator/conditional.rs 84.00% <ø> (ø)
boa_ast/src/keyword.rs 59.61% <ø> (ø)
boa_ast/src/lib.rs 75.00% <ø> (ø)
boa_ast/src/position.rs 51.72% <ø> (-41.38%) ⬇️
... and 89 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

@raskad
Copy link
Member

raskad commented Nov 27, 2022

While working on this, I had a question about whether we should be using JavaScript or ECMAScript in the Boa's documentation. We do seem to currently use both, and this draft uses JavaScript heavily in the wording.

I'd say we should almost always use ECMAScript since we implement the ECMAScript standard.

@nekevss nekevss added the documentation update documentation label Nov 27, 2022
Copy link
Member

@raskad raskad left a comment

Choose a reason for hiding this comment

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

I like these changes so far. Making things more uniform is great.

boa_engine/src/builtins/iterable/mod.rs Outdated Show resolved Hide resolved
boa_engine/src/builtins/uri/mod.rs Outdated Show resolved Hide resolved
boa_engine/src/lib.rs Outdated Show resolved Hide resolved
@nekevss nekevss marked this pull request as ready for review November 30, 2022 19:36
@nekevss
Copy link
Member Author

nekevss commented Dec 1, 2022

Switched this from draft to review. I tried to make as much of the documentation as consistent as possible. Although, this ended up touching up the wording on a decent amount of files. 😅

@nekevss nekevss requested a review from RageKnify December 2, 2022 17:45
Copy link
Member

@Razican Razican left a comment

Choose a reason for hiding this comment

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

Thank you for the enhancements!

@Razican
Copy link
Member

Razican commented Dec 2, 2022

bors r+

bors bot pushed a commit that referenced this pull request Dec 2, 2022
<!---
Thank you for contributing to Boa! Please fill out the template below, and remove or add any
information as you feel necessary.
--->

Submitting this as a draft for feedback/second opinions. This draft contains some changes to the documentation.

Quick Overview:
  - Potential `Boa` header for Boa's crates added to `boa_engine`.
  - Changes the wording to a lot of module headers (See `builtins` module and `object/builtins` module).
  - Updating built-in wrapper's code examples to use `?` operator.
  - Adds the doc logo URL to a few crates that didn't have it.

The main idea of this draft is to move away from the "This module implements" wording as it feels a bit duplicative when listed under the Modules section (mainly focusing around changes in `boa_engine` to start).

While working on this, I had a question about whether we should be using JavaScript or ECMAScript in the Boa's documentation. We do seem to currently use both, and this draft uses JavaScript heavily in the wording.
@bors
Copy link

bors bot commented Dec 2, 2022

Pull request successfully merged into main.

Build succeeded:

@bors bors bot changed the title Documentation Updates [Merged by Bors] - Documentation Updates Dec 2, 2022
@bors bors bot closed this Dec 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation update documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants