Skip to content

Update README and documentation#39

Closed
ardiloot wants to merge 5 commits intomasterfrom
feature/update-docs
Closed

Update README and documentation#39
ardiloot wants to merge 5 commits intomasterfrom
feature/update-docs

Conversation

@ardiloot
Copy link
Copy Markdown
Owner

  • Modernize README.md: add pre-commit badge, installation section, quick code example, development section, license
  • Fix Introduction.rst: complete publication Configure Renovate #2 reference (was 'TPB'), fix typos, update technical features for ARM support
  • Fix GettingStarted.rst: update Python requirement to >=3.10, fix ~15 typos throughout, replace placeholder nonlinear TMM examples with actual code

- Modernize README.md: add pre-commit badge, installation section,
  quick example, development section, fix typos
- Fix Introduction.rst: complete publication #2 reference (was 'TPB'),
  fix typos, update technical features for ARM support
- Fix GettingStarted.rst: update Python requirement to >=3.10,
  fix typos throughout, add second-order nonlinear TMM example
- Update copyright year to 2026 in conf.py
- Fix Texinfo placeholder description in conf.py
- Fix grammar and phrasing throughout GettingStarted.rst
- Fix 'physics are' -> 'physics is' in README.md
- 'physics are' → 'physics is' in Introduction.rst
- 'is named Kretschmann configuration' → 'is known as the Kretschmann configuration' in GettingStarted.rst
- Remove unnecessary article in 'both the plane waves and beams' in GettingStarted.rst
Inspired by GeneralTmm README structure:
- Add Python version and License badges
- Add hero image (Gaussian beam SPP excitation)
- Add 'See also' callout linking to GeneralTmm
- Add full Table of Contents
- Bold feature names with descriptions
- Add API Overview table (Material, TMM, SecondOrderNLTMM)
- Restructure examples with images (SPP, Gaussian beam, SHG)
- Add References section with blockquoted citations
- Expand Development section with subsections (Setup, Tests, Linting, CI table)
- Add Releasing section with setuptools-scm workflow
- Link License to LICENSE file
- Add setup schematic, SHG intensity, and thickness dependence panels to
  ExampleSecondOrderNonlinearTmm.py
- Add savefig to all three example scripts
- Add SHG example image and description to GettingStarted.rst
- Remove non-existent Material.FromFile from API table
- Fix Python version range: 3.10-3.14 (matches CI matrix)
- Fix CI table: show full Python version range
- Fix grammar: 'Same' → 'The same', add articles, add commas
- Use 'uv run pre-commit install' instead of 'uvx'
ardiloot added a commit that referenced this pull request Feb 20, 2026
- Overhaul README with badges, hero image, TOC, API table, examples with
  images, references, development/releasing sections, and CI overview
- Add 'See also' cross-reference to GeneralTmm
- Improve SHG example with setup schematic, intensity, and thickness panels
- Add savefig to all three example scripts and generate SHG image
- Fix typos and grammar across Introduction.rst and GettingStarted.rst
- Replace nonlinear TMM placeholder with literalinclude and image
- Update copyright year, Texinfo description, Python version to >=3.10
- Fix publication #2 citation (was truncated 'TPB')
@ardiloot ardiloot closed this Feb 20, 2026
@ardiloot ardiloot deleted the feature/update-docs branch February 20, 2026 20:31
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