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

Updating Contributing guidelines and copy-pastable code #2642

Merged
merged 3 commits into from
Jun 4, 2024

Conversation

h4l0gen
Copy link
Contributor

@h4l0gen h4l0gen commented May 25, 2024

Description of the changes being introduced by the pull request:
This will make easier to copy commands

Fixes #2637

Signed-off-by: h4l0gen <ks3913688@gmail.com>
@coveralls
Copy link

coveralls commented May 25, 2024

Pull Request Test Coverage Report for Build 9258634612

Details

  • 0 of 0 changed or added relevant lines in 0 files are covered.
  • No unchanged relevant lines lost coverage.
  • Overall coverage remained the same at 97.588%

Totals Coverage Status
Change from base Build 9223895839: 0.0%
Covered Lines: 1462
Relevant Lines: 1487

💛 - Coveralls

@h4l0gen
Copy link
Contributor Author

h4l0gen commented May 25, 2024

Hi @jku , we only need to add sphinx_copybutton extension. Also I've changed CONTRIBUTING.rst and remove $ so that we can paste them directly to terminal. PTAL. Thank you!

@@ -6,3 +6,4 @@
# install sphinx and its extensions
sphinx
sphinx-rtd-theme
sphinx-copybutton
Copy link
Member

Choose a reason for hiding this comment

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

This does add a new doc build dependency, which @jku expressed his reservations about: #2637 (comment)

I don't have strong objections, but I also don't think the copy button is such a big win.

Copy link
Member

Choose a reason for hiding this comment

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

Yeah no strong feelings either. It's true it's not a runtime dependency and it's just one small thing that gets installed when you run tox. The list of things we install is long already so this doesn't change the situation much... but I don't think we should add developer dependencies without good reason -- and the copy button doesn't feel like a very important one.

The other changes seem good. I would say remove the copybutton references and we'll merge it

Copy link
Contributor Author

Choose a reason for hiding this comment

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

That's okay @lukpueh @jku I understands your POV. BTW I've got this idea just to fulfill last point criteria in this heading of CNCF assessment, so that we don't miss this criteria in future. But if you like, I will remove that, and merge other changes, WDYT?
Thank you 👍

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@jku @lukpueh I've made changes, can we merge it now?
Thank you👍

Signed-off-by: Kapil Sharma <ks3913688@gmail.com>
Signed-off-by: Kapil Sharma <ks3913688@gmail.com>
@h4l0gen h4l0gen changed the title adding copy button Updaging Contributing guidelines May 27, 2024
@h4l0gen h4l0gen changed the title Updaging Contributing guidelines Updagting Contributing guidelines May 27, 2024
@h4l0gen h4l0gen changed the title Updagting Contributing guidelines Updating Contributing guidelines May 27, 2024
@h4l0gen h4l0gen changed the title Updating Contributing guidelines Updating Contributing guidelines and copy-pastable code May 29, 2024
@jku jku merged commit 292fb0f into theupdateframework:develop Jun 4, 2024
15 checks passed
@jku
Copy link
Member

jku commented Jun 4, 2024

thanks, squashed and merged.

shubhusion pushed a commit to shubhusion/python-tuf that referenced this pull request Jun 17, 2024
…mework#2642)

* Make commands easier to copy

Signed-off-by: h4l0gen <ks3913688@gmail.com>
Signed-off-by: Kapil Sharma <ks3913688@gmail.com>
Signed-off-by: shubhusion <shubham27.sharma03@gmail.com>
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.

Make Implementations command/code copy-pastable
4 participants