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

Fix broken structure links in documentation #1612

Merged
merged 1 commit into from
Oct 2, 2021

Conversation

abhishekc-sharma
Copy link
Contributor

Found some broken links to some structures when perusing the documentation of Lexer and Parser.

@jedel1043 jedel1043 changed the title Fixing some broken structure links in the documentation Fix broken structure links in documentation Oct 2, 2021
@@ -108,7 +108,7 @@ pub enum TokenKind {

/// A keyword.
///
/// see: [`Keyword`](../keyword/enum.Keyword.html)
/// see: [`Keyword`](../../ast/keyword/enum.Keyword.html)
Copy link
Member

@jedel1043 jedel1043 Oct 2, 2021

Choose a reason for hiding this comment

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

Can you check if using directly Keyword and Punctuator fixes the links? Because IIRC, if the type is imported it should work.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Actually now that you mention it, it seems that by default rustdoc automatically links the struct inside the enum variant. The additional "see: " is not required".
Screenshot 2021-10-01 at 21-42-05 TokenKind in boa syntax lexer token - Rust

What I mean is that the green text in the above screenshot already links to the struct. Shall I remove the two explicit links that anyway seem redundant now ?

Copy link
Member

Choose a reason for hiding this comment

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

Yeah, you can remove them

Copy link
Member

@jedel1043 jedel1043 left a comment

Choose a reason for hiding this comment

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

Thanks!

@jedel1043 jedel1043 merged commit ffe20d8 into boa-dev:master Oct 2, 2021
@abhishekc-sharma abhishekc-sharma deleted the docs-fix branch October 2, 2021 05:41
@jedel1043 jedel1043 added bug Something isn't working documentation update documentation labels Oct 2, 2021
@jedel1043 jedel1043 added this to the v0.14.0 milestone Oct 2, 2021
@jedel1043 jedel1043 added Hacktoberfest Hacktoberfest 2021 - https://hacktoberfest.digitalocean.com and removed Hacktoberfest Hacktoberfest 2021 - https://hacktoberfest.digitalocean.com labels Oct 2, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation update documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants