Summary
Remove the two remaining per-document :::{bibliography} blocks so the docs fully conform to the centralized-bibliography convention introduced by #834.
Background
PR #834 ("docs: fix Sphinx build warnings") consolidated all per-document bibliography blocks into a single global page at docs/source/references.rst, in order to eliminate bibtex.duplicate_citation and bibtex.duplicate_label warnings. Most notebooks/docs were migrated at the time, but two files still carry their own local bibliography directive:
Inline {cite:p} / {cite:t} citations in both files already resolve correctly against the global bibliography, so deleting the trailing :::{bibliography} directive is a pure cleanup with no behavioural impact.
Scope
- Remove the trailing
## References cell (containing only :::{bibliography} + :filter: docname in docnames + :::) from panel_fixed_effects.ipynb. Use notebook-aware tooling (nbformat, Jupyter, or the IDE notebook UI) so the JSON stays valid.
- Remove the equivalent
## References section + :::{bibliography} block at the bottom of sensitivity_checks.md.
- Re-execute
panel_fixed_effects.ipynb end-to-end in the CausalPy env after the edit so the saved cell outputs match the new structure. Without a fresh run, the version checked in to git can render inconsistently on the remote ReadTheDocs build (stale outputs, mismatched cell numbering, etc.). sensitivity_checks.md is plain markdown and does not need execution.
Acceptance criteria
Notes
Summary
Remove the two remaining per-document
:::{bibliography}blocks so the docs fully conform to the centralized-bibliography convention introduced by #834.Background
PR #834 ("docs: fix Sphinx build warnings") consolidated all per-document bibliography blocks into a single global page at
docs/source/references.rst, in order to eliminatebibtex.duplicate_citationandbibtex.duplicate_labelwarnings. Most notebooks/docs were migrated at the time, but two files still carry their own local bibliography directive:docs/source/notebooks/panel_fixed_effects.ipynb(added in AddPanelRegressionexperiment class for fixed effects estimation #628, after docs: fix Sphinx build warnings #834 merged)docs/source/notebooks/sensitivity_checks.md(lines 181–183)Inline
{cite:p}/{cite:t}citations in both files already resolve correctly against the global bibliography, so deleting the trailing:::{bibliography}directive is a pure cleanup with no behavioural impact.Scope
## Referencescell (containing only:::{bibliography}+:filter: docname in docnames+:::) frompanel_fixed_effects.ipynb. Use notebook-aware tooling (nbformat, Jupyter, or the IDE notebook UI) so the JSON stays valid.## Referencessection +:::{bibliography}block at the bottom ofsensitivity_checks.md.panel_fixed_effects.ipynbend-to-end in theCausalPyenv after the edit so the saved cell outputs match the new structure. Without a fresh run, the version checked in to git can render inconsistently on the remote ReadTheDocs build (stale outputs, mismatched cell numbering, etc.).sensitivity_checks.mdis plain markdown and does not need execution.Acceptance criteria
grep -rn ":::{bibliography}" docs/source/notebooks docs/source/knowledgebasereturns no matches.panel_fixed_effects.ipynbre-executed end-to-end in theCausalPyconda env; saved outputs are fresh.$CONDA_EXE run -n CausalPy make html(run fromdocs/) builds cleanly with no new warnings introduced and (ideally) nobibtex.duplicate_citationwarnings emitted by these two files.prek run --all-filespasses (notablyvalidate-notebooksfor the.ipynbchange).{cite:p}/{cite:t}citations in both files still render correctly and link to the global references page.Notes
feature/sc-design-workflowthat removed the same kind of cell fromsc_pymc.ipynb(commitba9c8d9).$CONDA_EXE run -n CausalPy jupyter nbconvert --to notebook --execute --inplace docs/source/notebooks/panel_fixed_effects.ipynb. Ifvalidate-notebooksfails afterward, follow the recovery steps inAGENTS.md.