Skip to content

docs: only use type annotations for documentation - #1709

Merged
nejch merged 5 commits into
mainfrom
docs/sphinx-annotations
Dec 1, 2021
Merged

docs: only use type annotations for documentation#1709
nejch merged 5 commits into
mainfrom
docs/sphinx-annotations

Conversation

@nejch

@nejch nejch commented Nov 24, 2021

Copy link
Copy Markdown
Member

We probably still have a lot of incorrect types in the docstrings and this should just take care of it in the future.

Before After
image image

Clashes with the internal extension though so needs more work

@nejch
nejch marked this pull request as draft November 24, 2021 20:07
@JohnVillalovos

Copy link
Copy Markdown
Member

Looks cool! Thanks for this. I'll review once you mark it ready for review.

@nejch
nejch force-pushed the docs/sphinx-annotations branch from e262867 to af0cb4d Compare November 28, 2021 17:41
@nejch

nejch commented Nov 28, 2021

Copy link
Copy Markdown
Member Author

Turns out I was just using an outdated external module but it's now part of autodoc so it was just a matter of adding a flag. This looks a bit more like the original now, but pulls typehints from code. Should be ready now.

@nejch
nejch marked this pull request as ready for review November 28, 2021 17:43
@nejch
nejch requested a review from JohnVillalovos November 28, 2021 17:43

@JohnVillalovos JohnVillalovos left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm okay to merge it as is.

Thanks for doing this.

Comment thread docs/conf.py Outdated
Comment thread gitlab/client.py Outdated
@nejch
nejch requested a review from JohnVillalovos December 1, 2021 00:06

@JohnVillalovos JohnVillalovos left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me.

Please merge whenever you want to.

@nejch
nejch merged commit 2708f91 into main Dec 1, 2021
@nejch
nejch deleted the docs/sphinx-annotations branch December 1, 2021 06:35
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.

2 participants