[PierreRaybaut]

Closes #519

Summary

A systematic comparison of the documentation of DataLab 1.4 with the application (and with the documentation of Sigima, SigimaX and DataLab-Web) found about 140 wrong or outdated statements. Some of them misled users (Web API security default, remote control from another computer, wrong formulas) or broke examples and commands (conda install datalab-platform, simple_macro.py, remotecontrol_py27.py, migration table names).

Changes

• Signal and image features: menu placement and exact labels, arithmetic operation, quadratic difference and amplitude normalization formulas, unsupported {zlabel}/{zunit} placeholders removed, contour and 2D peak detection result columns, annotations stored apart from metadata, file format tables generated from the Sigima registries, zero padding and frequency filters, missing entries (Web API, Quit, panels), validation pages (naming rules, test counts) and regenerated validation status files.
• Common features: the Processing tab recomputes the object in place (no History edit mode anymore), settings options and their default values (new options, restart required, AI Assistant, external editor), overview example, HDF5 browser commands, key features and introduction, DataLab-Capsule in the ecosystem pages, results equal "exactly or within the tolerance of the operation contract" across editions.
• Tutorials: menu paths and labels (File > Settings..., Analysis > Intensity profiles > Line profile..., Processing > Fitting > Interactive fitting > Multi-Gaussian fit...), plugin configuration and reload, data file names, removed Results button and annotation workflow; figures showing something else than described are removed (screenshots are refreshed in Outdated screenshots in tutorials and feature pages #520).
• Advanced features:
  • Web API: the localhost token bypass is enabled by default, with how to disable it and the security warning updated; NPZ metadata.json keys; DataLab-Kernel usage.
  • Remote control: limited to the local machine; methods missing from SimpleRemoteProxy; complete list of the supported methods.
  • Macros: no regular expressions, # DataLab template: title line, ~/.DataLab_v1/macro_templates, Conf.macro_* options, recovery file.
  • Migration table: dst_1_to_1, sigima.io.read_*/write_*, noise example.
  • Validation tests run with pytest --pyargs sigima -m validation; log files location.
• Plugins: DataLab-Web compatibility (distinct class in the datalab.web_plugins entry-point group, async callbacks and *_async helpers Web-only, Desktop features not supported in the browser, Plugin shim: support the Desktop registration model (register_computations, action_for) web#94), public API page (PluginCapability, recipe_binding, resources...), examples with correct helper signatures and selection conditions, catalog rules, test templates README.
• Installation and contributing: conda-forge package datalab, [qt] and [opencv] extras, develop branch for the development version, file names, WiX commands, line length and VS Code task names, branch names, roadmap and outreach facts, .github/copilot-instructions.md (action handler pattern, including the redefinition of a reopened built-in submenu, configuration package, plugin folder, contract versions of Sigima 1.4).
• Examples: macros/examples/simple_macro.py, doc/remotecontrol_py27.py, remote examples and notebooks, plugin examples.
• Docstrings rendered in the API pages (no behavior change).
• Release notes (Documentation since 1.4.0) and French translation of all the changed pages (56 catalogs; 9 of them were stored with wrapped lines and are now unwrapped, as produced by sphinx_intl update -w 0).

Validation

• Automated: HTML build (English) and French build with -W without warning; gettext extraction and sphinx_intl update after rebasing on develop leave the catalogs unchanged; docutils check of the changed pages (the build hides docutils warnings, see Documentation build hides reStructuredText syntax errors #521); Ruff clean on the 16 changed Python files; plugin example tests and macro tests passed; changed examples compiled; formats and menus checked against the registries and the regenerated menus.
• Manual: no manual scenario (documentation only); the related code fixes were validated in fix: restore missing menu entries, Web API remote port and AI settings state #523.

Out of scope

• Outdated screenshots in tutorials and feature pages #520: outdated screenshots (tutorials, settings, History panel).
• Documentation build hides reStructuredText syntax errors #521: the documentation build hides reStructuredText syntax errors.
• Web API: reconsider enabling the localhost token bypass by default #522: whether the Web API localhost bypass should stay enabled by default.
• Gaussian bandpass filter ignores the 'Inverse FFT result' parameter Sigima#123: the Inverse FFT result parameter of the Gaussian bandpass filter is ignored.
• The error message shown when the Web API dependencies are missing suggests a [webapi] extra that does not exist.

Related: #523 (code fixes found by the same review), DataLab-Platform/Sigima#124, DataLab-Platform/SigimaX#73, DataLab-Platform/web#95, DataLab-Platform/plugins#13

Assisted-by: Claude Opus 5.5