Skip to content

docs : add plugin development walkthrough with example plugin#1221

Merged
utksh1 merged 3 commits into
utksh1:mainfrom
kavin553:docs-plugin-development-guide
Jun 24, 2026
Merged

docs : add plugin development walkthrough with example plugin#1221
utksh1 merged 3 commits into
utksh1:mainfrom
kavin553:docs-plugin-development-guide

Conversation

@kavin553

Copy link
Copy Markdown
Contributor

Description

This PR adds a dedicated plugin development walkthrough to help new contributors create and validate SecuScan plugins more easily.

Changes Made

  • Added "docs/plugins/plugin-development-walkthrough.md"
  • Included a step-by-step plugin creation guide
  • Added example "metadata.json" and "parser.py"
  • Documented plugin validation and checksum commands
  • Added references to the walkthrough from "README.md" and "PLUGINS.md"

Related Issues

Closes #1044

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update

How Has This Been Tested?

  • Reviewed the documentation flow from plugin creation to validation.
  • Verified that all referenced commands already exist in the repository.
  • Checked links and references added to "README.md" and "PLUGINS.md".

Checklist

  • My code follows the code style of this project.
  • I have performed a self-review of my own code.
  • I have commented my code, particularly in hard-to-understand areas.
  • I have made corresponding changes to the documentation.
  • My changes generate no new warnings.

@kavin553

Copy link
Copy Markdown
Contributor Author

Hi @utksh1 👋

I’ve completed the requested documentation update and opened a PR for review.

Included in this contribution

✅ Added a dedicated plugin development walkthrough

✅ Added example "metadata.json" and "parser.py"

✅ Documented validation and checksum workflows

✅ Added references from "README.md" and "PLUGINS.md"

This guide is intended to make onboarding easier for new contributors and GSSoC participants interested in developing SecuScan plugins.

Thank you for maintaining this project and for the opportunity to contribute. Looking forward to your feedback and review. 🚀

Welcome to any suggestions or improvements!

@utksh1 utksh1 merged commit 3ebc935 into utksh1:main Jun 24, 2026
6 of 7 checks passed
@utksh1 utksh1 added the gssoc:approved Admin validation: approved for GSSoC scoring label Jun 24, 2026
utksh1 added a commit that referenced this pull request Jun 25, 2026
, #1234, #1232, #1231, #1230, #1229, #1228, #1222, #1221, #1254, #1252, #1251, #1250, #1242, #1255, #1090, #1097, #1112)

Reverting all PR merges performed during this session to restore repository
to pre-session state. This reverts commits:
- e376276 (#1255)
- 18e5101 (#1222)
- e516dd5 (#1230)
- be400fa (#1235)
- d522e9a (#1243)
- bc0b1cd (#1090)
- de56660 (#1097)
- c2a5a53 (#1112)
- eb30d33 (#1254)
- f2a67f7 (#1250)
- 6579112 (#1251)
- 8751d92 (#1252)
- 3ebc935 (#1221)
- 6f5a936 (#1228)
- da15da4 (#1229)
- b66a5b0 (#1231)
- 775c5c2 (#1232)
- b529ddb (#1234)
- 965b001 (#1241)
- d46e573 (#1242)
- dd09955 (#1240)

All PRs are also being reopened and gssoc labels removed.
@utksh1 utksh1 added level:beginner 20 pts difficulty label for small beginner-friendly PRs type:docs Documentation work category bonus label area:docs Documentation or contributor guide work area:plugins Scanner plugin metadata, schemas, or plugin runtime work gssoc:approved Admin validation: approved for GSSoC scoring and removed gssoc:approved Admin validation: approved for GSSoC scoring labels Jun 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Documentation or contributor guide work area:plugins Scanner plugin metadata, schemas, or plugin runtime work gssoc:approved Admin validation: approved for GSSoC scoring level:beginner 20 pts difficulty label for small beginner-friendly PRs type:docs Documentation work category bonus label

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[DOCS] Add plugin development walkthrough with example plugin

2 participants