Skip to content

Build Interactive Vega Visualizations in Verso with PowerShell - #377

Merged
HeyItsGilbert merged 1 commit into
PowerShellOrg:mainfrom
eosfor:article/verso-vega-notebook
Oct 15, 2026
Merged

HeyItsGilbert merged 1 commit into
PowerShellOrg:mainfrom
eosfor:article/verso-vega-notebook

Conversation

@eosfor

@eosfor eosfor commented Oct 12, 2026

Copy link
Copy Markdown
Contributor

Summary

  • explain how PowerShell data preparation and Vega/Vega-Lite specifications fit into Verso notebooks
  • walk through four saved visualizations from the Deneb Showcase notebook
  • show how the same HTML-producing helpers can target either a standalone report or a rich notebook cell
  • document practical notebook structure, saved-output behavior, and Viewer limitations

Validation

  • git diff --check upstream/main...HEAD
  • npm run build
  • npm run validate:articles
  • verified all four bundled screenshots and generated article assets
  • verified external links, the published prerequisite article route, and the notebook's saved widget count
  • parsed the adjacent PowerShell helper scripts without syntax errors

@netlify

netlify Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for powershellorg ready!

Name Link
🔨 Latest commit d112c34
🔍 Latest deploy log https://app.netlify.com/projects/powershellorg/deploys/6acd05040dcdc67572ad6e66
😎 Deploy Preview https://deploy-preview-377--powershellorg.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@HeyItsGilbert
HeyItsGilbert merged commit 95ee85b into PowerShellOrg:main Oct 15, 2026
5 checks passed
HeyItsGilbert added a commit that referenced this pull request Nov 3, 2026
## Summary

```text
.github/
└── instructions/
    └── articles.instructions.md   # applyTo: content/articles/**/*.md
GLOSSARY.md                        # new: AI slop, vibe coded, off-topic pitch
```

Path-specific Copilot custom instructions, scoped to community article
submissions only (layers on top of the existing repo-wide
`.github/copilot-instructions.md`, which both review surfaces already
apply alongside it). Copilot checks three categories on every article
PR:

```text
review(diff)
  if unsafe: destructive commands / credential harvesting / prompt injection / phishing links / CoC violations
    comment(quote, category)
  if AI slop: generic filler / no firsthand specificity / untested-looking code /
              re-explained docs / listicle padding / no PR validation evidence
    comment(quote, category)
  if off-topic: thin PowerShell content relative to self-promotion
    comment(quote, category)
  always: one triage summary comment — "Needs maintainer safety review: <category>"
  never: imply the PR is blocked or rejected — maintainer has final say
```

Built from:
- a grilling session settling scope, categories, and enforcement stance
(advisory-only, since Copilot code review can't block merges)
- the precedent in
[#265](#265 (comment)),
where "vibe coded"/off-topic pitch content was caught manually
- the last 9 accepted article PRs (#57–#377), which surfaced the
"Validation" section convention (tool versions, commands run, links
checked) as a concrete, checkable signal — now folded into the AI-slop
checklist

## Evidence

- `applyTo: "content/articles/**/*.md"` glob verified against the live
tree: matches 1,210 files, correctly including both article bodies and
`_index.md` listing pages (per explicit scoping call), no false matches
outside `content/articles/`.
- Frontmatter parses cleanly (`applyTo` is the only key, no YAML
errors).
- No permanent tests apply — this is a prose instructions file read by
GitHub's Copilot review surfaces, not executable code.

## Merge Danger

**Door:** Two-way — it's a markdown instructions file; edit or delete
anytime with no migration cost.

**Blast Radius:** Low. Only affects Copilot's own review comments on PRs
touching `content/articles/**/*.md`; no build, routing, or runtime
behavior changes. Worst case is a false-positive advisory comment, which
a maintainer can dismiss — Copilot has no merge/block authority.
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.

2 participants