Skip to content

Document correct signature for Instruments#4413

Merged
bors[bot] merged 2 commits intomicrosoft:masterfrom
jenshnielsen:sphinx_instrument_document_init
Jul 25, 2022
Merged

Document correct signature for Instruments#4413
bors[bot] merged 2 commits intomicrosoft:masterfrom
jenshnielsen:sphinx_instrument_document_init

Conversation

@jenshnielsen
Copy link
Copy Markdown
Collaborator

Fixes #4370 by not using custom metaclass when documenting to work around sphinx documenting call rather than init

This feels like a bit of a hack so not sure if its ok. Inspired by https://stackoverflow.com/questions/20843737/check-if-sphinx-doc-called-the-script

@jenshnielsen jenshnielsen force-pushed the sphinx_instrument_document_init branch from fcc5e59 to 0fe9a83 Compare July 24, 2022 16:24
@codecov
Copy link
Copy Markdown

codecov bot commented Jul 24, 2022

Codecov Report

Merging #4413 (69bb763) into master (d38994c) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##           master    #4413   +/-   ##
=======================================
  Coverage   68.38%   68.39%           
=======================================
  Files         275      276    +1     
  Lines       31021    31023    +2     
=======================================
+ Hits        21215    21217    +2     
  Misses       9806     9806           

@jenshnielsen jenshnielsen force-pushed the sphinx_instrument_document_init branch from b4c1349 to 0698846 Compare July 24, 2022 17:08
Don't use custom metaclass when documenting to work around sphinx documenting __call__ rather than __init__
@jenshnielsen jenshnielsen force-pushed the sphinx_instrument_document_init branch from a4d45cd to f27b4d1 Compare July 25, 2022 12:54
@jenshnielsen jenshnielsen added the docs Related to docs improvements label Jul 25, 2022
@jenshnielsen
Copy link
Copy Markdown
Collaborator Author

bors merge

@bors bors bot merged commit 7d495b0 into microsoft:master Jul 25, 2022
@jenshnielsen jenshnielsen deleted the sphinx_instrument_document_init branch July 25, 2022 15:40
@jenshnielsen jenshnielsen added this to the Public api rewrite milestone Aug 2, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Related to docs improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Instruments are documented with unhelpful init signature

2 participants