Skip to content

chore: update contributing docs with latest uv setup#2479

Open
yosefAlsuhaibani wants to merge 2 commits intomainfrom
yosef/update-contrib-docs-uv
Open

chore: update contributing docs with latest uv setup#2479
yosefAlsuhaibani wants to merge 2 commits intomainfrom
yosef/update-contrib-docs-uv

Conversation

@yosefAlsuhaibani
Copy link
Contributor

@yosefAlsuhaibani yosefAlsuhaibani commented Jan 30, 2026

Thanks for improving Semgrep Docs 😀

Please ensure

  • A subject matter expert (SME) reviews the content
  • A technical writer reviews the content or PR
  • This change has no security implications or else you have pinged the security team
  • Redirects are added if the PR changes page URLs
  • If you have changed any header tag links (doc/#this-kind-of-anchor), update all instances of that link

Adding a new documentation page? Click to expand the checklist
  • Create .md or .mdx file in /docs/[section]/ with frontmatter: slug, title, description, displayed_sidebar, tags
  • Add page to appropriate sidebar in /sidebars.js (shows in side nav)
  • If adding the doc in a new directory: Update /src/theme/Navbar/Content/index.tsx → add path to getCurrentSection() (highlights top nav)

Sidebars fields for displayed_sidebar:
scanSidebar | rulewritingSidebar | devSidebar | learnSidebar | aboutSidebar | kbSidebar | whatsSemgrepSidebar

Top nav fields for getCurrentSection():
'scan' | 'write-rules' | 'learning-guides' | 'help' | 'explore'

@netlify
Copy link

netlify bot commented Jan 30, 2026

Deploy Preview for semgrep-docs-prod ready!

Name Link
🔨 Latest commit eb101ea
🔍 Latest deploy log https://app.netlify.com/projects/semgrep-docs-prod/deploys/697cc354d2ffac0007116f12
😎 Deploy Preview https://deploy-preview-2479--semgrep-docs-prod.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Collaborator

@khorne3 khorne3 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!

```

Next, initialize and enter the virtual environment. The following command installs developer dependencies, such as `pytest`, and installs `semgrep` in editable mode in the virtual environment. From the `cli` directory, run the following command:
Next, initialize the virtual environment. The following commands installs both the required dependencies and the developer dependencies, such as `pytest`, and installs `semgrep` in editable mode in the virtual environment. From the `cli` directory, run the following command:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Next, initialize the virtual environment. The following commands installs both the required dependencies and the developer dependencies, such as `pytest`, and installs `semgrep` in editable mode in the virtual environment. From the `cli` directory, run the following command:
Next, initialize the virtual environment. The following commands install both the required dependencies and the developer dependencies, such as `pytest`, and install `semgrep` in editable mode in the virtual environment. From the `cli` directory, run the following command:

By convention, your shell prompt is prepended with `(cli)` when the virtual environment is active.

Next, install the Python dependencies:
To execute `semgrep` in this virtual environiment, you could activate the virtual environment as follows:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
To execute `semgrep` in this virtual environiment, you could activate the virtual environment as follows:
To execute `semgrep` in the virtual environment, activate the virtual environment as follows:

## Run `semgrep-cli`

Ensure that you are in the `cli/` directory, and then issue the following command:
Ensure that you are in the `cli/` directory and that you have activated the virtual environment with the installed wheel, then issue the following command:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Ensure that you are in the `cli/` directory and that you have activated the virtual environment with the installed wheel, then issue the following command:
Ensure that you are in the `cli/` directory and that you have activated the virtual environment with the installed wheel. Then, run the following command:

@dijkstracula
Copy link
Contributor

Proposal: this should wait on https://github.com/semgrep/semgrep-proprietary/pull/5516 being approved, for any requested changes in that PR.

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.

3 participants