Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ai-based doc cleanup #155

Merged
merged 2 commits into from
Jul 14, 2024
Merged

ai-based doc cleanup #155

merged 2 commits into from
Jul 14, 2024

Conversation

iboates
Copy link
Collaborator

@iboates iboates commented Jun 24, 2024

Closes #46

This PR is actually very AI-heavy. I used ChatGPT to tidy up the existing docstrings and create ones where they were missing. I validated them afterwards and I found no problems. Despite this, I put a disclaimer on the API docs page because I believe that AI-generated contributions and content should always be disclosed.

Incidentally, the api docs page is currently broken. I built the docs locally and they seem to work now:

image

@iboates iboates requested review from iamtekson and Zeitsperre June 24, 2024 19:27
Copy link
Collaborator

@iamtekson iamtekson left a comment

Choose a reason for hiding this comment

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

Hi @iboates, Thanks for this PR. Overall it looks good. I suggest to somehow include the notes part in the code. If the note section is raising some issue, I suggest to move it up, in the starting section of the docstring.

Apart from that, it looks good to me.


Notes
Copy link
Collaborator

Choose a reason for hiding this comment

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

is it possible to preserve these notes?


Notes
-----
Copy link
Collaborator

Choose a reason for hiding this comment

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

Notes


Notes
-----
Copy link
Collaborator

Choose a reason for hiding this comment

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

Notes


Notes
-----
Copy link
Collaborator

Choose a reason for hiding this comment

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

notes


Notes
-----
The name of the style file will be, rasterName:workspace
Copy link
Collaborator

Choose a reason for hiding this comment

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

notes


Notes
Copy link
Collaborator

Choose a reason for hiding this comment

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

notes


Notes
Copy link
Collaborator

Choose a reason for hiding this comment

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

notes



Notes
-----
Copy link
Collaborator

Choose a reason for hiding this comment

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

notes


Notes
-----
Copy link
Collaborator

Choose a reason for hiding this comment

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

notes

@iboates
Copy link
Collaborator Author

iboates commented Jul 2, 2024

Hi @iboates, Thanks for this PR. Overall it looks good. I suggest to somehow include the notes part in the code. If the note section is raising some issue, I suggest to move it up, in the starting section of the docstring.

Apart from that, it looks good to me.

Sure, I also noticed that some of the nice organizational headers were removed by the almighty wise and all-knowing AI, I will put them back as well

@iboates
Copy link
Collaborator Author

iboates commented Jul 2, 2024

@iamtekson Restored the notes and other comments

@iboates
Copy link
Collaborator Author

iboates commented Jul 14, 2024

@iamtekson Do you have any more input? Or can I merge?

Copy link
Collaborator

@iamtekson iamtekson left a comment

Choose a reason for hiding this comment

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

Sorry for taking so long. Yes, it looks good to me! We can merge it now.

@iamtekson iamtekson merged commit 0713f8b into master Jul 14, 2024
5 checks passed
@iamtekson iamtekson deleted the sphinx-docs branch July 14, 2024 16:10
@iboates iboates mentioned this pull request Dec 10, 2024
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.

Use standard docstrings and sphinx-autodoc for documentation
2 participants