Skip to content

docs: add local testing steps to NestBot development guide#4440

Merged
arkid15r merged 3 commits intoOWASP:mainfrom
satvikp-coder:patch-2
Apr 11, 2026
Merged

docs: add local testing steps to NestBot development guide#4440
arkid15r merged 3 commits intoOWASP:mainfrom
satvikp-coder:patch-2

Conversation

@satvikp-coder
Copy link
Copy Markdown
Contributor

@satvikp-coder satvikp-coder commented Mar 30, 2026

Closes #4333

Summary

Adds missing local testing instructions to the NestBot Development section in CONTRIBUTING.md.

Changes

  • Added Testing NestBot Locally subsection
  • Included make logs command for checking Django events

Checklist

  • Documentation only change
  • No new dependencies added
  • Improves contributor onboarding experience

STOP AND READ BEFORE SUBMITTING! REMOVE THIS PARAGRAPH BEFORE OPENING THE PR

Thank you for your interest in contributing to OWASP Nest!

Before starting any work, all external contributors must first be assigned to an issue in the repository.
This is a mandatory step in the OWASP Nest workflow and ensures that effort is coordinated, approved, and tracked properly.

Exception: OWASP leaders are not required to follow this rule —- just make sure your username is included in the exception list.

If you were not assigned to the issue you are trying to resolve, stop right now and do NOT create this PR.
Unassigned pull requests are automatically closed by our workflows — please don't waste your time.

If you want to be assigned on any available issue, comment on it and wait for confirmation from the maintainers or project leads.

Proposed change

Resolves #(put the issue number here)

Add the PR description here.

Checklist

  • Required: I followed the contributing workflow
  • Required: I verified that my code works as intended and resolves the issue as described
  • Required: I ran make check-test locally: all warnings addressed, tests passed
  • I used AI for code, documentation, tests, or communication related to this PR

Closes OWASP#4333

## Summary
Adds missing local testing instructions to the NestBot 
Development section in CONTRIBUTING.md.

## Changes
- Added Testing NestBot Locally subsection
- Included make logs command for checking Django events

## Checklist
- [x] Documentation only change
- [x] No new dependencies added
- [x] Improves contributor onboarding experience
@github-actions github-actions bot added the docs Improvements or additions to documentation label Mar 30, 2026
cubic-dev-ai[bot]
cubic-dev-ai bot previously approved these changes Mar 30, 2026
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 30, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: ccc97d2a-53dd-4bd6-a530-6f7b929c22c7

📥 Commits

Reviewing files that changed from the base of the PR and between be4ee45 and 3f1ca9d.

📒 Files selected for processing (1)
  • CONTRIBUTING.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • CONTRIBUTING.md

Summary by CodeRabbit

  • Documentation
    • Improved setup instructions with clearer wording
    • Expanded Slack application configuration guidance for local development
    • Added local testing section with smoke-testing procedures and logging verification

Walkthrough

Updated CONTRIBUTING.md: corrected setup phrasing, expanded Slack app configuration instructions to replace production URLs in the NestBot Slack manifest with the ngrok base URL for slash commands, event subscriptions, and interactivity, and added a "Testing NestBot Locally" section with smoke-test steps and ngrok/logging guidance.

Changes

Cohort / File(s) Summary
Documentation
CONTRIBUTING.md
Fixed wording ("To setup" → "To set up"); added instructions to replace production URLs in the NestBot Slack manifest with the ngrok base URL for slash commands, event subscriptions, and interactivity (request_url); added "Testing NestBot Locally" subsection describing smoke tests (run make run, start ngrok start NestBot), check backend container logs to confirm Slack delivery, and note that ngrok must remain running during testing.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

  • kasya
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: adding local testing steps to the NestBot development guide documentation.
Description check ✅ Passed The description is related to the changeset, mentioning the issue closure (#4333), the added Testing NestBot Locally subsection, and the make logs command.
Linked Issues check ✅ Passed The PR successfully addresses all coding requirements from issue #4333: adds Testing NestBot Locally subsection, includes make logs command for Django inspection, and provides local testing verification steps.
Out of Scope Changes check ✅ Passed All changes in CONTRIBUTING.md are within scope—updated setup wording, Slack configuration instructions, and the Testing NestBot Locally section all directly support the linked issue objectives.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
CONTRIBUTING.md (1)

275-275: Use a fenced bash block for make logs for reliable rendering.

At Line 275, make logs is currently plain indented text. Wrapping it in a fenced bash block will render consistently and improve copy/paste usability.

Suggested docs diff
-   make logs
+   ```bash
+   make logs
+   ```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CONTRIBUTING.md` at line 275, Wrap the plain indented command make logs in a
fenced bash code block in CONTRIBUTING.md so it renders and copies correctly;
replace the current indented line containing make logs with a triple-backtick
bash block (```bash), the make logs line, and a closing triple-backtick (```) to
ensure consistent formatting and syntax highlighting.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CONTRIBUTING.md`:
- Line 267: Add a blank line before the markdown heading "### Testing NestBot
Locally" to satisfy markdownlint MD022; locate the heading text and insert an
empty line directly above it so the subsection is separated from the preceding
list content.

---

Nitpick comments:
In `@CONTRIBUTING.md`:
- Line 275: Wrap the plain indented command make logs in a fenced bash code
block in CONTRIBUTING.md so it renders and copies correctly; replace the current
indented line containing make logs with a triple-backtick bash block (```bash),
the make logs line, and a closing triple-backtick (```) to ensure consistent
formatting and syntax highlighting.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: a7a19db9-7348-43ff-bb03-2a719b07172f

📥 Commits

Reviewing files that changed from the base of the PR and between 9ddb464 and be4ee45.

📒 Files selected for processing (1)
  • CONTRIBUTING.md

Comment thread CONTRIBUTING.md Outdated
@sonarqubecloud
Copy link
Copy Markdown

@arkid15r arkid15r enabled auto-merge April 11, 2026 01:33
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

0 issues found across 1 file (changes from recent commits).

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 11, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.05%. Comparing base (4fc1ca9) to head (3f1ca9d).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #4440   +/-   ##
=======================================
  Coverage   99.05%   99.05%           
=======================================
  Files         527      527           
  Lines       16882    16882           
  Branches     2372     2320   -52     
=======================================
  Hits        16723    16723           
  Misses         91       91           
  Partials       68       68           
Flag Coverage Δ
backend 99.50% <ø> (ø)
frontend 97.78% <ø> (ø)

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


Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4fc1ca9...3f1ca9d. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@arkid15r arkid15r added this pull request to the merge queue Apr 11, 2026
Merged via the queue into OWASP:main with commit 2d46251 Apr 11, 2026
38 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add local testing steps to NestBot development guide

2 participants