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

visualization docs don't line up with tutorials usage of viz #13232

Closed
aaronmarkham opened this issue Nov 12, 2018 · 1 comment · Fixed by #13291
Closed

visualization docs don't line up with tutorials usage of viz #13232

aaronmarkham opened this issue Nov 12, 2018 · 1 comment · Fixed by #13291
Labels

Comments

@aaronmarkham
Copy link
Contributor

Description

When visualization is mentioned in tutorials it is always done like mx.viz.plot or similar. It is never done as mx.visualization. However, our API reference only has mx.visualization and the .viz. option isn't mentioned.

We have this issue around any kind of shortcut/redirect naming throughout the project.

Sphinx is unable to use the shortcut names for some reason. It has to use the full path. I don't know if this is a configuration issue or by design.

Either way the docs should line up with usage examples. We shouldn't have tutorials that have usage that is never covered in the reference docs. We shouldn't have reference docs that don't have any usage examples.

Similar issue in ONNX: #12318

@mxnet-label-bot add [Doc]
@vdantu

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

Successfully merging a pull request may close this issue.

3 participants