Skip to content

Rewrite the README for users - #30

Merged
xtofalex merged 1 commit into
mainfrom
readme-user-friendly
Oct 13, 2026
Merged

xtofalex merged 1 commit into
mainfrom
readme-user-friendly

Conversation

@xtofalex

Copy link
Copy Markdown
Contributor

The command-line section was a dense paragraph that rendered badly on GitHub, and the README read as developer notes more than as a guide for someone who wants to use the viewer.

  • Quick start first: Colab notebooks, pip install + naja_schematic.show(), the naja-schematic --open browser server, the desktop app
  • Features say what each one does for the user (gate symbols, overlaid traces, growing the schematic, Show Sources, diagnoses, SVG export)
  • Command-line options: one table comparing the desktop app and the browser server, whose flag shapes differ; source-path lookup explained with an example
  • Headless SVG export (--export/--trace/--equipotential/--focus) documented; it was missing
  • Controls: same entries as Help > Keyboard Shortcuts, mouse first
  • Building from source: Linux package list pointer, a working browser-viewer example; dropped the outdated server example that served a "default canned" design (a design is now required)
  • Architecture, status and issue reporting condensed

Checked with GitHub's markdown renderer: no stray backticks, 5 tables.

🤖 Generated with Claude Code

Lead with a quick start (Colab, pip + notebook, browser, desktop app),
describe features by what they do, and put both CLIs' options in one
table instead of a dense paragraph that rendered badly. Document the
headless SVG export, list the Linux build packages, and drop the
outdated 'default canned design' server example (a design is required).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@xtofalex
xtofalex merged commit f03f45e into main Oct 13, 2026
5 checks passed
@xtofalex
xtofalex deleted the readme-user-friendly branch October 13, 2026 11:47
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.

1 participant