Skip to content

Fix documentation warnings#395

Merged
ElliottKasoar merged 2 commits intostfc:mainfrom
ElliottKasoar:fix-docs
Jan 30, 2025
Merged

Fix documentation warnings#395
ElliottKasoar merged 2 commits intostfc:mainfrom
ElliottKasoar:fix-docs

Conversation

@ElliottKasoar
Copy link
Member

I think some changes introduced in #350 resulted in various new documentation warnings being raised, possibly (but I don't think entirely) related to the version bump for sphinx, as I'm not sure why I didn't see them sooner.

This resolves two types of warning e.g.:

  1. WARNING: py:class reference target not found: Dynamics [ref.class], requiring changes/updates to the nitpick ignore, as we have in the past
  2. WARNING: duplicate object description of janus_core.calculations.phonons.Phonons.write_force_constants, other instance in apidoc/janus_core, use :no-index: for one of them. In most cases, these are class methods, which we already document slightly inconsistently, so for now I've just removed them. Other solutions are probably available (e.g. the suggestion from the warning)

@ElliottKasoar ElliottKasoar added the documentation Improvements or additions to documentation label Jan 30, 2025
@ElliottKasoar ElliottKasoar merged commit 88907dd into stfc:main Jan 30, 2025
9 checks passed
@ElliottKasoar ElliottKasoar deleted the fix-docs branch January 30, 2025 14:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants