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

Added Overview And usage for ktooltip.vue component #789

Closed
wants to merge 5 commits into from

Conversation

sruthin21
Copy link

FIXED ISSUE - #694

I Added Overview Section to KTooltip documentation page
with a brief introduction on what the component is for.
I Added Usage Section with sub-sections:-
1.The basic usage with an example code snippet that includes reference and refs
2. A visualization of the disabled state
3. A visualization of all supported placements
4. A visualization of maxWidth

[

Screen.Recording.2024-09-13.024929.mp4

@sruthin21
Copy link
Author

@MisRob please review this Pull request

@MisRob
Copy link
Member

MisRob commented Sep 23, 2024

Thanks @sruthin21

@MisRob MisRob self-requested a review September 23, 2024 06:57
@MisRob MisRob self-assigned this Sep 23, 2024
Copy link
Member

@MisRob MisRob left a comment

Choose a reason for hiding this comment

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

I'm sorry it took me such a long time to review @sruthin21. This is a solid basis, thank you! Here's a few issue I've noticed I'd like to ask you to address:

KTooltip-Kolibri-Design-System

Also posting a few code comments regarding wording.

And lastly, would you fix linting issues?


<DocsPageTemplate apiDocs />
<DocsPageSection title="Overview" anchor="#overview">
The KTooltip component is a Vue component used to display tooltips or hints when a user hovers over a specific element.
Copy link
Member

@MisRob MisRob Oct 10, 2024

Choose a reason for hiding this comment

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

Suggested change
The KTooltip component is a Vue component used to display tooltips or hints when a user hovers over a specific element.
The KTooltip component displays a tooltip when a user hovers over a specific element.

</DocsPageSection>

<DocsPageSection title="Usage" anchor="#usage">
<h4>Use Of Ref And Reference</h4>
Copy link
Member

@MisRob MisRob Oct 10, 2024

Choose a reason for hiding this comment

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

Suggested change
<h4>Use Of Ref And Reference</h4>
<h4>Use of <code>ref</code> and <code>reference</code></h4>

We don't capitalize titles, more here https://design-system.learningequality.org/writing/#punctuation

Would you update other section titles too?

</KTooltip>
<button ref="myButton">Learn More</button>
</DocsShowCode>
<p>In this example, the `ref` attribute is used to create a reference to the `myButton` element, and the `reference` prop is used to associate the tooltip with this reference.</p>
Copy link
Member

Choose a reason for hiding this comment

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

Instead of using the ` character, such as in `ref`, would you use <code> in all places on this page? This will ensure it is rendered as code in the generated documentation.

@MisRob
Copy link
Member

MisRob commented Nov 8, 2024

Hi @sruthin21, are you planning to come back to this at some point?

@sruthin21
Copy link
Author

Hi @MisRob ,

Yes, I absolutely plan to come back to this! I apologize for the delay—I was tied up with my semester exams at college, which limited my availability to contribute.

Thank you so much for your patience. I'll work on resolving this issue within the next 2-3 days.

@MisRob
Copy link
Member

MisRob commented Nov 19, 2024

No problem at all @sruthin21, we just need to check-in from time to time, so we don't accidentally close something people want to return to. There's absolutely no pressure around this task, so feel free to come back whenever you can. Hoping your exams went well and get some rest :)!

@sruthin21
Copy link
Author

Thank you so much for understanding! 😊 I really appreciate the flexibility and support. My exams went well I’ll check back on this task soon. Thanks again for the patience and encouragement! 🙌

@MisRob
Copy link
Member

MisRob commented Nov 27, 2024

Hi @sruthin21, are you still planning some updates or would you like me to re-review? Also note that the link check is failing.

@sruthin21 sruthin21 closed this by deleting the head repository Dec 1, 2024
@MisRob
Copy link
Member

MisRob commented Dec 2, 2024

Hi @sruthin21, by deleting your fork, unfortunately we won't be able to finish this PR. I will unassign you from #694, but feel free to message us and re-open if you'd like.

@MisRob MisRob mentioned this pull request Dec 2, 2024
6 tasks
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.

2 participants