JohnDoedid/atoms
Live in productionan editable essay.
An editable essay.
No GitHub topics on this repo.
- HTML100.0%
1 Review
Atoms is a compact, creative experiment that combines a long-form science essay with browser-based collaborative editing. The single-file design makes it easy to inspect and deploy. The essay is divided into clear sections covering particle physics, atomic structure, excitation, ionization, exotic atoms, condensed matter, plasmas, and extreme environments. Semantic headings, lists, and tables give the material useful structure. The editing system supports rich-text or raw HTML changes, records editor names and line counts, reloads the latest version before editing, and provides a basic sanitizer. Applying CC0 also clearly communicates an intent to let others reuse and improve the work.
The largest problem is that editing has no real authentication or moderation boundary. The Pantry API address is embedded in the public JavaScript and accepts browser-side PUT requests, so anyone who finds the page or source can overwrite the essay and editor history. Requesting a name and email does not verify identity, and every submitted email is displayed publicly. This should move behind a small server API with authenticated accounts, revision history, approval controls, rate limiting, backups, and a privacy notice. The sanitizer removes scripts, event handlers, sources, and several embedded elements, but it still allows dangerous values such as javascript: links and should be replaced with a maintained allowlist-based sanitizer.
The scientific presentation also needs review. Formulas contain LaTeX-style commands that the page does not render, one table displays the charm-quark symbol as a copyright sign, and some broad statements would benefit from citations and expert verification. The current HTML removes the character-set declaration, duplicates the title element, lacks a mobile viewport setting, and hotlinks its social image and favicon from another website without documenting reuse rights. The README provides only one sentence and does not explain deployment, editing behavior, data storage, or security risks. There are no automated checks or workflows. Overall, Atoms is an interesting editable-document prototype with substantial written content. Secure editing, source citations, clearer documentation, and basic HTML validation would make it far more dependable.
