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

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 aaronmarkham requested a review from szha as a code owner September 4, 2018 19:42
@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

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

@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