Skip to content
This repository has been archived by the owner on Nov 17, 2023. It is now read-only.

Add Python API docs for test_utils and visualization #12455

Merged
merged 5 commits into from
Sep 10, 2018

Conversation

aaronmarkham
Copy link
Contributor

@aaronmarkham aaronmarkham commented Sep 4, 2018

Description

Fixes #11412 - by adding missing modules to the docs coverage.

There appear to be several modules that are not included in the Python docs. This PR specifically addresses those mentioned in #11412 - test_utils and visualization.

I put these in a "tools" folder. It seemed to make sense.

Preview

http://34.201.8.176/versions/python_tools/api/python/index.html#tools

Comments

LMK what other missing APIs should go in the tools folder. There seem to be a lot of things in https://github.com/apache/incubator-mxnet/tree/master/python/mxnet that aren't covered. If someone wants to make an issue and tag me in it, I can handle those in another PR.

Something is wrong with the shorthand invocations. The way the docs pipeline is setup and the way Sphinx is reading things makes it so mxnet.viz doesn't work. Therefore only the long version mxnet.visualiztion is mentioned in these docs. This is similar to what I ran into with ONNX: #12318.

@aaronmarkham
Copy link
Contributor Author

@sandeep-krishnamurthy Could you provide some feedback on the other missing modules and whether docs/api/python/tools makes sense for the ones in this PR?

@sandeep-krishnamurthy
Copy link
Contributor

Thanks @aaronmarkham . This looks good to me and a very useful addition.
Apart from these utilities, im2rec and rec2idx are missing. But, it has bunch of other clean up to be done before making it part of API docs. Created the issue to track - #12501

@aaronmarkham - Can you please rebase this PR and we are good to go here.

Copy link
Contributor

@sandeep-krishnamurthy sandeep-krishnamurthy left a comment

Choose a reason for hiding this comment

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

LGTM.
Thanks.

@sandeep-krishnamurthy sandeep-krishnamurthy added the pr-awaiting-merge Review and CI is complete. Ready to Merge label Sep 10, 2018
@indhub indhub merged commit d789101 into apache:master Sep 10, 2018
aaronmarkham added a commit to aaronmarkham/incubator-mxnet that referenced this pull request Sep 11, 2018
* adding missing python modules as tools folder for docs

* adding missing python modules as tools folder for docs

* adjusted paths after testing build
anirudh2290 pushed a commit to anirudh2290/mxnet that referenced this pull request Sep 19, 2018
* adding missing python modules as tools folder for docs

* adding missing python modules as tools folder for docs

* adjusted paths after testing build
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
pr-awaiting-merge Review and CI is complete. Ready to Merge
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants