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

doc: Be consistent with use of the "sudo" - v2 #9568

Closed
wants to merge 2 commits into from

Conversation

0xEniola
Copy link
Contributor

@0xEniola 0xEniola commented Oct 5, 2023

Make sure these boxes are signed before submitting your Pull Request -- thank you.

Link to redmine ticket: https://redmine.openinfosecfoundation.org/issues/5720

Previous PR: #9552

Describe changes:

  • Incorporate feedback from last PR.
  • Added Important notes to inform users it is required to install sudo in order to successfully follow instructions.
  • Removed the added sudo commands added to some instructions where sudo was not needed.

Included the "sudo" command to commands that need to be executed with the super-user privilege.
- Added `Important` notes to inform users the `sudo` command is required to be installed in order to properly follow instructions.

Ticket [5720](https://redmine.openinfosecfoundation.org/issues/5720)
@github-actions
Copy link

github-actions bot commented Oct 5, 2023

NOTE: This PR may contain new authors:

0xEniola <41842835+0xEniola@users.noreply.github.com>
Daniel Olatunji - danielolatunji20@outlook.com <41842835+0xEniola@users.noreply.github.com>

@codecov
Copy link

codecov bot commented Oct 5, 2023

Codecov Report

Merging #9568 (d6875f4) into master (9157070) will decrease coverage by 0.01%.
The diff coverage is n/a.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #9568      +/-   ##
==========================================
- Coverage   82.20%   82.20%   -0.01%     
==========================================
  Files         968      968              
  Lines      274275   274275              
==========================================
- Hits       225461   225460       -1     
- Misses      48814    48815       +1     
Flag Coverage Δ
fuzzcorpus 64.05% <ø> (ø)
suricata-verify 60.93% <ø> (-0.02%) ⬇️
unittests 62.87% <ø> (-0.01%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Copy link
Member

@inashivb inashivb left a comment

Choose a reason for hiding this comment

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

Hi!
Thank you for your first contribution to our project. :)

  1. I believe the changes requested in the previous PR here: Install: Be consistent with use of the "sudo" - v1 #9552 (comment) are yet to be incorporated in this one.
  2. Please keep your commit history clean.

doc/userguide/install.rst Show resolved Hide resolved
@inashivb inashivb added the outreachy Contributions made by Outreachy applicants label Oct 6, 2023
@@ -90,18 +90,20 @@ Rust support::
Ubuntu/Debian
"""""""""""""

.. Important:: The following instructions require `sudo` be installed.
Copy link
Member

Choose a reason for hiding this comment

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

This doesn't appear to be a valid Sphinx directive, whereas .. note:: is. I think we want note.
2023-10-06T09:11:46,082466777-06:00

Copy link
Contributor Author

@0xEniola 0xEniola Oct 6, 2023

Choose a reason for hiding this comment

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

I found it on a link(rst docs on sourceforge) I was directed to via Sphinx's docs.

And I saw that .. Important:: defines that the instruction has to be followed for the work to be successful.

But I'll change it to .. note:: now.

Thanks.

@jasonish

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
outreachy Contributions made by Outreachy applicants
4 participants