Skip to content

[DOCS] Add MDX Article: "Stream Ciphers vs Block Ciphers — A Practical Comparison" #255

Description

@Aakif-Kohari

Summary

The Docs module currently has no article comparing stream vs block cipher constructions, even though the visualizer will (pending #2/#4 above) contain examples of both. This article ties the concept together for learners moving between cipher demos.

What's missing

  • No MDX file in content/docs/ covering this comparison topic

Proposed content

  • New .mdx file with required Zod frontmatter fields (per repo's docs-module contract in CONTRIBUTING.md)
  • Covers: block vs stream construction, padding/IV handling, error propagation differences, when each is chosen in real protocols (TLS cipher suites as example), with backtick-tag auto-links to existing visualizer entries (e.g. `AES`, `XOR`) using the repo's existing auto-linking MDX plugin
  • Isolated file — does not touch registry.ts/types.ts/worker.ts, so no merge-conflict risk with issues 1–4

Acceptance criteria

  • Frontmatter validates against the docs Zod schema
  • Reading-time/TOC generation works without errors
  • Cipher backtick auto-links resolve correctly
  • Renders correctly in both dark and light mode

Assignment

I'd like to work on this issue under ECSoC26. Will open a PR only after approval/assignment by @csxark or another maintainer.

Metadata

Metadata

Assignees

Labels

ECSoC26Elite Coders Summer of Code 2026

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions