Skip to content

Improved constraints + doc migration - #400

Merged
rozyczko merged 28 commits into
developfrom
polarized_channels
Sep 1, 2026
Merged

Improved constraints + doc migration#400
rozyczko merged 28 commits into
developfrom
polarized_channels

Conversation

@rozyczko

@rozyczko rozyczko commented Aug 31, 2026

Copy link
Copy Markdown
Member

This pull request migrates the documentation system from Sphinx to MkDocs (Material), updates the documentation structure and build process, and introduces new and expanded documentation for constraints, Bayesian analysis, and other API topics. It also updates changelogs and tutorials to reflect new features and conventions, such as parameter constraints and usage of .min/.max instead of .bounds. The Sphinx build workflow and related files are removed.

Documentation system migration and workflow changes:

  • Removed the Sphinx-based documentation build system and workflow, including docs/Makefile, the legacy Sphinx tree, and the .github/workflows/documentation-build.yml workflow. Documentation is now built and deployed using MkDocs (Material) via docs.yml and configured in docs/mkdocs.yml.
  • Updated the documentation style guide in .github/copilot-instructions.md to require NumPy-style docstrings and MkDocs for documentation builds, replacing Sphinx/reStructuredText references.

New and expanded documentation:

  • Added new API reference pages for constraints, inequality constraints, Bayesian analysis, calculators, parameter limits, LayerMagnetism, ORSO, summary, and plotting, and updated the main API index to reference these.
  • Added new tutorials to the navigation, including "Constraints & Inequalities" and "Bayesian Fitting".

@rozyczko rozyczko added [scope] enhancement Adds/improves features (major.MINOR.patch) [priority] high Should be prioritized soon enhancement labels Aug 31, 2026
@codecov

codecov Bot commented Aug 31, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 94.86804% with 35 lines in your changes missing coverage. Please review.
✅ Project coverage is 93.97%. Comparing base (d674b2b) to head (6343837).

Files with missing lines Patch % Lines
src/easyreflectometry/project.py 92.26% 15 Missing ⚠️
src/easyreflectometry/inequality_constraints.py 94.00% 12 Missing ⚠️
src/easyreflectometry/orso_utils.py 55.55% 4 Missing ⚠️
src/easyreflectometry/constraints.py 96.38% 3 Missing ⚠️
src/easyreflectometry/fitting.py 98.59% 1 Missing ⚠️
Additional details and impacted files

Impacted file tree graph

@@             Coverage Diff             @@
##           develop     #400      +/-   ##
===========================================
+ Coverage    93.69%   93.97%   +0.28%     
===========================================
  Files           51       54       +3     
  Lines         4519     5177     +658     
===========================================
+ Hits          4234     4865     +631     
- Misses         285      312      +27     
Flag Coverage Δ
integration 39.11% <36.21%> (-0.32%) ⬇️
unittests 93.97% <94.86%> (+0.28%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
src/easyreflectometry/__init__.py 88.88% <100.00%> (+13.88%) ⬆️
src/easyreflectometry/_bumps_constraints.py 100.00% <100.00%> (ø)
src/easyreflectometry/analysis/bayesian.py 97.05% <100.00%> (+<0.01%) ⬆️
src/easyreflectometry/model/model.py 97.46% <100.00%> (+0.47%) ⬆️
src/easyreflectometry/model/model_collection.py 88.00% <100.00%> (+6.05%) ⬆️
...syreflectometry/sample/assemblies/base_assembly.py 99.03% <100.00%> (+0.46%) ⬆️
.../easyreflectometry/sample/assemblies/multilayer.py 100.00% <100.00%> (ø)
...ctometry/sample/assemblies/repeating_multilayer.py 97.29% <ø> (ø)
src/easyreflectometry/summary/summary.py 90.40% <100.00%> (ø)
src/easyreflectometry/utils.py 70.45% <100.00%> (+3.01%) ⬆️
... and 5 more
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

The merge of develop (2042778) left two files with damaged conflict
resolutions: magnetism.ipynb gained a corrupt hybrid cell (invalid
notebook JSON, duplicate cell id) and project.py gained a duplicated
copy of the spin-asymmetry method block with an orphaned method body.
Both files are restored to the branch-side version, which already
contained everything develop had for them.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@rozyczko rozyczko changed the title Polarized channels Improved constraints + doc migration Aug 31, 2026
@rozyczko
rozyczko merged commit c869e63 into develop Sep 1, 2026
51 of 52 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement [priority] high Should be prioritized soon [scope] enhancement Adds/improves features (major.MINOR.patch)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant