Skip to content

docs: list every search and repair stale search docs and citations (search-extensibility A0c) - #1669

Merged
Jammy2211 merged 2 commits into
mainfrom
feature/search-ext-a0c-fit-repair
Oct 8, 2026
Merged

Jammy2211 merged 2 commits into
mainfrom
feature/search-ext-a0c-fit-repair

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Summary

Search documentation and citation repair for the search-extensibility epic, phase A0c part 1 (PyAutoFit#1668). docs/api/searches.rst now lists all 15 searches (Nautilus, NSS, Drawer and the four MultiStart optimisers were missing); the search cookbook gains a Nautilus section and no longer claims to cover "every search"; the non_linear config README and configs.md stop describing per-search YAML files that do not exist (only GridSearch.yaml lives there); installation/source.md uses editable installs instead of the missing requirements.txt files; the citation files drop the MultiNest/PyMultiNest ghosts and add blackjax, optax, prodigy and Nautilus, with the sqlite2020 key fixed. Docs-only: no source changes.

API Changes

None. Documentation and citation files only.

Test Plan

  • sphinx-build -b html locally: succeeds (32 pre-existing warnings; one new from the NSS docstring now being rendered, tracked for A0b)
  • grep -ri "pyswarms\|multinest" docs/ files/ empty
  • GitHub docs legs green (RTD is red on the known autonerves floor, judge from the GitHub legs)
Full API Changes (for automation & release notes)

Removed

  • none

Added

  • none

Migration

  • none

Generated by the PyAutoLabs agent workflow.

🤖 Generated with Claude Code

- docs/api/searches.rst: add Nautilus, NSS, Drawer and MultiStartAdam /
  ADABelief / Lion / Prodigy, so all 15 exported searches are listed
  (autosummary stubs are generated at build time).
- docs/cookbooks/search.md: add a Nautilus section between DynestyStatic
  and LBFGS; say the cookbook covers a selection of searches and link the
  API reference for the full list.
- config/non_linear/README.md, docs/general/configs.md: only
  GridSearch.yaml lives there; per-search defaults are constructor
  arguments since #1202.
- docs/installation/source.md: requirements.txt files no longer exist; use
  pip install -e PyAutoFit / -e "PyAutoFit[optional]".
- files/citations.{bib,md}, files/citation.tex: drop MultiNest and
  PyMultiNest, add BlackJAX, optax and Prodigy, add Nautilus to the .md and
  .tex, use the sqlite2020 key that the .bib defines.

Refs #1668

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
… the docstring

Listing NSS in docs/api/searches.rst made the docs build render this
docstring, where docutils reported 'Unexpected indentation'.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@Jammy2211
Jammy2211 merged commit 8bb5f6e into main Oct 8, 2026
4 checks passed
@Jammy2211
Jammy2211 deleted the feature/search-ext-a0c-fit-repair branch October 8, 2026 08:04
@Jammy2211 Jammy2211 removed the pending-release PR queued for the next release build label Oct 16, 2026
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