DOC: `pandas.json_normalize` missing from API Reference portion of documentation
See original GitHub issueLocation of the documentation
https://pandas.pydata.org/docs/dev/reference/api/pandas.json_normalize.html (currently responds with a 404 Not Found
)
Documentation problem
While the source code does contain API reference documentation for pandas.json_normalize
(previously pandas.io.json.json_normalize
) as seen in /pandas/io/json/_normalize.py
, it isn’t available in the documentation for the current version of pandas hosted on pandas.pydata.org
.
Suggested fix for documentation
At least one older version of pandas
does have documentation that includes a json_normalize
API reference under its old name (pandas.io.json.json_normalize
in v0.25.0), so it seems feasible that it was removed by accident when its old name was deprecated in v1.0.0. Attempting to visit pandas.io.json.json_normalize
in the current version of the documentation redirects to the new name (pandas.json_normalize
), which responds with a 404.
Issue Analytics
- State:
- Created 2 years ago
- Comments:5 (2 by maintainers)
Pandas 1.2.5 still had the API documentation available: https://pandas.pydata.org/pandas-docs/version/1.2.5/reference/api/pandas.json_normalize.html
Yet the latest version still has
json_normalize
documented in the User Guide section: https://pandas.pydata.org/docs/user_guide/io.html#normalizationThe missing API entry is surely a mistake then?
Thanks for following up on this @haakenlid - my comment above was incorrect (and is now edited). In 1.0.0 pandas.io.json_normalize was deprecated in favor of pandas.json_normalize
https://pandas.pydata.org/pandas-docs/version/1.0.0/whatsnew/v1.0.0.html#deprecations https://github.com/pandas-dev/pandas/pull/27615
So the commit you found was right in that it should be removed from io, but it needs to be added to the docs from pandas namespace. A PR to fix this is most welcome!