connorgoggins edited a comment on issue #17798: [Website 2.0] Versioned 
Dropdown for Python API Docs
URL: 
https://github.com/apache/incubator-mxnet/issues/17798#issuecomment-597314221
 
 
   @leezu after discussing with @sojiadeshina, we decided that it's ok to have 
the setup instructions (build from source) only apply to master. Unique 
installation instructions (not building from source) for individual versions of 
MXNet are already supported and showcased on the website (for example, 
[installation instructions for 
v0.11.0](https://mxnet.apache.org/get_started?version=v0.11.0&platform=linux&language=python&processor=cpu&environ=pip&;)).
   
   Regarding the content at https://mxnet.apache.org/features, creating a 
working version of each of the current code samples for the old releases of 
MXNet would not be possible. For example, the Horovod feature code example for 
distributed training is based on functionality only recently added to MXNet. If 
we were to add a general website dropdown, we would need to create entirely new 
feature code samples for each version, which would be outside the scope of this 
project.
   
   We scoped this project by prioritizing the minimum but most critical 
functionality that is broken today for any MXNet user coming to the website, 
with a maximum project duration of 4 weeks. Since >80% of MXNet developers use 
the Python API, it was decided that the project should focus on versioning the 
Python API docs. As mentioned above, a general website dropdown would require 
additional supporting content for each version (such as the [features 
page](https://mxnet.apache.org/features)), necessitating a more extended 
timeline and continued support/maintenance once the project is completed. The 
general website dropdown is something that can be added to the list of Future 
Work projects for Website 2.0, but I believe that the most critical priority 
(and the focus of this project) should remain fixing the Python API docs as 
soon as possible.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to