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

✨ feat: Add 'Improve Content' section to summary #159

Merged
merged 20 commits into from Jul 8, 2023
Merged

✨ feat: Add 'Improve Content' section to summary #159

merged 20 commits into from Jul 8, 2023

Conversation

sushma1031
Copy link
Contributor

@sushma1031 sushma1031 commented May 30, 2023

@sushma1031 sushma1031 changed the title feat: A section to improve the content of summaries feat: Section to improve the content of summaries May 30, 2023
@tusharnankani
Copy link
Member

Amazing work, @sushma1031
Can you share the final screenshot/screen recording of the page?

@sushma1031
Copy link
Contributor Author

@tusharnankani Will do!

@sushma1031
Copy link
Contributor Author

@tusharnankani I edited the pull request description to include the screen recording, let me know if everything's fine!

@tusharnankani
Copy link
Member

Looks perfect! +_+

Copy link
Member

@tusharnankani tusharnankani left a comment

Choose a reason for hiding this comment

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

Looks good to me.

Thank you so much for working on this and being so prompt, @sushma1031

Good work!

@sushma1031
Copy link
Contributor Author

I'm glad I could contribute! Thanks @tusharnankani & @HarshKapadia2 for guiding me through it :)

@HarshKapadia2 HarshKapadia2 linked an issue Jun 1, 2023 that may be closed by this pull request
@HarshKapadia2 HarshKapadia2 added enhancement New feature or request summary Related to OTC CatchUp session summaries labels Jun 1, 2023
Copy link
Member

@HarshKapadia2 HarshKapadia2 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 so much for the discussions and PR, @sushma1031!

These are some of the changes that I can think of. You can just directly commit most of them, unless you have further questions on any of them. Do let us know!

summary/individual-summary.adoc Outdated Show resolved Hide resolved
summary/individual-summary.adoc Outdated Show resolved Hide resolved
summary/individual-summary.adoc Outdated Show resolved Hide resolved
summary/combined-summary.adoc Outdated Show resolved Hide resolved
summary/combined-summary.adoc Outdated Show resolved Hide resolved
summary/static/css/summary-style.css Outdated Show resolved Hide resolved
@sushma1031
Copy link
Contributor Author

I'll work on the changes @HarshKapadia2 , thanks for letting me know

Refine body content and apply styling to link of second improve button
Modify "View source on Github" link
Modify "View the source on Github" to link content of the sessions
Use 'em' in improve content section styles
@sushma1031
Copy link
Contributor Author

sushma1031 commented Jun 1, 2023

@HarshKapadia2 Done with the changes 👍

Copy link
Member

@HarshKapadia2 HarshKapadia2 left a comment

Choose a reason for hiding this comment

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

Looks good to me!

Thank you so much for contributing, @sushma1031! Thank you for being prompt as well!

@HarshKapadia2
Copy link
Member

We'll just wait for @KartikSoneji to review the PR as well, as he wanted a particular change with converting classes to IDs, so that we're able to link to those sections using hash fragments.

@HarshKapadia2
Copy link
Member

Also just a note @sushma1031, that you can directly commit review suggestions by clicking the 'Commit suggestion' button below them. You don't need to manually commit them. (Note that the person who suggests does get co-authorship.)

@sushma1031
Copy link
Contributor Author

sushma1031 commented Jun 2, 2023

Thank you so much for contributing, @sushma1031! Thank you for being prompt as well!

My pleasure!

We'll just wait for @KartikSoneji to review the PR as well, as he wanted a particular change with converting classes to IDs, so that we're able to link to those sections using hash fragments.

All right.

Also just a note @sushma1031, that you can directly commit review suggestions by clicking the 'Commit suggestion' button below them. You don't need to manually commit them. (Note that the person who suggests does get co-authorship.)

Ah, all right, I did notice that feature but I wasn't sure if I should use it or not, thanks for letting me know!

summary/combined-summary.adoc Outdated Show resolved Hide resolved

[.improve-buttons]
* link:https://github.com/OurTechCommunity/catchup/tree/main/summary/sessions[Edit these summaries on GitHub.^]
* link:https://github.com/OurTechCommunity/catchup/issues/new?title=Improve%20Combined%20Summary&body=%3E%20Please%20describe%20the%20issue%20with%20the%20summary%20content%20and%20the%20changes%20to%20be%20made.[Report the content issue.^]
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
* link:https://github.com/OurTechCommunity/catchup/issues/new?title=Improve%20Combined%20Summary&body=%3E%20Please%20describe%20the%20issue%20with%20the%20summary%20content%20and%20the%20changes%20to%20be%20made.[Report the content issue.^]

Do we need to worry about content issues?
Content issues (outdated, deprecated, incorrect information) can appear on docs pages, but I don't think they apply here.

Copy link
Member

Choose a reason for hiding this comment

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

Oh alright. I mean Content in this context could literally mean, the content of the summary.

We can rename that Issue. So, they can report any issue; if they do not want to edit the summaries directly and just point out any issue.

What do you think? I think it is a valid Action.

Copy link
Member

Choose a reason for hiding this comment

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

Hmm ok, that would make more sense.

Comment on lines 31 to 42
[.improve-heading]
Want to improve the content of this page?

[.improve-buttons]
* link:https://github.com/OurTechCommunity/catchup/tree/main/summary/sessions/{catchup_display_number}[Edit this summary on GitHub.^]
* link:https://github.com/OurTechCommunity/catchup/issues/new?title=Improve%20Summary%20No.%20{catchup_display_number}&body=%3E%20Please%20describe%20the%20issue%20with%20the%20summary%20content%20and%20the%20changes%20to%20be%20made.[Report the content issue.^]
* link:https://github.com/OurTechCommunity/catchup/blob/main/summary/sessions/{catchup_display_number}[View the source on GitHub.^]


[.contribute]
Want to get more involved? link:https://github.com/OurTechCommunity/catchup/blob/main/CONTRIBUTING.md[Learn how to contribute.^]

Copy link
Member

Choose a reason for hiding this comment

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

Same changes as above.

summary/static/css/summary-style.css Outdated Show resolved Hide resolved
@tusharnankani tusharnankani removed the summary Related to OTC CatchUp session summaries label Jun 12, 2023
@sushma1031
Copy link
Contributor Author

sushma1031 commented Jun 12, 2023

All right, I'll make the requested changes.

Just to clarify, these are the changes to be made:

  1. Change 0.94em to 1em
  2. Change [.improve-heading] to [#improve-content]
  3. Rename the second link ("Report the content issue") to "Report the issue."

If I've gotten anything wrong, please let me know.

@sushma1031
Copy link
Contributor Author

@KartikSoneji Made the requested changes. It now appears like this:
image

image

@tusharnankani
Copy link
Member

Looks good.

@KartikSoneji, please let us know if we are good to go.

@HarshKapadia2
Copy link
Member

Thank you so much, @sushma1031 and sorry for the delay in merging the PR!

@HarshKapadia2 HarshKapadia2 changed the title feat: Section to improve the content of summaries ✨ feat: Add 'Improve Content' section to summary Jul 8, 2023
@HarshKapadia2 HarshKapadia2 merged commit ae639b0 into OurTechCommunity:main Jul 8, 2023
2 of 3 checks passed
@sushma1031
Copy link
Contributor Author

I'm glad I could help, and thanks for all the guidance! 😊

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

feat: A button to edit/make the summary better via PRs..
4 participants