Skip to content

DOC: added the link to array in string_arrow.py #50241

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

Merged
merged 8 commits into from
Dec 19, 2022
Merged

DOC: added the link to array in string_arrow.py #50241

merged 8 commits into from
Dec 19, 2022

Conversation

ramvikrams
Copy link
Contributor

@@ -85,7 +85,8 @@ class ArrowStringArray(ArrowExtensionArray, BaseStringArray, ObjectStringArrayMi

See Also
--------
array
`array
<https://pandas.pydata.org/docs/dev/reference/api/pandas.arrays.ArrowStringArray.html>`__
Copy link
Member

Choose a reason for hiding this comment

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

Only one underscore? Not sure but doc build is failing

Copy link
Contributor Author

@ramvikrams ramvikrams Dec 14, 2022

Choose a reason for hiding this comment

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

There are two underscores, this was on the sphinx site to have two underscores and the doc build fails if we have just one inderscore

Comment on lines 88 to 89
`array
<https://pandas.pydata.org/docs/dev/reference/api/pandas.arrays.ArrowStringArray.html>`__
Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks @ramvikrams! I think the intent here is for this to point to pandas.array instead of ArrowStringArray. Something like the suggestion below should handle that. It also will make it so the link always points to the version of the documentation page that's currently being used. As is, the link in this PR will point to the dev version of the docs.

Suggested change
`array
<https://pandas.pydata.org/docs/dev/reference/api/pandas.arrays.ArrowStringArray.html>`__
pandas.array

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes i'll do that

@@ -266,7 +266,8 @@ class StringArray(BaseStringArray, PandasArray):

See Also
--------
array
`array
<https://pandas.pydata.org/docs/reference/api/pandas.array.html>`__
Copy link
Member

Choose a reason for hiding this comment

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

Could you make this link without using a hyperlink i.e. the correct reference that sphinx will pick up?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I had a question I don't know about this way could you tell some doc where I can read about it

Copy link
Member

Choose a reason for hiding this comment

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

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks I'll check it out

Copy link
Member

Choose a reason for hiding this comment

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

Thanks could you render the docs to validate how this looks?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks could you render the docs to validate how this looks?

looks and works fine

Copy link
Member

Choose a reason for hiding this comment

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

Could you post a screenshot of the rendered docs?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Could you post a screenshot of the rendered docs?

yes

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Screenshot from 2022-12-20 02-43-03
Screenshot from 2022-12-20 02-43-11
Screenshot from 2022-12-20 02-43-19
Screenshot from 2022-12-20 02-43-43

Copy link
Contributor Author

@ramvikrams ramvikrams Dec 19, 2022

Choose a reason for hiding this comment

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

added the screenshot sorry it took time I was struggling on how to add screenshot and at last saw that we can attach files by dragging, I have also attached the screenshot of array page opening nicely when clicking array in the doc for ArrowStringArray and StringArray

@mroeschke mroeschke added the Docs label Dec 19, 2022
@mroeschke mroeschke added this to the 2.0 milestone Dec 19, 2022
@mroeschke mroeschke merged commit ca3e0c8 into pandas-dev:main Dec 19, 2022
@mroeschke
Copy link
Member

Thanks @ramvikrams

@ramvikrams
Copy link
Contributor Author

Thanks @ramvikrams

thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

DOC: Incorrect link in StringArray and ArrowStringArray docs
4 participants