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鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add a button in the UI to access documentation page #404

Merged

Conversation

AgniveshChaubey
Copy link
Collaborator

@AgniveshChaubey AgniveshChaubey commented Aug 19, 2023

@AgniveshChaubey AgniveshChaubey temporarily deployed to PyPI August 19, 2023 18:46 — with GitHub Actions Inactive
@@ -111,6 +111,15 @@ const NavBar = () => {
</li>
</ul>
</div>
<button id="docs" className="btn btn-sm btn-secondary border-0 me-1">
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is id attribute necessary?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Not necessary, but it's good practice to keep it.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Why is it a good practice? I think I've never heard of that. What are the advantages?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Although the button text in our code indicates its purpose for documentation, the 'id' attribute can also serve as a form of documentation. It's beneficial for SEO as well, even though we are not currently focusing on that aspect in our case.

I don't see any issues with it, but I'll remove it if you want :)

Copy link
Collaborator

Choose a reason for hiding this comment

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

TBH I tried to find something on the web that confirms ids affect SEO, but without much luck - if you have any source on that I'll be happy to have a look.

PS I'm genuinely curious about your motives here and not trying to push anything, so there is no need to remove this id

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

These points were discussed in a course (Full-Stack Web Development with React Specialization) offered by Hong Kong University on Coursera. TBH, I didn't cross-verify them as SEO wasn't my primary focus. I didn't place significant emphasis on it and simply included the 'id' attribute based on the information from that course. (considering it as a good practice)馃槂

@AgniveshChaubey AgniveshChaubey merged commit dc8cd02 into bowtie-json-schema:main Aug 21, 2023
18 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