Skip to content

Latest commit

 

History

History
58 lines (40 loc) · 2.34 KB

File metadata and controls

58 lines (40 loc) · 2.34 KB

Contributing

Scope

This repository is a static browser playground for the Multilingual Programming Language. It is intentionally small: one HTML entry point, static assets, and a lightweight release check script.

Before you change anything

  1. Read README.md.
  2. Keep this repo aligned with the current target multilingualprogramming version.
  3. Prefer small, reviewable changes over broad rewrites.

Project structure

Development expectations

  • Preserve the browser-only deployment model. Do not introduce a server dependency unless explicitly intended.
  • Keep language options and examples aligned. If you add or remove a supported language, update both the selector in index.html and the example maps in assets/examples.js.
  • Keep metadata coherent. If copy or publish URLs change, review sitemap.xml, robots.txt, and site.webmanifest.
  • Prefer ASCII in comments and UI chrome unless non-ASCII text is user content, a language example, or a real requirement.

Validation

Run this before opening a release-oriented change:

python tools/check_release.py --expected-date YYYY-MM-DD

Also do a manual browser pass on:

  • language switching
  • example switching
  • run / clear / share actions
  • Python, WAT / WASM, and Rust tabs
  • theme toggle
  • keyboard navigation
  • mobile or narrow-screen layout

Changelog and release docs

  • Update CHANGELOG.md for user-visible or maintenance-significant changes.
  • Use RELEASE.md when preparing a release summary or publish checklist.

Pull request guidance

Include:

  • what changed
  • why it changed
  • how you validated it
  • whether metadata or release docs were updated