new website, docs code freeze

[Aaron Markham <aa...@gmail.com>]

Hi everyone,
The last two PRs [1][2] for the new website and docs have passed CI
(finally). Please do not make changes to /docs or /ci until we get
these approved and merged. Every time there's a merge conflict it has
set us back a day or two while shepherding the PRs through CI again.
Unless there are catastrophic issues discovered in a review, I
recommend that we hold any patches or updates to the PRs to follow-up
PRs.

There are four steps to launch:
1. Once the PRs are approved, the plan is to merge 15885 to delete the
old content first.
2. Then immediately merge 15883 to add in the new CI flows and updates
to the content Thomas and I have already had merged in 15884 [3].
3. I will change the website validation Jenkins pipeline to point to
the new pipeline.
4. I will change the website publishing Jenkins pipeline to point to
its new pipeline as well. Once triggered, the old site will be
replaced with the new one.

Post launch we'll need to update the DNS for beta.mxnet.io to point to
production, and there will likely be some redirect/.htaccess updates
needed next week to assist with any deep linking and 404 issues that
pop up.

Cheers,
Aaron

[1] https://github.com/apache/incubator-mxnet/pull/15885
[2] https://github.com/apache/incubator-mxnet/pull/15883
[3] https://github.com/apache/incubator-mxnet/pull/15884

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

Update on the docs:

@Tao see comments on your PR for what needs to be updated in the docs for
the release.

Soji (thanks a lot) just contributed a big improvement to the docs. The doc
coverage is now at ~100%, which an improvement compared to the previous
website.
This should be taking care of all or most of the issues around missing
operators / packages / functions.
https://mxnet.apache.org/api/python/docs/api/index.html

Next improvements on the docs coming up:
- more broken links to be fixed, more missing tutorials to be added back
- usability fix: adding a direct link to the Python docs on the home page
(requested by Matthias Seeger, Haibin Lin)
- PR preview pipeline to be sorted out (Aaron is contributing a half-way
solution that would allow specific PRs to be deployed to the beta staging
env)

All the best,

Thomas


Le mar. 8 oct. 2019 à 19:40, Tao Lv <ta...@apache.org> a écrit :

> I just sent out the announcement of 1.5.1 release for review. But still not
> sure how to change  http://mxnet.incubator.apache.org/get_started and
> http://mxnet.incubator.apache.org/get_started/download to accommodate.
>
> Can anyone help on that?
>
> thanks,
> -tao
>
> On Wed, Oct 9, 2019 at 10:24 AM Zhao, Patric <pa...@intel.com>
> wrote:
>
> > Thanks, Thomas, it's good to have a site-wide search bar 😊
> >
> >
> >
> > FYI, the similar thing in https://pytorch.org/
> >
> >
> >
> > --Patric
> >
> >
> >
> > > -----Original Message-----
> >
> > > From: Thomas DELTEIL <th...@gmail.com>
> >
> > > Sent: Wednesday, October 9, 2019 1:41 AM
> >
> > > To: dev@mxnet.incubator.apache.org
> >
> > > Subject: Re: new website, docs code freeze
> >
> > >
> >
> > > Hi Patric,
> >
> > >
> >
> > > The search bar is available in the python docs:
> >
> > > https://mxnet.apache.org/api/python/docs/api/ (on the top right).
> Since
> > the
> >
> > > homepage is not built by sphinx anymore there are no more search bar
> > there.
> >
> > > We are considering using an external plugin to maintain a site-wide
> > index and
> >
> > > provide better search experience than the sphinx one.
> >
> > > btw you were asking about the mkldnn tutorials, they are now here:
> >
> > > https://mxnet.apache.org/api/python/docs/tutorials/performance/backend
> >
> > > /mkldnn/index.html
> >
> > >
> >
> > > All the best,
> >
> > >
> >
> > > Thomas Delteil
> >
> > >
> >
> > > Le lun. 7 oct. 2019 à 19:58, Zhao, Patric <pa...@intel.com> a
> > écrit :
> >
> > >
> >
> > > > I find there is no "search bar" in the website today.
> >
> > > >
> >
> > > > Could anyone check it?
> >
> > > >
> >
> > > > Thanks,
> >
> > > >
> >
> > > > --Patric
> >
> > > >
> >
> > > > > -----Original Message-----
> >
> > > > > From: Thomas DELTEIL <th...@gmail.com>
> >
> > > > > Sent: Saturday, October 5, 2019 3:41 AM
> >
> > > > > To: dev@mxnet.incubator.apache.org
> >
> > > > > Subject: Re: new website, docs code freeze
> >
> > > > >
> >
> > > > > Hi Haibin,
> >
> > > > >
> >
> > > > > We are currently working with Soji on overhauling the way the
> python
> >
> > > > > docs are organized to get better and more consistent docs with full
> >
> > > > > coverage,
> >
> > > > the
> >
> > > > > current system is a brittle and hard to browse. We hope to finish
> >
> > > > > our dev work by tonight, ETA for early next week.
> >
> > > > > There is no ETA on bringing back the old docs, though that's the
> >
> > > > > next
> >
> > > > highest
> >
> > > > > priority feature on the list after improving the coverage of the
> >
> > > > > python
> >
> > > > API.
> >
> > > > >
> >
> > > > > All the best,
> >
> > > > >
> >
> > > > > Thomas Delteil
> >
> > > > >
> >
> > > > > On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com>
> > wrote:
> >
> > > > >
> >
> > > > > > Yes, that is the correct one.
> >
> > > > > >
> >
> > > > > > On a separate note, are we removing documentation versioning from
> >
> > > > > > the website? How do we switch between the master/nightly version
> >
> > > > > > and the stable version for the python API doc? Maybe there's a
> >
> > > > > > switch somewhere but I cannot find it.
> >
> > > > > >
> >
> > > > > > Also, I find that the API doc for many methods are missing, for
> >
> > > > > > example, the Dataset.transform function has detailed
> documentation
> >
> > > > > > on input and output types, but the doc only shows the one-line
> >
> > > > > > description of the method
> >
> > > > > >
> >
> > > > > >
> >
> > > > >
> >
> > > https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.gl
> >
> > > > > u
> >
> > > > > o
> >
> > > > > > n.data.Dataset.html?highlight=dataset#
> >
> > > > > > .
> >
> > > > > > Same for other methods such as filter, shard, etc.
> >
> > > > > >
> >
> > > > > > Thanks.
> >
> > > > > >
> >
> > > > > > Best,
> >
> > > > > > Haibin
> >
> > > > > >
> >
> > > > > >
> >
> > > > > > On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham
> >
> > > > > > <aa...@gmail.com>
> >
> > > > > > wrote:
> >
> > > > > >
> >
> > > > > > > Hi Haibin, you mean this one?
> >
> > > > > > >
> >
> > > > > > >
> >
> > > > > > https://github.com/apache/incubator-
> >
> > > > > mxnet/blob/master/docs/static_site
> >
> > > > > > /src/pages/api/faq/distributed_training.md
> >
> > > > > > > If so, it looks like a link update is needed.
> >
> > > > > > >
> >
> > > > > > > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin
> >
> > > > > > > <ha...@gmail.com>
> >
> > > > > > > wrote:
> >
> > > > > > > >
> >
> > > > > > > > I find that the 'distributed training with KVStore' tutorial
> >
> > > > > > > > is
> >
> > > > gone.
> >
> > > > > > Are
> >
> > > > > > > > we adding it back?
> >
> > > > > > > >
> >
> > > > > > >
> >
> > > > > >
> >
> > > > >
> >
> > > https://mxnet.apache.org/api/python/docs/tutorials/performance/index
> >
> > > > > .h
> >
> > > > > > tml?highlight=distributed#distributed-training
> >
> > > > > > > >
> >
> > > > > > > >
> >
> > > > > > > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu
> >
> > > > > > > > <marco.g.abreu@gmail.com
> >
> > > > > > >
> >
> > > > > > > > wrote:
> >
> > > > > > > >
> >
> > > > > > > > > Thanks for the update, great job!
> >
> > > > > > > > >
> >
> > > > > > > > > Are the lighthouse results accessible somewhere? I'd be
> > curious.
> >
> > > > > > > > >
> >
> > > > > > > > > -Marco
> >
> > > > > > > > >
> >
> > > > > > > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di.,
> > 1.
> >
> > > > Okt.
> >
> > > > > > > 2019,
> >
> > > > > > > > > 13:49:
> >
> > > > > > > > >
> >
> > > > > > > > > > Update on the website:
> >
> > > > > > > > > >
> >
> > > > > > > > > > Highlights:
> >
> > > > > > > > > > - Broken links: a good amount of them have been fixed in
> >
> > > > > > > > > > this
> >
> > > > > > #16284
> >
> > > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284>,
> >
> > > > > > > > > > tutorials
> >
> > > > > > > have
> >
> > > > > > > > > > been
> >
> > > > > > > > > > reorganized (not yet deployed because of CI). A new 404
> >
> > > > > > > > > > with quick
> >
> > > > > > > links
> >
> > > > > > > > > > has been added and deployed in #16287
> >
> > > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16287>
> >
> > > > > > > > > > - Broken Search: Search has been fixed in #16284
> >
> > > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284>
> and
> >
> > > > > > > > > > merged
> >
> > > > > > > but
> >
> > > > > > > > > not
> >
> > > > > > > > > > deployed yet.
> >
> > > > > > > > > > - Google index issues: new website seems to be indexed
> >
> > > > > > > > > > now, in this
> >
> > > > > > > > > google
> >
> > > > > > > > > > search: "MXNet NDArray" <
> >
> > > > > > > https://www.google.com/search?q=mxnet+ndarray>
> >
> > > > > > > > > > new
> >
> > > > > > > > > > website is the top result. Redirects for old links to new
> >
> > > > > > > > > > ones have
> >
> > > > > > > been
> >
> > > > > > > > > > added to the .htaccess, thanks Soji for the help! #16342
> >
> > > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16342>
> is
> >
> > > > > > > > > > still
> >
> > > > > > > waiting
> >
> > > > > > > > > to
> >
> > > > > > > > > > be merged but a manual update to the website has been
> done
> >
> > > > > > > > > > in the meanwhile.
> >
> > > > > > > > > > - Automated analysis from google lighthouse scoring,
> >
> > > > > > > > > > compared to
> >
> > > > > > the
> >
> > > > > > > old
> >
> > > > > > > > > > website: Performance saw a > ~100% improvement, SEO saw a
> >
> > > > > > > > > > ~25%
> >
> > > > > > > > > improvement,
> >
> > > > > > > > > > and best practices improved by ~19%. Thanks Russell D.
> for
> >
> > > > > > > > > > running
> >
> > > > > > > the
> >
> > > > > > > > > > analysis.
> >
> > > > > > > > > >
> >
> > > > > > > > > > Remaining
> >
> > > > > > > > > > - *[high priority]* API docs are still missing some
> >
> > > > > > > > > > classes /
> >
> > > > > > > packages /
> >
> > > > > > > > > > methods. ETA for fix is EOW, root cause has been
> >
> > > > > > > > > > identified, we are
> >
> > > > > > > still
> >
> > > > > > > > > > deciding what's the best way forward for good
> >
> > > > > > > > > > discoverability as
> >
> > > > > > > well as
> >
> > > > > > > > > > good coverage and maintainability.
> >
> > > > > > > > > > - Adding quick links to directly access Python API docs
> on
> >
> > > > > > homepage.
> >
> > > > > > > > > >
> >
> > > > > > > > > > All the best,
> >
> > > > > > > > > >
> >
> > > > > > > > > > Thomas Delteil
> >
> > > > > > > > > >
> >
> > > > > > > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
> >
> > > > > > > thomas.delteil1@gmail.com
> >
> > > > > > > > > >
> >
> > > > > > > > > > a
> >
> > > > > > > > > > écrit :
> >
> > > > > > > > > >
> >
> > > > > > > > > > > @Philip Yes we're looking at link redirects for older
> >
> > > > > > > > > > > links that
> >
> > > > > > > might
> >
> > > > > > > > > be
> >
> > > > > > > > > > > hosted externally (using htaccess is my preferred way
> to
> >
> > > > > > > > > > > handle
> >
> > > > > > it
> >
> > > > > > > for
> >
> > > > > > > > > > now
> >
> > > > > > > > > > > as you sugested) and we'll use a broken link checker to
> >
> > > > > > > > > > > update
> >
> > > > > > the
> >
> > > > > > > > > links
> >
> > > > > > > > > > > that are hosted internally. We'll update the 404 to add
> >
> > > > > > > > > > > an
> >
> > > > > > > explanation
> >
> > > > > > > > > on
> >
> > > > > > > > > > > the website update. Google indexes will slowly update
> >
> > > > > > > > > > > across the
> >
> > > > > > > week
> >
> > > > > > > > > so
> >
> > > > > > > > > > > the google search issues will be less of a problem.
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > If you find any such links yourself, or missing
> >
> > > > > > > > > > > tutorials, please
> >
> > > > > > > > > > consider
> >
> > > > > > > > > > > stepping up and helping fixing them. The more people
> get
> >
> > > > > > > > > > > familiar
> >
> > > > > > > with
> >
> > > > > > > > > > the
> >
> > > > > > > > > > > new website architecture, the least likely it is to
> fall
> >
> > > > > > > > > > > in a
> >
> > > > > > > state of
> >
> > > > > > > > > > > stalled updates like the previous one.
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > For the sphinx issues in the python mini-website,
> >
> > > > > > > > > > > missing API
> >
> > > > > > > classes,
> >
> > > > > > > > > if
> >
> > > > > > > > > > > anybody is familiar with it, I'd love for us to bring
> >
> > > > > > > > > > > back the
> >
> > > > > > > > > automatic
> >
> > > > > > > > > > > doc generation for each package so at least we have a
> >
> > > > > > > > > > > list of all
> >
> > > > > > > > > > available
> >
> > > > > > > > > > > classes in each sub package rather than relying on
> >
> > > > > > > > > > > manual
> >
> > > > > > > insertion of
> >
> > > > > > > > > > each
> >
> > > > > > > > > > > class, which is brittle and not future proof. @Lin,
> >
> > > > > > > > > > > Haibin <ha...@amazon.com> if you have experience
> with
> >
> > > > > > > > > > > it, could we
> >
> > > > > > > sync up
> >
> > > > > > > > > > > offline on how you suggest to do that based on your
> >
> > > > > > > > > > > gluon-nlp
> >
> > > > > > > > > experience?
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > @Marco, I'm currently traveling for ICDAR in Sydney,
> and
> >
> > > > > > > > > > > Aaron is
> >
> > > > > > > on
> >
> > > > > > > > > PTO
> >
> > > > > > > > > > > in Europe, I'll try make time today to help with the
> >
> > > > > > > > > > > fixes since
> >
> > > > > > > it is
> >
> > > > > > > > > > > impacting a lot of users.
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > In the meanwhile, any help is appreciated, and more
> than
> >
> > > > > > > > > > > the
> >
> > > > > > value
> >
> > > > > > > of
> >
> > > > > > > > > the
> >
> > > > > > > > > > > fixes, let me repeat that there is tremendous value in
> >
> > > > > > > > > > > having
> >
> > > > > > more
> >
> > > > > > > > > people
> >
> > > > > > > > > > > familiar with the website build pipelines. Aaron is the
> >
> > > > > > > > > > > main
> >
> > > > > > owner
> >
> > > > > > > for
> >
> > > > > > > > > > the
> >
> > > > > > > > > > > docs but he is already super busy with all his other
> >
> > > > > > > responsibilities.
> >
> > > > > > > > > > I'm
> >
> > > > > > > > > > > available to help if anybody is stuck. I believe Aaron
> >
> > > > > > > > > > > has
> >
> > > > > > updated
> >
> > > > > > > the
> >
> > > > > > > > > > > READMEs on how to test the websites locally, if they're
> >
> > > > > > > > > > > not
> >
> > > > > > clear,
> >
> > > > > > > feel
> >
> > > > > > > > > > > free to contribute your own explanations or ask for
> help
> >
> > > > > > > > > > > directly
> >
> > > > > > > to me
> >
> > > > > > > > > > by
> >
> > > > > > > > > > > email or on the discuss forum.
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > Good hunting!
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > Thomas
> >
> > > > > > > > > > >
> >
> > > > > > > > > > >
> >
> > > > > > > > > > >
> >
> > > > > > > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
> >
> > > > > > > marco.g.abreu@gmail.com
> >
> > > > > > > > > >
> >
> > > > > > > > > > a
> >
> > > > > > > > > > > écrit :
> >
> > > > > > > > > > >
> >
> > > > > > > > > > >> Good catch, Mu! Also good idea, Philip!
> >
> > > > > > > > > > >>
> >
> > > > > > > > > > >> Aaron and Thomas, are you going to work on this?
> >
> > > > > > > > > > >>
> >
> > > > > > > > > > >> -Marco
> >
> > > > > > > > > > >>
> >
> > > > > > > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li
> >
> > > > > > > > > > >> <mu...@gmail.com>
> >
> > > > > > wrote:
> >
> > > > > > > > > > >>
> >
> > > > > > > > > > >> > The questions I found are:
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >> > 1. Not ever page contains, especially the homepage
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >>
> >
> > > > > > > > > >
> >
> > > > > > > > >
> >
> > > > > > >
> >
> > > > > >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_a
> >
> > > > > > naly
> >
> > > > > > tics.js
> >
> > > > > > > > > > >> > 2. The correct tracking id is UA-96378503-1 instead
> >
> > > > > > > > > > >> > of
> >
> > > > > > > > > UA-96378503-11
> >
> > > > > > > > > > in
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >>
> >
> > > > > > > > > >
> >
> > > > > > > > >
> >
> > > > > > >
> >
> > > > > >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_a
> >
> > > > > > naly
> >
> > > > > > tics.js
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li
> >
> > > > > > > > > > >> > <mu...@gmail.com>
> >
> > > > > > > wrote:
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >> > > I think the reason is that the google tracker is
> >
> > > > > > > > > > >> > > not
> >
> > > > > > included
> >
> > > > > > > in
> >
> > > > > > > > > the
> >
> > > > > > > > > > >> new
> >
> > > > > > > > > > >> > > website.
> >
> > > > > > > > > > >> > >
> >
> > > > > > > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> >
> > > > > > > > > > >> marco.g.abreu@gmail.com>
> >
> > > > > > > > > > >> > > wrote:
> >
> > > > > > > > > > >> > >
> >
> > > > > > > > > > >> > >> Hello,
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >> I checked the Google Analytics statistics and the
> >
> > > > > > > > > > >> > >> launch of
> >
> > > > > > > the
> >
> > > > > > > > > new
> >
> > > > > > > > > > >> > >> website reduced the traffic by over 80%:
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >> [image: image.png]
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >> (Please let me know if the image is not visible)
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >> How shall we handle this?
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >> Best regards,
> >
> > > > > > > > > > >> > >> Marco
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> >
> > > > > > > > > > patric.zhao@intel.com>
> >
> > > > > > > > > > >> > >> wrote:
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> > >>> For the install page [1], I suggest to add the
> >
> > > > > > > > > > >> > >>> selection
> >
> > > > > > of
> >
> > > > > > > > > > backend
> >
> > > > > > > > > > >> > >>> DeepNumpy [2] which will be more clean.
> >
> > > > > > > > > > >> > >>>
> >
> > > > > > > > > > >> > >>> [1]
> http://mxnet.incubator.apache.org/index.html
> >
> > > > > > > > > > >> > >>> [2] https://numpy.mxnet.io/#installation
> >
> > > > > > > > > > >> > >>>
> >
> > > > > > > > > > >> > >>>
> >
> > > > > > > > > > >> > >>>
> >
> > > > > > > > > > >> > >>> > -----Original Message-----
> >
> > > > > > > > > > >> > >>> > From: kellen sunderland
> >
> > > > > > > > > > >> > >>> > <ke...@gmail.com>
> >
> > > > > > > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> >
> > > > > > > > > > >> > >>> > To: dev@mxnet.incubator.apache.org
> >
> > > > > > > > > > >> > >>> > Subject: Re: new website, docs code freeze
> >
> > > > > > > > > > >> > >>> >
> >
> > > > > > > > > > >> > >>> > New site looks good.  I do notice that a few
> >
> > > > > > > > > > >> > >>> > tutorials
> >
> > > > > > > from
> >
> > > > > > > > > the
> >
> > > > > > > > > > >> old
> >
> > > > > > > > > > >> > >>> site are
> >
> > > > > > > > > > >> > >>> > missing (for example the TensorRT tutorial).
> >
> > > > > > > > > > >> > >>> > Any plans
> >
> > > > > > to
> >
> > > > > > > > > bring
> >
> > > > > > > > > > >> them
> >
> > > > > > > > > > >> > >>> back?
> >
> > > > > > > > > > >> > >>> >
> >
> > > > > > > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> >
> > > > > > > > > > >> > haibin.lin.aws@gmail.com>
> >
> > > > > > > > > > >> > >>> > wrote:
> >
> > > > > > > > > > >> > >>> >
> >
> > > > > > > > > > >> > >>> > > Another issue I found with the current
> > website:
> >
> > > > > > > > > > >> > >>> > > the
> >
> > > > > > > Sphinx
> >
> > > > > > > > > > >> object
> >
> > > > > > > > > > >> > >>> > > inventory
> >
> > > > > > > > > > >> > >>> > > <https://www.sphinx-
> >
> > > > > > > > > > >> > >>> >
> doc.org/en/master/usage/extensions/intersphinx.
> >
> > > > > > > > > > >> > >>> > htm
> >
> > > > > > > > > > >> > >>> > > l> file
> https://mxnet.apache.org/objects.inv
> >
> > > > > > > > > > >> > >>> > > l> is
> >
> > > > > > > missing.
> >
> > > > > > > > > > >> GluonNLP
> >
> > > > > > > > > > >> > >>> > > relies on this file to link document across
> >
> > > > projects.
> >
> > > > > > > Shall
> >
> > > > > > > > > we
> >
> > > > > > > > > > >> add
> >
> > > > > > > > > > >> > it
> >
> > > > > > > > > > >> > >>> > > back?
> >
> > > > > > > > > > >> > >>> > >
> >
> > > > > > > > > > >> > >>> > > Best,
> >
> > > > > > > > > > >> > >>> > > Haibin
> >
> > > > > > > > > > >> > >>> > >
> >
> > > > > > > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven
> >
> > > > > > > > > > >> > >>> > > Govaerts <
> >
> > > > > > > > > > lgo@mobsol.be>
> >
> > > > > > > > > > >> > >>> wrote:
> >
> > > > > > > > > > >> > >>> > >
> >
> > > > > > > > > > >> > >>> > > > Hi,
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas
> >
> > > > > > > > > > >> > >>> > > > DELTEIL <th...@gmail.com>
> >
> > > > > > > > > > >> > >>> > > > wrote:
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > > Thanks all for the feedback,
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > We'll send an email next week with the
> >
> > > > > > > > > > >> > >>> > > > > list of
> >
> > > > > > > missing
> >
> > > > > > > > > > >> > features,
> >
> > > > > > > > > > >> > >>> > > content
> >
> > > > > > > > > > >> > >>> > > > > and bugs that we plan to fix.
> >
> > > > > > > > > > >> > >>> > > > > We took the option of releasing early,
> >
> > > > > > > > > > >> > >>> > > > > with some
> >
> > > > > > > > > features
> >
> > > > > > > > > > >> > >>> missing,
> >
> > > > > > > > > > >> > >>> > > rather
> >
> > > > > > > > > > >> > >>> > > > > than trying to be at feature parity with
> >
> > > > > > > > > > >> > >>> > > > > the old
> >
> > > > > > > website
> >
> > > > > > > > > > >> before
> >
> > > > > > > > > > >> > >>> > > launching
> >
> > > > > > > > > > >> > >>> > > > > the website.
> >
> > > > > > > > > > >> > >>> > > > > The reason why we decided to do that is
> >
> > > > two-fold:
> >
> > > > > > > > > > >> > >>> > > > > - playing catch-up with docs in master
> >
> > > > > > > > > > >> > >>> > > > > introduce
> >
> > > > > > > daily
> >
> > > > > > > > > > >> > conflicts
> >
> > > > > > > > > > >> > >>> > > > > that
> >
> > > > > > > > > > >> > >>> > > > need
> >
> > > > > > > > > > >> > >>> > > > > to be resolved and introduce opportunity
> >
> > > > > > > > > > >> > >>> > > > > for
> >
> > > > > > errors
> >
> > > > > > > > > > >> > >>> > > > > - by releasing early, we can take
> >
> > > > > > > > > > >> > >>> > > > > advantage of the
> >
> > > > > > > > > > community
> >
> > > > > > > > > > >> > >>> > > > contributions
> >
> > > > > > > > > > >> > >>> > > > > in modifying whatever the community
> feels
> >
> > > > > > > > > > >> > >>> > > > > like a
> >
> > > > > > > better
> >
> > > > > > > > > > way
> >
> > > > > > > > > > >> of
> >
> > > > > > > > > > >> > >>> > > > > doing things.
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > One of the goals of the new website was
> >
> > > > > > > > > > >> > >>> > > > > to
> >
> > > > > > > disentangle
> >
> > > > > > > > > the
> >
> > > > > > > > > > >> main
> >
> > > > > > > > > > >> > >>> > > website,
> >
> > > > > > > > > > >> > >>> > > > > now called "static_site" to the
> >
> > > > > > > > > > >> > >>> > > > > auto-generated
> >
> > > > > > > docs. Now
> >
> > > > > > > > > > the
> >
> > > > > > > > > > >> > >>> > > > > overall
> >
> > > > > > > > > > >> > >>> > > site
> >
> > > > > > > > > > >> > >>> > > > > is made of a main static site, with easy
> >
> > > > > > > > > > >> > >>> > > > > to modify
> >
> > > > > > > > > content
> >
> > > > > > > > > > >> and
> >
> > > > > > > > > > >> > >>> > > > > easy to understand architecture for
> >
> > > > > > > > > > >> > >>> > > > > anybody
> >
> > > > > > familiar
> >
> > > > > > > > > with
> >
> > > > > > > > > > >> basic
> >
> > > > > > > > > > >> > >>> > > > > html, and a collection of mini-websites
> >
> > > > > > > > > > >> > >>> > > > > for each
> >
> > > > > > > > > language
> >
> > > > > > > > > > >> > >>> bindings
> >
> > > > > > > > > > >> > >>> > > > > that can be
> >
> > > > > > > > > > >> > >>> > > built
> >
> > > > > > > > > > >> > >>> > > > in
> >
> > > > > > > > > > >> > >>> > > > > isolation and that are self-contained.
> >
> > > > > > > > > > >> > >>> > > > > Actually
> >
> > > > > > the
> >
> > > > > > > new
> >
> > > > > > > > > CI
> >
> > > > > > > > > > >> jobs
> >
> > > > > > > > > > >> > >>> > > > > builds
> >
> > > > > > > > > > >> > >>> > > > all
> >
> > > > > > > > > > >> > >>> > > > > of them in parallel independently.
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > There is PLENTY of room for improvement,
> >
> > > > > > > > > > >> > >>> > > > > it would
> >
> > > > > > be
> >
> > > > > > > > > great
> >
> > > > > > > > > > >> if
> >
> > > > > > > > > > >> > the
> >
> > > > > > > > > > >> > >>> > > > community
> >
> > > > > > > > > > >> > >>> > > > > can help contribute to bring the new
> >
> > > > > > > > > > >> > >>> > > > > website at
> >
> > > > > > the
> >
> > > > > > > same
> >
> > > > > > > > > > >> level
> >
> > > > > > > > > > >> > of
> >
> > > > > > > > > > >> > >>> > > content
> >
> > > > > > > > > > >> > >>> > > > > richness as the old one, and then even
> >
> > > > further.
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > Missing features:
> >
> > > > > > > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do
> >
> > > > > > > > > > >> > >>> > > > > not have
> >
> > > > > > the
> >
> > > > > > > > > full
> >
> > > > > > > > > > >> list
> >
> > > > > > > > > > >> > of
> >
> > > > > > > > > > >> > >>> > > > operators
> >
> > > > > > > > > > >> > >>> > > > > and classes. There is a mix of
> >
> > > > > > > > > > >> > >>> > > > > auto-generated docs
> >
> > > > > > > based
> >
> > > > > > > > > > on
> >
> > > > > > > > > > >> > >>> > > > > packages,
> >
> > > > > > > > > > >> > >>> > > and
> >
> > > > > > > > > > >> > >>> > > > > some docs that are spelled out manually
> >
> > > > > > > > > > >> > >>> > > > > to improve
> >
> > > > > > > the
> >
> > > > > > > > > > >> logical
> >
> > > > > > > > > > >> > >>> > > > organization
> >
> > > > > > > > > > >> > >>> > > > > of the package where there is a need.
> The
> >
> > > > > > > > > > >> > >>> > > > > drawback
> >
> > > > > > > with
> >
> > > > > > > > > > >> > manually
> >
> > > > > > > > > > >> > >>> > > > > listed classes in a package is that it's
> >
> > > > > > > > > > >> > >>> > > > > very easy
> >
> > > > > > > to
> >
> > > > > > > > > miss
> >
> > > > > > > > > > >> > some.
> >
> > > > > > > > > > >> > >>> > > > > If someone
> >
> > > > > > > > > > >> > >>> > > > wanted
> >
> > > > > > > > > > >> > >>> > > > > to build a sanity check that would
> >
> > > > > > > > > > >> > >>> > > > > automatically
> >
> > > > > > > detect
> >
> > > > > > > > > > >> which
> >
> > > > > > > > > > >> > >>> > > > > classes
> >
> > > > > > > > > > >> > >>> > > are
> >
> > > > > > > > > > >> > >>> > > > > not in the documentation, or if someone
> >
> > > > > > > > > > >> > >>> > > > > knew how
> >
> > > > > > to
> >
> > > > > > > > > enable
> >
> > > > > > > > > > >> that
> >
> > > > > > > > > > >> > >>> > > > > with sphinx, that would be a great
> >
> > > > > > > > > > >> > >>> > > > > addition to the
> >
> > > > > > > > > python
> >
> > > > > > > > > > >> docs
> >
> > > > > > > > > > >> > >>> > > > > - There is missing content in the python
> >
> > > > > > tutorials,
> >
> > > > > > > and
> >
> > > > > > > > > > the
> >
> > > > > > > > > > >> > >>> > > > discoverability
> >
> > > > > > > > > > >> > >>> > > > > could be improved. Some old tutorials
> >
> > > > > > > > > > >> > >>> > > > > have not
> >
> > > > > > been
> >
> > > > > > > > > > migrated
> >
> > > > > > > > > > >> > >>> just yet.
> >
> > > > > > > > > > >> > >>> > > > > - The nightly tests on tutorials have
> >
> > > > > > > > > > >> > >>> > > > > been
> >
> > > > > > disabled
> >
> > > > > > > for
> >
> > > > > > > > > > now
> >
> > > > > > > > > > >> > >>> > > > > - There is no "Download jupyter
> notebook"
> >
> > > > > > > > > > >> > >>> > > > > for
> >
> > > > > > > tutorials
> >
> > > > > > > > > > just
> >
> > > > > > > > > > >> > yet.
> >
> > > > > > > > > > >> > >>> > > > > - Non-python tutorials might benefit
> from
> >
> > > > > > > > > > >> > >>> > > > > a blurb
> >
> > > > > > > > > > >> description
> >
> > > > > > > > > > >> > and
> >
> > > > > > > > > > >> > >>> > > > > a
> >
> > > > > > > > > > >> > >>> > > > better
> >
> > > > > > > > > > >> > >>> > > > > content organization.
> >
> > > > > > > > > > >> > >>> > > > > - Python tutorials could be better
> >
> > > > > > > > > > >> > >>> > > > > organized,
> >
> > > > > > have a
> >
> > > > > > > > > > picture
> >
> > > > > > > > > > >> > >>> > > accompanying
> >
> > > > > > > > > > >> > >>> > > > > their description
> >
> > > > > > > > > > >> > >>> > > > > - There is no site-wide search, this is
> >
> > > > > > > > > > >> > >>> > > > > not an
> >
> > > > > > easy
> >
> > > > > > > > > > problem
> >
> > > > > > > > > > >> to
> >
> > > > > > > > > > >> > >>> > > > > solve to
> >
> > > > > > > > > > >> > >>> > > > be
> >
> > > > > > > > > > >> > >>> > > > > fair given the static nature of the
> >
> > > > > > > > > > >> > >>> > > > > website, but
> >
> > > > > > > maybe
> >
> > > > > > > > > an
> >
> > > > > > > > > > >> > >>> external
> >
> > > > > > > > > > >> > >>> > > plugin
> >
> > > > > > > > > > >> > >>> > > > > might be able to give a half-way
> solution
> >
> > > > > > > > > > >> > >>> > > > > - There is no version selector for the
> >
> > > > > > > > > > >> > >>> > > > > docs
> >
> > > > > > > > > > >> > >>> > > > > - There is bug in search box of the
> >
> > > > > > > > > > >> > >>> > > > > python docs,
> >
> > > > > > but
> >
> > > > > > > > > this
> >
> > > > > > > > > > is
> >
> > > > > > > > > > >> > just
> >
> > > > > > > > > > >> > >>> > > > > a
> >
> > > > > > > > > > >> > >>> > > small
> >
> > > > > > > > > > >> > >>> > > > > JS bug that can be fixed easily (on my
> >
> > > > > > > > > > >> > >>> > > > > list for
> >
> > > > > > next
> >
> > > > > > > > > week)
> >
> > > > > > > > > > >> > >>> > > > > - Most old links have not had a redirect
> >
> > > > > > > > > > >> > >>> > > > > put in
> >
> > > > > > > place.
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > I noticed on the Ubuntu home page in the
> >
> > > > > > > > > > >> > >>> > > > Developer
> >
> > > > > > > > > dropdown
> >
> > > > > > > > > > >> that
> >
> > > > > > > > > > >> > >>> the
> >
> > > > > > > > > > >> > >>> > > > link MXNet on Ubuntu <
> >
> > > > > > > https://mxnet.incubator.apache.org/install/index.html
> >
> > > > > > > > > > >> > >>> > > > >with
> >
> > > > > > > > > > >> > >>> > > > Nvidia
> >
> > > > > > > > > > >> > >>> > > > <
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > >
> >
> > > > > > > > > > >> > >>>
> >
> > > > > > > > > > >>
> >
> > > > > > > > >
> >
> > > > > >
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applicati
> >
> > > > > > ons/
> >
> > > > > > > > > > >> > >>> > > mxnet/
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > doesn't work anymore, it points to:
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > https://mxnet.incubator.apache.org/install/index.html
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > Also, on the MXNet 'getting started' page
> >
> > > > > > > > > > >> > >>> > > >
> https://mxnet.incubator.apache.org/get_star
> >
> > > > > > > > > > >> > >>> > > > ted
> >
> > > > > > > > > > >> > >>> > > > ,
> >
> > > > > > the
> >
> > > > > > > link
> >
> > > > > > > > > > >> > "Ubuntu
> >
> > > > > > > > > > >> > >>> > > > Installation Guide" at the bottom doesn't
> >
> > > > > > > > > > >> > >>> > > > work
> >
> > > > > > > either, it
> >
> > > > > > > > > > >> points
> >
> > > > > > > > > > >> > >>> to:
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > I suggest you do a scan of the new website
> >
> > > > > > > > > > >> > >>> > > > to find
> >
> > > > > > > these
> >
> > > > > > > > > > >> dangling
> >
> > > > > > > > > > >> > >>> links.
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > regards,
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > Lieven
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > > > > We'll formalize this in github issues
> >
> > > > > > > > > > >> > >>> > > > > next week,
> >
> > > > > > but
> >
> > > > > > > > > they
> >
> > > > > > > > > > >> are
> >
> > > > > > > > > > >> > all
> >
> > > > > > > > > > >> > >>> > > fairly
> >
> > > > > > > > > > >> > >>> > > > > small and helping out on these would be
> a
> >
> > > > > > > > > > >> > >>> > > > > great
> >
> > > > > > way
> >
> > > > > > > of
> >
> > > > > > > > > > >> > >>> > > > > familiarizing yourself with the new
> >
> > > > > > > > > > >> > >>> > > > > website build
> >
> > > > > > > system
> >
> > > > > > > > > > and
> >
> > > > > > > > > > >> > >>> website
> >
> > > > > > > > > > >> > >>> > architecture.
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > >  Thanks all for the feedback, please
> keep
> >
> > > > > > > > > > >> > >>> > > > > it
> >
> > > > > > coming!
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > Thomas Delteil
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin
> Lin
> >
> > > > > > > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > > > > It looks like my previous email did
> not
> >
> > > > > > > > > > >> > >>> > > > > > go
> >
> > > > > > > through.
> >
> > > > > > > > > > >> > Re-sending:
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > Hi Aaron,
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > The website looks cool. Thanks for
> >
> > > > > > > > > > >> > >>> > > > > > pushing this
> >
> > > > > > to
> >
> > > > > > > > > > >> > production.
> >
> > > > > > > > > > >> > >>> A
> >
> > > > > > > > > > >> > >>> > > > > > few
> >
> > > > > > > > > > >> > >>> > > > > > questions:
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > - I was looking for the API doc for
> >
> > > > > > > > > > >> > >>> > > > > > mx.sym.dot,
> >
> > > > > > > but I
> >
> > > > > > > > > > find
> >
> > > > > > > > > > >> > that
> >
> > > > > > > > > > >> > >>> > > > > > most operators under mx.sym.* are
> > missing.
> >
> > > > > > > > > > >> > >>> > > > > > Is
> >
> > > > > > this
> >
> > > > > > > > > > >> expected?
> >
> > > > > > > > > > >> > >>> > > > > > - I was also checking the search
> >
> > > > > > > > > > >> > >>> > > > > > functionality,
> >
> > > > > > > > > > searching
> >
> > > > > > > > > > >> the
> >
> > > > > > > > > > >> > >>> > > > > > keyword "ndarray" only returns one
> >
> > > > > > > > > > >> > >>> > > > > > result "mxnet.ndarray.NDArray", which
> >
> > > > > > > > > > >> > >>> > > > doesn't
> >
> > > > > > > > > > >> > >>> > > > > > seem right. There animation keeps
> going
> >
> > > > > > > (Searching. ->
> >
> > > > > > > > > > >> > >>> > > > > > Searching.. -> Searching ...) and
> gives
> >
> > > > > > > > > > >> > >>> > > > > > me an
> >
> > > > > > > > > impression
> >
> > > > > > > > > > >> that
> >
> > > > > > > > > > >> > >>> > > > > > the search is never completely
> done(?).
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > Best,
> >
> > > > > > > > > > >> > >>> > > > > > Haibin
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM
> >
> > > > > > > > > > >> > >>> > > > > > Chaitanya Bapat
> >
> > > > > > <
> >
> > > > > > > > > > >> > >>> > > chai.bapat@gmail.com>
> >
> > > > > > > > > > >> > >>> > > > > > wrote:
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > Thanks Aaron and the team for
> >
> > > > > > > > > > >> > >>> > > > > > > launching new
> >
> > > > > > > website!
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > 1. There's no search button anywhere
> >
> > > > > > > > > > >> > >>> > > > > > > on the
> >
> > > > > > > landing
> >
> > > > > > > > > > >> page.
> >
> > > > > > > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and
> >
> > > > > > > > > > >> > >>> > > > > > > without
> >
> > > > > > search
> >
> > > > > > > > > > button
> >
> > > > > > > > > > >> I
> >
> > > > > > > > > > >> > >>> dont
> >
> > > > > > > > > > >> > >>> > > > > > > have
> >
> > > > > > > > > > >> > >>> > > > > > option
> >
> > > > > > > > > > >> > >>> > > > > > > but to go manually on each menu).
> >
> > > > > > > > > > >> > >>> > > > > > > Only when I
> >
> > > > > > > go to
> >
> > > > > > > > > > >> > >>> > > > > > > Docs&Tutorials
> >
> > > > > > > > > > >> > >>> > > ->
> >
> > > > > > > > > > >> > >>> > > > > FAQ
> >
> > > > > > > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got
> >
> > > > > > > > > > >> > >>> > > > > > > -> what I
> >
> > > > > > > wanted).
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > Suggestions Might want to make this
> >
> > > > > > > > > > >> > >>> > > > > > > searchable and pop FAQ
> >
> > > > > > > on
> >
> > > > > > > > > the
> >
> > > > > > > > > > >> main
> >
> > > > > > > > > > >> > >>> > > > > > > page (or somewhere prominent)
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > Thanks, Chai
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58,
> > Przemysław
> >
> > > > > > Trędak
> >
> > > > > > > <
> >
> > > > > > > > > > >> > >>> > > ptrendx@apache.org>
> >
> > > > > > > > > > >> > >>> > > > > > > wrote:
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > There seems to be a problem with
> (at
> >
> > > > > > > > > > >> > >>> > > > > > > > least
> >
> > > > > > > Python,
> >
> > > > > > > > > > did
> >
> > > > > > > > > > >> > not
> >
> > > > > > > > > > >> > >>> > > > > > > > check
> >
> > > > > > > > > > >> > >>> > > > > > others)
> >
> > > > > > > > > > >> > >>> > > > > > > > APIs. For example this page:
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > >
> >
> > > > > > > > > > >> > >>> >
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > >
> >
> > > > > > >
> >
> > > > >
> >
> > > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autog
> >
> > > > > > > en
> >
> > > > > > > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > says that it is a convenience
> method
> >
> > > > > > > > > > >> > >>> > > > > > > > for
> >
> > > > > > > argmax
> >
> > > > > > > > > > (with
> >
> > > > > > > > > > >> a
> >
> > > > > > > > > > >> > >>> > > > > > > > link),
> >
> > > > > > > > > > >> > >>> > > but
> >
> > > > > > > > > > >> > >>> > > > > > > > clicking that link just points to
> > the
> >
> > > > > > > > > > >> > >>> > > > > > > > same
> >
> > > > > > > website
> >
> > > > > > > > > > >> (and
> >
> > > > > > > > > > >> > so
> >
> > > > > > > > > > >> > >>> > > > > > > > user
> >
> > > > > > > > > > >> > >>> > > has
> >
> > > > > > > > > > >> > >>> > > > > no
> >
> > > > > > > > > > >> > >>> > > > > > > way
> >
> > > > > > > > > > >> > >>> > > > > > > > of getting to the docs of the
> actual
> >
> > > > > > > operator).
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > When I tried to manually remove
> > Symbol
> >
> > > > > > > > > > >> > >>> > > > > > > > from
> >
> > > > > > > the
> >
> > > > > > > > > URL
> >
> > > > > > > > > > to
> >
> > > > > > > > > > >> > get
> >
> > > > > > > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I
> got a
> >
> > > > > > > > > > >> > >>> > > > > > > > "Not
> >
> > > > > > > found"
> >
> > > > > > > > > > >> webpage
> >
> > > > > > > > > > >> > >>> > > > > > > > which I
> >
> > > > > > > > > > >> > >>> > > guess
> >
> > > > > > > > > > >> > >>> > > > > > also
> >
> > > > > > > > > > >> > >>> > > > > > > > should not happen (ignoring the
> fact
> >
> > > > > > > > > > >> > >>> > > > > > > > that
> >
> > > > > > this
> >
> > > > > > > > > > should
> >
> > > > > > > > > > >> > >>> exist,
> >
> > > > > > > > > > >> > >>> > > going
> >
> > > > > > > > > > >> > >>> > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > random URL under the website
> should
> >
> > > > > > > > > > >> > >>> > > > > > > > redirect
> >
> > > > > > > to
> >
> > > > > > > > > the
> >
> > > > > > > > > > >> main
> >
> > > > > > > > > > >> > >>> > > > > > > > page I
> >
> > > > > > > > > > >> > >>> > > > > think).
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > Przemek
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> >
> > > > > > > > > > apeforest@gmail.com
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >> > >>> wrote:
> >
> > > > > > > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron
> > and
> >
> > > > > > > > > > >> > >>> > > > > > > > > many
> >
> > > > > > > others
> >
> > > > > > > > > > for
> >
> > > > > > > > > > >> > >>> > > > > > > > > launching
> >
> > > > > > > > > > >> > >>> > > > > this!
> >
> > > > > > > > > > >> > >>> > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM
> > Carin
> >
> > > > > > Meier
> >
> > > > > > > <
> >
> > > > > > > > > > >> > >>> > > > carinmeier@gmail.com>
> >
> > > > > > > > > > >> > >>> > > > > > > > wrote:
> >
> > > > > > > > > > >> > >>> > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> >
> > > > > > > > > > >> > >>> > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28
> AM
> >
> > > > > > > > > > >> > >>> > > > > > > > > > Aaron
> >
> > > > > > > > > Markham <
> >
> > > > > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> >
> > > > > > > > > > >> > >>> > > > > > > > > > wrote:
> >
> > > > > > > > > > >> > >>> > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is
> >
> > > > launched.
> >
> > > > > > You
> >
> > > > > > > > > might
> >
> > > > > > > > > > >> need
> >
> > > > > > > > > > >> > to
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > clear
> >
> > > > > > > > > > >> > >>> > > > > your
> >
> > > > > > > > > > >> > >>> > > > > > > > cache.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > Cheers, Aaron
> >
> > > > > > > > > > >> > >>> > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33
> > PM
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > Aaron
> >
> > > > > > > > > Markham
> >
> > > > > > > > > > <
> >
> > > > > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> >
> > > > > > > > > > >> > >>> > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > wrote:
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs
> > passed
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > CI,
> >
> > > > > > > but
> >
> > > > > > > > > > please
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > continue
> >
> > > > > > > > > > >> > >>> > > > > holding
> >
> > > > > > > > > > >> > >>> > > > > > > > off on
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless
> > there
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > are
> >
> > > > > > > any
> >
> > > > > > > > > > >> > objections,
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > I'd
> >
> > > > > > > > > > >> > >>> > > > like
> >
> > > > > > > > > > >> > >>> > > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > launch
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > the new website today.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at
> > 7:46 AM
> >
> > > > > > Aaron
> >
> > > > > > > > > > Markham
> >
> > > > > > > > > > >> <
> >
> > > > > > > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > wrote:
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > Hi everyone, The last
> two
> > PRs
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > [1][2] for the
> >
> > > > > > new
> >
> > > > > > > > > > website
> >
> > > > > > > > > > >> and
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > docs
> >
> > > > > > > > > > >> > >>> > > have
> >
> > > > > > > > > > >> > >>> > > > > > > passed
> >
> > > > > > > > > > >> > >>> > > > > > > > CI
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not
> > make
> >
> > > > > > > changes to
> >
> > > > > > > > > > >> /docs
> >
> > > > > > > > > > >> > or
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > /ci
> >
> > > > > > > > > > >> > >>> > > > until
> >
> > > > > > > > > > >> > >>> > > > > > we
> >
> > > > > > > > > > >> > >>> > > > > > > > get
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > these approved and
> merged.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > Every
> >
> > > > > > > time
> >
> > > > > > > > > > >> there's a
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > merge
> >
> > > > > > > > > > >> > >>> > > > > > conflict
> >
> > > > > > > > > > >> > >>> > > > > > > > it has
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > set us back a day or two
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > while
> >
> > > > > > > > > shepherding
> >
> > > > > > > > > > >> the
> >
> > > > > > > > > > >> > >>> PRs
> >
> > > > > > > > > > >> > >>> > > > through
> >
> > > > > > > > > > >> > >>> > > > > CI
> >
> > > > > > > > > > >> > >>> > > > > > > > again.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > Unless there are
> > catastrophic
> >
> > > > > > issues
> >
> > > > > > > > > > >> discovered
> >
> > > > > > > > > > >> > >>> in
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > a
> >
> > > > > > > > > > >> > >>> > > > > review,
> >
> > > > > > > > > > >> > >>> > > > > > I
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > recommend that we hold
> any
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > patches
> >
> > > > > > > or
> >
> > > > > > > > > > >> updates
> >
> > > > > > > > > > >> > to
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > the
> >
> > > > > > > > > > >> > >>> > > PRs
> >
> > > > > > > > > > >> > >>> > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > follow-up
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > PRs.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > There are four steps to
> >
> > > > launch:
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are
> > approved,
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > the
> >
> > > > > > > plan
> >
> > > > > > > > > is
> >
> > > > > > > > > > to
> >
> > > > > > > > > > >> > >>> merge
> >
> > > > > > > > > > >> > >>> > > 15885
> >
> > > > > > > > > > >> > >>> > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > delete
> >
> > > > > > > > > > >> > >>> > > > > > > > > > the
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > old content first.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately
> merge
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > 15883 to
> >
> > > > > > > add
> >
> > > > > > > > > in
> >
> > > > > > > > > > >> the
> >
> > > > > > > > > > >> > new
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > CI
> >
> > > > > > > > > > >> > >>> > > > flows
> >
> > > > > > > > > > >> > >>> > > > > > and
> >
> > > > > > > > > > >> > >>> > > > > > > > > > updates
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > to the content Thomas
> and
> > I
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > have
> >
> > > > > > > already
> >
> > > > > > > > > > had
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > merged in
> >
> > > > > > > > > > >> > >>> > > > > 15884
> >
> > > > > > > > > > >> > >>> > > > > > > [3].
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > 3. I will change the
> > website
> >
> > > > > > > validation
> >
> > > > > > > > > > >> Jenkins
> >
> > > > > > > > > > >> > >>> > > pipeline
> >
> > > > > > > > > > >> > >>> > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > point to
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > the new pipeline.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > 4. I will change the
> > website
> >
> > > > > > > publishing
> >
> > > > > > > > > > >> Jenkins
> >
> > > > > > > > > > >> > >>> > > pipeline
> >
> > > > > > > > > > >> > >>> > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > point to
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > its new pipeline as
> well.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > Once
> >
> > > > > > > > > triggered,
> >
> > > > > > > > > > >> the
> >
> > > > > > > > > > >> > old
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > site
> >
> > > > > > > > > > >> > >>> > > > will
> >
> > > > > > > > > > >> > >>> > > > > > be
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > replaced with the new
> one.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need
> to
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > update
> >
> > > > > > > the DNS
> >
> > > > > > > > > > for
> >
> > > > > > > > > > >> > >>> > > > beta.mxnet.io
> >
> > > > > > > > > > >> > >>> > > > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > point
> >
> > > > > > > > > > >> > >>> > > > > > > > > > to
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > production, and there
> will
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > likely
> >
> > > > > > be
> >
> > > > > > > > > some
> >
> > > > > > > > > > >> > >>> > > > > redirect/.htaccess
> >
> > > > > > > > > > >> > >>> > > > > > > > updates
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > needed next week to
> assist
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > with
> >
> > > > > > any
> >
> > > > > > > deep
> >
> > > > > > > > > > >> > linking
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > and
> >
> > > > > > > > > > >> > >>> > > 404
> >
> > > > > > > > > > >> > >>> > > > > > issues
> >
> > > > > > > > > > >> > >>> > > > > > > > that
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > pop up.
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > Cheers, Aaron
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > [1]
> >
> > > > > > > > > > >> > >>> > > https://github.com/apache/incubator-
> >
> > > mxnet/pull/15
> >
> > > > > > > > > > >> > >>> > > 885
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > [2]
> >
> > > > > > > > > > >> > >>> > > https://github.com/apache/incubator-
> >
> > > mxnet/pull/15
> >
> > > > > > > > > > >> > >>> > > 883
> >
> > > > > > > > > > >> > >>> > > > > > > > > > > > > [3]
> >
> > > > > > > > > > >> > >>> > > https://github.com/apache/incubator-
> >
> > > mxnet/pull/15
> >
> > > > > > > > > > >> > >>> > > 884
> >
> > > > > > > > > > >> > >>> > > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > --
> >
> > > > > > > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> >
> > > > > > > > > > >> > >>> > > > > > > *+1 (973) 953-6299*
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > > [image:
> >
> > > > > > > https://www.linkedin.com//in/chaibapat25]
> >
> > > > > > > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya
> > >[image:
> >
> > > > > > > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
> >
> > > > > > > > > > >> > >>> > > > > > > ]
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > <https://www.facebook.com/chaibapchya>[image:
> >
> > > > > > > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> >
> > > > > > > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> >
> > > > > > > > > > >> > >>> > > > > > >[image:
> >
> > > > > > > > > > >> > >>> > > > > > >
> > https://www.linkedin.com//in/chaibapat25]
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > > ><
> > https://www.linkedin.com//in/chaibapchy
> >
> > > a/
> >
> > > > > > > > > > >> > >>> > > > > > >>
> >
> > > > > > > > > > >> > >>> > > > > > >
> >
> > > > > > > > > > >> > >>> > > > > >
> >
> > > > > > > > > > >> > >>> > > > >
> >
> > > > > > > > > > >> > >>> > > >
> >
> > > > > > > > > > >> > >>> > >
> >
> > > > > > > > > > >> > >>>
> >
> > > > > > > > > > >> > >>
> >
> > > > > > > > > > >> >
> >
> > > > > > > > > > >>
> >
> > > > > > > > > > >
> >
> > > > > > > > > >
> >
> > > > > > > > >
> >
> > > > > > >
> >
> > > > > >
> >
> > > >
> >
>

Re: new website, docs code freeze

[Tao Lv <ta...@apache.org>]

I just sent out the announcement of 1.5.1 release for review. But still not
sure how to change  http://mxnet.incubator.apache.org/get_started and
http://mxnet.incubator.apache.org/get_started/download to accommodate.

Can anyone help on that?

thanks,
-tao

On Wed, Oct 9, 2019 at 10:24 AM Zhao, Patric <pa...@intel.com> wrote:

> Thanks, Thomas, it's good to have a site-wide search bar 😊
>
>
>
> FYI, the similar thing in https://pytorch.org/
>
>
>
> --Patric
>
>
>
> > -----Original Message-----
>
> > From: Thomas DELTEIL <th...@gmail.com>
>
> > Sent: Wednesday, October 9, 2019 1:41 AM
>
> > To: dev@mxnet.incubator.apache.org
>
> > Subject: Re: new website, docs code freeze
>
> >
>
> > Hi Patric,
>
> >
>
> > The search bar is available in the python docs:
>
> > https://mxnet.apache.org/api/python/docs/api/ (on the top right). Since
> the
>
> > homepage is not built by sphinx anymore there are no more search bar
> there.
>
> > We are considering using an external plugin to maintain a site-wide
> index and
>
> > provide better search experience than the sphinx one.
>
> > btw you were asking about the mkldnn tutorials, they are now here:
>
> > https://mxnet.apache.org/api/python/docs/tutorials/performance/backend
>
> > /mkldnn/index.html
>
> >
>
> > All the best,
>
> >
>
> > Thomas Delteil
>
> >
>
> > Le lun. 7 oct. 2019 à 19:58, Zhao, Patric <pa...@intel.com> a
> écrit :
>
> >
>
> > > I find there is no "search bar" in the website today.
>
> > >
>
> > > Could anyone check it?
>
> > >
>
> > > Thanks,
>
> > >
>
> > > --Patric
>
> > >
>
> > > > -----Original Message-----
>
> > > > From: Thomas DELTEIL <th...@gmail.com>
>
> > > > Sent: Saturday, October 5, 2019 3:41 AM
>
> > > > To: dev@mxnet.incubator.apache.org
>
> > > > Subject: Re: new website, docs code freeze
>
> > > >
>
> > > > Hi Haibin,
>
> > > >
>
> > > > We are currently working with Soji on overhauling the way the python
>
> > > > docs are organized to get better and more consistent docs with full
>
> > > > coverage,
>
> > > the
>
> > > > current system is a brittle and hard to browse. We hope to finish
>
> > > > our dev work by tonight, ETA for early next week.
>
> > > > There is no ETA on bringing back the old docs, though that's the
>
> > > > next
>
> > > highest
>
> > > > priority feature on the list after improving the coverage of the
>
> > > > python
>
> > > API.
>
> > > >
>
> > > > All the best,
>
> > > >
>
> > > > Thomas Delteil
>
> > > >
>
> > > > On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com>
> wrote:
>
> > > >
>
> > > > > Yes, that is the correct one.
>
> > > > >
>
> > > > > On a separate note, are we removing documentation versioning from
>
> > > > > the website? How do we switch between the master/nightly version
>
> > > > > and the stable version for the python API doc? Maybe there's a
>
> > > > > switch somewhere but I cannot find it.
>
> > > > >
>
> > > > > Also, I find that the API doc for many methods are missing, for
>
> > > > > example, the Dataset.transform function has detailed documentation
>
> > > > > on input and output types, but the doc only shows the one-line
>
> > > > > description of the method
>
> > > > >
>
> > > > >
>
> > > >
>
> > https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.gl
>
> > > > u
>
> > > > o
>
> > > > > n.data.Dataset.html?highlight=dataset#
>
> > > > > .
>
> > > > > Same for other methods such as filter, shard, etc.
>
> > > > >
>
> > > > > Thanks.
>
> > > > >
>
> > > > > Best,
>
> > > > > Haibin
>
> > > > >
>
> > > > >
>
> > > > > On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham
>
> > > > > <aa...@gmail.com>
>
> > > > > wrote:
>
> > > > >
>
> > > > > > Hi Haibin, you mean this one?
>
> > > > > >
>
> > > > > >
>
> > > > > https://github.com/apache/incubator-
>
> > > > mxnet/blob/master/docs/static_site
>
> > > > > /src/pages/api/faq/distributed_training.md
>
> > > > > > If so, it looks like a link update is needed.
>
> > > > > >
>
> > > > > > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin
>
> > > > > > <ha...@gmail.com>
>
> > > > > > wrote:
>
> > > > > > >
>
> > > > > > > I find that the 'distributed training with KVStore' tutorial
>
> > > > > > > is
>
> > > gone.
>
> > > > > Are
>
> > > > > > > we adding it back?
>
> > > > > > >
>
> > > > > >
>
> > > > >
>
> > > >
>
> > https://mxnet.apache.org/api/python/docs/tutorials/performance/index
>
> > > > .h
>
> > > > > tml?highlight=distributed#distributed-training
>
> > > > > > >
>
> > > > > > >
>
> > > > > > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu
>
> > > > > > > <marco.g.abreu@gmail.com
>
> > > > > >
>
> > > > > > > wrote:
>
> > > > > > >
>
> > > > > > > > Thanks for the update, great job!
>
> > > > > > > >
>
> > > > > > > > Are the lighthouse results accessible somewhere? I'd be
> curious.
>
> > > > > > > >
>
> > > > > > > > -Marco
>
> > > > > > > >
>
> > > > > > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di.,
> 1.
>
> > > Okt.
>
> > > > > > 2019,
>
> > > > > > > > 13:49:
>
> > > > > > > >
>
> > > > > > > > > Update on the website:
>
> > > > > > > > >
>
> > > > > > > > > Highlights:
>
> > > > > > > > > - Broken links: a good amount of them have been fixed in
>
> > > > > > > > > this
>
> > > > > #16284
>
> > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284>,
>
> > > > > > > > > tutorials
>
> > > > > > have
>
> > > > > > > > > been
>
> > > > > > > > > reorganized (not yet deployed because of CI). A new 404
>
> > > > > > > > > with quick
>
> > > > > > links
>
> > > > > > > > > has been added and deployed in #16287
>
> > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16287>
>
> > > > > > > > > - Broken Search: Search has been fixed in #16284
>
> > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284> and
>
> > > > > > > > > merged
>
> > > > > > but
>
> > > > > > > > not
>
> > > > > > > > > deployed yet.
>
> > > > > > > > > - Google index issues: new website seems to be indexed
>
> > > > > > > > > now, in this
>
> > > > > > > > google
>
> > > > > > > > > search: "MXNet NDArray" <
>
> > > > > > https://www.google.com/search?q=mxnet+ndarray>
>
> > > > > > > > > new
>
> > > > > > > > > website is the top result. Redirects for old links to new
>
> > > > > > > > > ones have
>
> > > > > > been
>
> > > > > > > > > added to the .htaccess, thanks Soji for the help! #16342
>
> > > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16342> is
>
> > > > > > > > > still
>
> > > > > > waiting
>
> > > > > > > > to
>
> > > > > > > > > be merged but a manual update to the website has been done
>
> > > > > > > > > in the meanwhile.
>
> > > > > > > > > - Automated analysis from google lighthouse scoring,
>
> > > > > > > > > compared to
>
> > > > > the
>
> > > > > > old
>
> > > > > > > > > website: Performance saw a > ~100% improvement, SEO saw a
>
> > > > > > > > > ~25%
>
> > > > > > > > improvement,
>
> > > > > > > > > and best practices improved by ~19%. Thanks Russell D. for
>
> > > > > > > > > running
>
> > > > > > the
>
> > > > > > > > > analysis.
>
> > > > > > > > >
>
> > > > > > > > > Remaining
>
> > > > > > > > > - *[high priority]* API docs are still missing some
>
> > > > > > > > > classes /
>
> > > > > > packages /
>
> > > > > > > > > methods. ETA for fix is EOW, root cause has been
>
> > > > > > > > > identified, we are
>
> > > > > > still
>
> > > > > > > > > deciding what's the best way forward for good
>
> > > > > > > > > discoverability as
>
> > > > > > well as
>
> > > > > > > > > good coverage and maintainability.
>
> > > > > > > > > - Adding quick links to directly access Python API docs on
>
> > > > > homepage.
>
> > > > > > > > >
>
> > > > > > > > > All the best,
>
> > > > > > > > >
>
> > > > > > > > > Thomas Delteil
>
> > > > > > > > >
>
> > > > > > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
>
> > > > > > thomas.delteil1@gmail.com
>
> > > > > > > > >
>
> > > > > > > > > a
>
> > > > > > > > > écrit :
>
> > > > > > > > >
>
> > > > > > > > > > @Philip Yes we're looking at link redirects for older
>
> > > > > > > > > > links that
>
> > > > > > might
>
> > > > > > > > be
>
> > > > > > > > > > hosted externally (using htaccess is my preferred way to
>
> > > > > > > > > > handle
>
> > > > > it
>
> > > > > > for
>
> > > > > > > > > now
>
> > > > > > > > > > as you sugested) and we'll use a broken link checker to
>
> > > > > > > > > > update
>
> > > > > the
>
> > > > > > > > links
>
> > > > > > > > > > that are hosted internally. We'll update the 404 to add
>
> > > > > > > > > > an
>
> > > > > > explanation
>
> > > > > > > > on
>
> > > > > > > > > > the website update. Google indexes will slowly update
>
> > > > > > > > > > across the
>
> > > > > > week
>
> > > > > > > > so
>
> > > > > > > > > > the google search issues will be less of a problem.
>
> > > > > > > > > >
>
> > > > > > > > > > If you find any such links yourself, or missing
>
> > > > > > > > > > tutorials, please
>
> > > > > > > > > consider
>
> > > > > > > > > > stepping up and helping fixing them. The more people get
>
> > > > > > > > > > familiar
>
> > > > > > with
>
> > > > > > > > > the
>
> > > > > > > > > > new website architecture, the least likely it is to fall
>
> > > > > > > > > > in a
>
> > > > > > state of
>
> > > > > > > > > > stalled updates like the previous one.
>
> > > > > > > > > >
>
> > > > > > > > > > For the sphinx issues in the python mini-website,
>
> > > > > > > > > > missing API
>
> > > > > > classes,
>
> > > > > > > > if
>
> > > > > > > > > > anybody is familiar with it, I'd love for us to bring
>
> > > > > > > > > > back the
>
> > > > > > > > automatic
>
> > > > > > > > > > doc generation for each package so at least we have a
>
> > > > > > > > > > list of all
>
> > > > > > > > > available
>
> > > > > > > > > > classes in each sub package rather than relying on
>
> > > > > > > > > > manual
>
> > > > > > insertion of
>
> > > > > > > > > each
>
> > > > > > > > > > class, which is brittle and not future proof. @Lin,
>
> > > > > > > > > > Haibin <ha...@amazon.com> if you have experience with
>
> > > > > > > > > > it, could we
>
> > > > > > sync up
>
> > > > > > > > > > offline on how you suggest to do that based on your
>
> > > > > > > > > > gluon-nlp
>
> > > > > > > > experience?
>
> > > > > > > > > >
>
> > > > > > > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and
>
> > > > > > > > > > Aaron is
>
> > > > > > on
>
> > > > > > > > PTO
>
> > > > > > > > > > in Europe, I'll try make time today to help with the
>
> > > > > > > > > > fixes since
>
> > > > > > it is
>
> > > > > > > > > > impacting a lot of users.
>
> > > > > > > > > >
>
> > > > > > > > > > In the meanwhile, any help is appreciated, and more than
>
> > > > > > > > > > the
>
> > > > > value
>
> > > > > > of
>
> > > > > > > > the
>
> > > > > > > > > > fixes, let me repeat that there is tremendous value in
>
> > > > > > > > > > having
>
> > > > > more
>
> > > > > > > > people
>
> > > > > > > > > > familiar with the website build pipelines. Aaron is the
>
> > > > > > > > > > main
>
> > > > > owner
>
> > > > > > for
>
> > > > > > > > > the
>
> > > > > > > > > > docs but he is already super busy with all his other
>
> > > > > > responsibilities.
>
> > > > > > > > > I'm
>
> > > > > > > > > > available to help if anybody is stuck. I believe Aaron
>
> > > > > > > > > > has
>
> > > > > updated
>
> > > > > > the
>
> > > > > > > > > > READMEs on how to test the websites locally, if they're
>
> > > > > > > > > > not
>
> > > > > clear,
>
> > > > > > feel
>
> > > > > > > > > > free to contribute your own explanations or ask for help
>
> > > > > > > > > > directly
>
> > > > > > to me
>
> > > > > > > > > by
>
> > > > > > > > > > email or on the discuss forum.
>
> > > > > > > > > >
>
> > > > > > > > > > Good hunting!
>
> > > > > > > > > >
>
> > > > > > > > > > Thomas
>
> > > > > > > > > >
>
> > > > > > > > > >
>
> > > > > > > > > >
>
> > > > > > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
>
> > > > > > marco.g.abreu@gmail.com
>
> > > > > > > > >
>
> > > > > > > > > a
>
> > > > > > > > > > écrit :
>
> > > > > > > > > >
>
> > > > > > > > > >> Good catch, Mu! Also good idea, Philip!
>
> > > > > > > > > >>
>
> > > > > > > > > >> Aaron and Thomas, are you going to work on this?
>
> > > > > > > > > >>
>
> > > > > > > > > >> -Marco
>
> > > > > > > > > >>
>
> > > > > > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li
>
> > > > > > > > > >> <mu...@gmail.com>
>
> > > > > wrote:
>
> > > > > > > > > >>
>
> > > > > > > > > >> > The questions I found are:
>
> > > > > > > > > >> >
>
> > > > > > > > > >> > 1. Not ever page contains, especially the homepage
>
> > > > > > > > > >> >
>
> > > > > > > > > >> >
>
> > > > > > > > > >>
>
> > > > > > > > >
>
> > > > > > > >
>
> > > > > >
>
> > > > > http://mxnet.incubator.apache.org/api/python/docs/_static/google_a
>
> > > > > naly
>
> > > > > tics.js
>
> > > > > > > > > >> > 2. The correct tracking id is UA-96378503-1 instead
>
> > > > > > > > > >> > of
>
> > > > > > > > UA-96378503-11
>
> > > > > > > > > in
>
> > > > > > > > > >> >
>
> > > > > > > > > >> >
>
> > > > > > > > > >>
>
> > > > > > > > >
>
> > > > > > > >
>
> > > > > >
>
> > > > > http://mxnet.incubator.apache.org/api/python/docs/_static/google_a
>
> > > > > naly
>
> > > > > tics.js
>
> > > > > > > > > >> >
>
> > > > > > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li
>
> > > > > > > > > >> > <mu...@gmail.com>
>
> > > > > > wrote:
>
> > > > > > > > > >> >
>
> > > > > > > > > >> > > I think the reason is that the google tracker is
>
> > > > > > > > > >> > > not
>
> > > > > included
>
> > > > > > in
>
> > > > > > > > the
>
> > > > > > > > > >> new
>
> > > > > > > > > >> > > website.
>
> > > > > > > > > >> > >
>
> > > > > > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
>
> > > > > > > > > >> marco.g.abreu@gmail.com>
>
> > > > > > > > > >> > > wrote:
>
> > > > > > > > > >> > >
>
> > > > > > > > > >> > >> Hello,
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >> I checked the Google Analytics statistics and the
>
> > > > > > > > > >> > >> launch of
>
> > > > > > the
>
> > > > > > > > new
>
> > > > > > > > > >> > >> website reduced the traffic by over 80%:
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >> [image: image.png]
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >> (Please let me know if the image is not visible)
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >> How shall we handle this?
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >> Best regards,
>
> > > > > > > > > >> > >> Marco
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
>
> > > > > > > > > patric.zhao@intel.com>
>
> > > > > > > > > >> > >> wrote:
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> > >>> For the install page [1], I suggest to add the
>
> > > > > > > > > >> > >>> selection
>
> > > > > of
>
> > > > > > > > > backend
>
> > > > > > > > > >> > >>> DeepNumpy [2] which will be more clean.
>
> > > > > > > > > >> > >>>
>
> > > > > > > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
>
> > > > > > > > > >> > >>> [2] https://numpy.mxnet.io/#installation
>
> > > > > > > > > >> > >>>
>
> > > > > > > > > >> > >>>
>
> > > > > > > > > >> > >>>
>
> > > > > > > > > >> > >>> > -----Original Message-----
>
> > > > > > > > > >> > >>> > From: kellen sunderland
>
> > > > > > > > > >> > >>> > <ke...@gmail.com>
>
> > > > > > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
>
> > > > > > > > > >> > >>> > To: dev@mxnet.incubator.apache.org
>
> > > > > > > > > >> > >>> > Subject: Re: new website, docs code freeze
>
> > > > > > > > > >> > >>> >
>
> > > > > > > > > >> > >>> > New site looks good.  I do notice that a few
>
> > > > > > > > > >> > >>> > tutorials
>
> > > > > > from
>
> > > > > > > > the
>
> > > > > > > > > >> old
>
> > > > > > > > > >> > >>> site are
>
> > > > > > > > > >> > >>> > missing (for example the TensorRT tutorial).
>
> > > > > > > > > >> > >>> > Any plans
>
> > > > > to
>
> > > > > > > > bring
>
> > > > > > > > > >> them
>
> > > > > > > > > >> > >>> back?
>
> > > > > > > > > >> > >>> >
>
> > > > > > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
>
> > > > > > > > > >> > haibin.lin.aws@gmail.com>
>
> > > > > > > > > >> > >>> > wrote:
>
> > > > > > > > > >> > >>> >
>
> > > > > > > > > >> > >>> > > Another issue I found with the current
> website:
>
> > > > > > > > > >> > >>> > > the
>
> > > > > > Sphinx
>
> > > > > > > > > >> object
>
> > > > > > > > > >> > >>> > > inventory
>
> > > > > > > > > >> > >>> > > <https://www.sphinx-
>
> > > > > > > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.
>
> > > > > > > > > >> > >>> > htm
>
> > > > > > > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv
>
> > > > > > > > > >> > >>> > > l> is
>
> > > > > > missing.
>
> > > > > > > > > >> GluonNLP
>
> > > > > > > > > >> > >>> > > relies on this file to link document across
>
> > > projects.
>
> > > > > > Shall
>
> > > > > > > > we
>
> > > > > > > > > >> add
>
> > > > > > > > > >> > it
>
> > > > > > > > > >> > >>> > > back?
>
> > > > > > > > > >> > >>> > >
>
> > > > > > > > > >> > >>> > > Best,
>
> > > > > > > > > >> > >>> > > Haibin
>
> > > > > > > > > >> > >>> > >
>
> > > > > > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven
>
> > > > > > > > > >> > >>> > > Govaerts <
>
> > > > > > > > > lgo@mobsol.be>
>
> > > > > > > > > >> > >>> wrote:
>
> > > > > > > > > >> > >>> > >
>
> > > > > > > > > >> > >>> > > > Hi,
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas
>
> > > > > > > > > >> > >>> > > > DELTEIL <th...@gmail.com>
>
> > > > > > > > > >> > >>> > > > wrote:
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > > Thanks all for the feedback,
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > We'll send an email next week with the
>
> > > > > > > > > >> > >>> > > > > list of
>
> > > > > > missing
>
> > > > > > > > > >> > features,
>
> > > > > > > > > >> > >>> > > content
>
> > > > > > > > > >> > >>> > > > > and bugs that we plan to fix.
>
> > > > > > > > > >> > >>> > > > > We took the option of releasing early,
>
> > > > > > > > > >> > >>> > > > > with some
>
> > > > > > > > features
>
> > > > > > > > > >> > >>> missing,
>
> > > > > > > > > >> > >>> > > rather
>
> > > > > > > > > >> > >>> > > > > than trying to be at feature parity with
>
> > > > > > > > > >> > >>> > > > > the old
>
> > > > > > website
>
> > > > > > > > > >> before
>
> > > > > > > > > >> > >>> > > launching
>
> > > > > > > > > >> > >>> > > > > the website.
>
> > > > > > > > > >> > >>> > > > > The reason why we decided to do that is
>
> > > two-fold:
>
> > > > > > > > > >> > >>> > > > > - playing catch-up with docs in master
>
> > > > > > > > > >> > >>> > > > > introduce
>
> > > > > > daily
>
> > > > > > > > > >> > conflicts
>
> > > > > > > > > >> > >>> > > > > that
>
> > > > > > > > > >> > >>> > > > need
>
> > > > > > > > > >> > >>> > > > > to be resolved and introduce opportunity
>
> > > > > > > > > >> > >>> > > > > for
>
> > > > > errors
>
> > > > > > > > > >> > >>> > > > > - by releasing early, we can take
>
> > > > > > > > > >> > >>> > > > > advantage of the
>
> > > > > > > > > community
>
> > > > > > > > > >> > >>> > > > contributions
>
> > > > > > > > > >> > >>> > > > > in modifying whatever the community feels
>
> > > > > > > > > >> > >>> > > > > like a
>
> > > > > > better
>
> > > > > > > > > way
>
> > > > > > > > > >> of
>
> > > > > > > > > >> > >>> > > > > doing things.
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > One of the goals of the new website was
>
> > > > > > > > > >> > >>> > > > > to
>
> > > > > > disentangle
>
> > > > > > > > the
>
> > > > > > > > > >> main
>
> > > > > > > > > >> > >>> > > website,
>
> > > > > > > > > >> > >>> > > > > now called "static_site" to the
>
> > > > > > > > > >> > >>> > > > > auto-generated
>
> > > > > > docs. Now
>
> > > > > > > > > the
>
> > > > > > > > > >> > >>> > > > > overall
>
> > > > > > > > > >> > >>> > > site
>
> > > > > > > > > >> > >>> > > > > is made of a main static site, with easy
>
> > > > > > > > > >> > >>> > > > > to modify
>
> > > > > > > > content
>
> > > > > > > > > >> and
>
> > > > > > > > > >> > >>> > > > > easy to understand architecture for
>
> > > > > > > > > >> > >>> > > > > anybody
>
> > > > > familiar
>
> > > > > > > > with
>
> > > > > > > > > >> basic
>
> > > > > > > > > >> > >>> > > > > html, and a collection of mini-websites
>
> > > > > > > > > >> > >>> > > > > for each
>
> > > > > > > > language
>
> > > > > > > > > >> > >>> bindings
>
> > > > > > > > > >> > >>> > > > > that can be
>
> > > > > > > > > >> > >>> > > built
>
> > > > > > > > > >> > >>> > > > in
>
> > > > > > > > > >> > >>> > > > > isolation and that are self-contained.
>
> > > > > > > > > >> > >>> > > > > Actually
>
> > > > > the
>
> > > > > > new
>
> > > > > > > > CI
>
> > > > > > > > > >> jobs
>
> > > > > > > > > >> > >>> > > > > builds
>
> > > > > > > > > >> > >>> > > > all
>
> > > > > > > > > >> > >>> > > > > of them in parallel independently.
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > There is PLENTY of room for improvement,
>
> > > > > > > > > >> > >>> > > > > it would
>
> > > > > be
>
> > > > > > > > great
>
> > > > > > > > > >> if
>
> > > > > > > > > >> > the
>
> > > > > > > > > >> > >>> > > > community
>
> > > > > > > > > >> > >>> > > > > can help contribute to bring the new
>
> > > > > > > > > >> > >>> > > > > website at
>
> > > > > the
>
> > > > > > same
>
> > > > > > > > > >> level
>
> > > > > > > > > >> > of
>
> > > > > > > > > >> > >>> > > content
>
> > > > > > > > > >> > >>> > > > > richness as the old one, and then even
>
> > > further.
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > Missing features:
>
> > > > > > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do
>
> > > > > > > > > >> > >>> > > > > not have
>
> > > > > the
>
> > > > > > > > full
>
> > > > > > > > > >> list
>
> > > > > > > > > >> > of
>
> > > > > > > > > >> > >>> > > > operators
>
> > > > > > > > > >> > >>> > > > > and classes. There is a mix of
>
> > > > > > > > > >> > >>> > > > > auto-generated docs
>
> > > > > > based
>
> > > > > > > > > on
>
> > > > > > > > > >> > >>> > > > > packages,
>
> > > > > > > > > >> > >>> > > and
>
> > > > > > > > > >> > >>> > > > > some docs that are spelled out manually
>
> > > > > > > > > >> > >>> > > > > to improve
>
> > > > > > the
>
> > > > > > > > > >> logical
>
> > > > > > > > > >> > >>> > > > organization
>
> > > > > > > > > >> > >>> > > > > of the package where there is a need. The
>
> > > > > > > > > >> > >>> > > > > drawback
>
> > > > > > with
>
> > > > > > > > > >> > manually
>
> > > > > > > > > >> > >>> > > > > listed classes in a package is that it's
>
> > > > > > > > > >> > >>> > > > > very easy
>
> > > > > > to
>
> > > > > > > > miss
>
> > > > > > > > > >> > some.
>
> > > > > > > > > >> > >>> > > > > If someone
>
> > > > > > > > > >> > >>> > > > wanted
>
> > > > > > > > > >> > >>> > > > > to build a sanity check that would
>
> > > > > > > > > >> > >>> > > > > automatically
>
> > > > > > detect
>
> > > > > > > > > >> which
>
> > > > > > > > > >> > >>> > > > > classes
>
> > > > > > > > > >> > >>> > > are
>
> > > > > > > > > >> > >>> > > > > not in the documentation, or if someone
>
> > > > > > > > > >> > >>> > > > > knew how
>
> > > > > to
>
> > > > > > > > enable
>
> > > > > > > > > >> that
>
> > > > > > > > > >> > >>> > > > > with sphinx, that would be a great
>
> > > > > > > > > >> > >>> > > > > addition to the
>
> > > > > > > > python
>
> > > > > > > > > >> docs
>
> > > > > > > > > >> > >>> > > > > - There is missing content in the python
>
> > > > > tutorials,
>
> > > > > > and
>
> > > > > > > > > the
>
> > > > > > > > > >> > >>> > > > discoverability
>
> > > > > > > > > >> > >>> > > > > could be improved. Some old tutorials
>
> > > > > > > > > >> > >>> > > > > have not
>
> > > > > been
>
> > > > > > > > > migrated
>
> > > > > > > > > >> > >>> just yet.
>
> > > > > > > > > >> > >>> > > > > - The nightly tests on tutorials have
>
> > > > > > > > > >> > >>> > > > > been
>
> > > > > disabled
>
> > > > > > for
>
> > > > > > > > > now
>
> > > > > > > > > >> > >>> > > > > - There is no "Download jupyter notebook"
>
> > > > > > > > > >> > >>> > > > > for
>
> > > > > > tutorials
>
> > > > > > > > > just
>
> > > > > > > > > >> > yet.
>
> > > > > > > > > >> > >>> > > > > - Non-python tutorials might benefit from
>
> > > > > > > > > >> > >>> > > > > a blurb
>
> > > > > > > > > >> description
>
> > > > > > > > > >> > and
>
> > > > > > > > > >> > >>> > > > > a
>
> > > > > > > > > >> > >>> > > > better
>
> > > > > > > > > >> > >>> > > > > content organization.
>
> > > > > > > > > >> > >>> > > > > - Python tutorials could be better
>
> > > > > > > > > >> > >>> > > > > organized,
>
> > > > > have a
>
> > > > > > > > > picture
>
> > > > > > > > > >> > >>> > > accompanying
>
> > > > > > > > > >> > >>> > > > > their description
>
> > > > > > > > > >> > >>> > > > > - There is no site-wide search, this is
>
> > > > > > > > > >> > >>> > > > > not an
>
> > > > > easy
>
> > > > > > > > > problem
>
> > > > > > > > > >> to
>
> > > > > > > > > >> > >>> > > > > solve to
>
> > > > > > > > > >> > >>> > > > be
>
> > > > > > > > > >> > >>> > > > > fair given the static nature of the
>
> > > > > > > > > >> > >>> > > > > website, but
>
> > > > > > maybe
>
> > > > > > > > an
>
> > > > > > > > > >> > >>> external
>
> > > > > > > > > >> > >>> > > plugin
>
> > > > > > > > > >> > >>> > > > > might be able to give a half-way solution
>
> > > > > > > > > >> > >>> > > > > - There is no version selector for the
>
> > > > > > > > > >> > >>> > > > > docs
>
> > > > > > > > > >> > >>> > > > > - There is bug in search box of the
>
> > > > > > > > > >> > >>> > > > > python docs,
>
> > > > > but
>
> > > > > > > > this
>
> > > > > > > > > is
>
> > > > > > > > > >> > just
>
> > > > > > > > > >> > >>> > > > > a
>
> > > > > > > > > >> > >>> > > small
>
> > > > > > > > > >> > >>> > > > > JS bug that can be fixed easily (on my
>
> > > > > > > > > >> > >>> > > > > list for
>
> > > > > next
>
> > > > > > > > week)
>
> > > > > > > > > >> > >>> > > > > - Most old links have not had a redirect
>
> > > > > > > > > >> > >>> > > > > put in
>
> > > > > > place.
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > I noticed on the Ubuntu home page in the
>
> > > > > > > > > >> > >>> > > > Developer
>
> > > > > > > > dropdown
>
> > > > > > > > > >> that
>
> > > > > > > > > >> > >>> the
>
> > > > > > > > > >> > >>> > > > link MXNet on Ubuntu <
>
> > > > > > https://mxnet.incubator.apache.org/install/index.html
>
> > > > > > > > > >> > >>> > > > >with
>
> > > > > > > > > >> > >>> > > > Nvidia
>
> > > > > > > > > >> > >>> > > > <
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > >
>
> > > > > > > > > >> > >>>
>
> > > > > > > > > >>
>
> > > > > > > >
>
> > > > > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applicati
>
> > > > > ons/
>
> > > > > > > > > >> > >>> > > mxnet/
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > doesn't work anymore, it points to:
>
> > > > > > > > > >> > >>> > > >
>
> > > > > https://mxnet.incubator.apache.org/install/index.html
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > Also, on the MXNet 'getting started' page
>
> > > > > > > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_star
>
> > > > > > > > > >> > >>> > > > ted
>
> > > > > > > > > >> > >>> > > > ,
>
> > > > > the
>
> > > > > > link
>
> > > > > > > > > >> > "Ubuntu
>
> > > > > > > > > >> > >>> > > > Installation Guide" at the bottom doesn't
>
> > > > > > > > > >> > >>> > > > work
>
> > > > > > either, it
>
> > > > > > > > > >> points
>
> > > > > > > > > >> > >>> to:
>
> > > > > > > > > >> > >>> > > >
>
> > > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > I suggest you do a scan of the new website
>
> > > > > > > > > >> > >>> > > > to find
>
> > > > > > these
>
> > > > > > > > > >> dangling
>
> > > > > > > > > >> > >>> links.
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > regards,
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > Lieven
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > > > > We'll formalize this in github issues
>
> > > > > > > > > >> > >>> > > > > next week,
>
> > > > > but
>
> > > > > > > > they
>
> > > > > > > > > >> are
>
> > > > > > > > > >> > all
>
> > > > > > > > > >> > >>> > > fairly
>
> > > > > > > > > >> > >>> > > > > small and helping out on these would be a
>
> > > > > > > > > >> > >>> > > > > great
>
> > > > > way
>
> > > > > > of
>
> > > > > > > > > >> > >>> > > > > familiarizing yourself with the new
>
> > > > > > > > > >> > >>> > > > > website build
>
> > > > > > system
>
> > > > > > > > > and
>
> > > > > > > > > >> > >>> website
>
> > > > > > > > > >> > >>> > architecture.
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > >  Thanks all for the feedback, please keep
>
> > > > > > > > > >> > >>> > > > > it
>
> > > > > coming!
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > Thomas Delteil
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>
> > > > > > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > > > > It looks like my previous email did not
>
> > > > > > > > > >> > >>> > > > > > go
>
> > > > > > through.
>
> > > > > > > > > >> > Re-sending:
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > > Hi Aaron,
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > > The website looks cool. Thanks for
>
> > > > > > > > > >> > >>> > > > > > pushing this
>
> > > > > to
>
> > > > > > > > > >> > production.
>
> > > > > > > > > >> > >>> A
>
> > > > > > > > > >> > >>> > > > > > few
>
> > > > > > > > > >> > >>> > > > > > questions:
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > > - I was looking for the API doc for
>
> > > > > > > > > >> > >>> > > > > > mx.sym.dot,
>
> > > > > > but I
>
> > > > > > > > > find
>
> > > > > > > > > >> > that
>
> > > > > > > > > >> > >>> > > > > > most operators under mx.sym.* are
> missing.
>
> > > > > > > > > >> > >>> > > > > > Is
>
> > > > > this
>
> > > > > > > > > >> expected?
>
> > > > > > > > > >> > >>> > > > > > - I was also checking the search
>
> > > > > > > > > >> > >>> > > > > > functionality,
>
> > > > > > > > > searching
>
> > > > > > > > > >> the
>
> > > > > > > > > >> > >>> > > > > > keyword "ndarray" only returns one
>
> > > > > > > > > >> > >>> > > > > > result "mxnet.ndarray.NDArray", which
>
> > > > > > > > > >> > >>> > > > doesn't
>
> > > > > > > > > >> > >>> > > > > > seem right. There animation keeps going
>
> > > > > > (Searching. ->
>
> > > > > > > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives
>
> > > > > > > > > >> > >>> > > > > > me an
>
> > > > > > > > impression
>
> > > > > > > > > >> that
>
> > > > > > > > > >> > >>> > > > > > the search is never completely done(?).
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > > Best,
>
> > > > > > > > > >> > >>> > > > > > Haibin
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM
>
> > > > > > > > > >> > >>> > > > > > Chaitanya Bapat
>
> > > > > <
>
> > > > > > > > > >> > >>> > > chai.bapat@gmail.com>
>
> > > > > > > > > >> > >>> > > > > > wrote:
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > > > > Thanks Aaron and the team for
>
> > > > > > > > > >> > >>> > > > > > > launching new
>
> > > > > > website!
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > 1. There's no search button anywhere
>
> > > > > > > > > >> > >>> > > > > > > on the
>
> > > > > > landing
>
> > > > > > > > > >> page.
>
> > > > > > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and
>
> > > > > > > > > >> > >>> > > > > > > without
>
> > > > > search
>
> > > > > > > > > button
>
> > > > > > > > > >> I
>
> > > > > > > > > >> > >>> dont
>
> > > > > > > > > >> > >>> > > > > > > have
>
> > > > > > > > > >> > >>> > > > > > option
>
> > > > > > > > > >> > >>> > > > > > > but to go manually on each menu).
>
> > > > > > > > > >> > >>> > > > > > > Only when I
>
> > > > > > go to
>
> > > > > > > > > >> > >>> > > > > > > Docs&Tutorials
>
> > > > > > > > > >> > >>> > > ->
>
> > > > > > > > > >> > >>> > > > > FAQ
>
> > > > > > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got
>
> > > > > > > > > >> > >>> > > > > > > -> what I
>
> > > > > > wanted).
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > Suggestions Might want to make this
>
> > > > > > > > > >> > >>> > > > > > > searchable and pop FAQ
>
> > > > > > on
>
> > > > > > > > the
>
> > > > > > > > > >> main
>
> > > > > > > > > >> > >>> > > > > > > page (or somewhere prominent)
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > Thanks, Chai
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58,
> Przemysław
>
> > > > > Trędak
>
> > > > > > <
>
> > > > > > > > > >> > >>> > > ptrendx@apache.org>
>
> > > > > > > > > >> > >>> > > > > > > wrote:
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > There seems to be a problem with (at
>
> > > > > > > > > >> > >>> > > > > > > > least
>
> > > > > > Python,
>
> > > > > > > > > did
>
> > > > > > > > > >> > not
>
> > > > > > > > > >> > >>> > > > > > > > check
>
> > > > > > > > > >> > >>> > > > > > others)
>
> > > > > > > > > >> > >>> > > > > > > > APIs. For example this page:
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > >
>
> > > > > > > > > >> > >>> >
>
> > > > > > > > > >> >
>
> > > > > > > > >
>
> > > > > >
>
> > > >
>
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autog
>
> > > > > > en
>
> > > > > > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > says that it is a convenience method
>
> > > > > > > > > >> > >>> > > > > > > > for
>
> > > > > > argmax
>
> > > > > > > > > (with
>
> > > > > > > > > >> a
>
> > > > > > > > > >> > >>> > > > > > > > link),
>
> > > > > > > > > >> > >>> > > but
>
> > > > > > > > > >> > >>> > > > > > > > clicking that link just points to
> the
>
> > > > > > > > > >> > >>> > > > > > > > same
>
> > > > > > website
>
> > > > > > > > > >> (and
>
> > > > > > > > > >> > so
>
> > > > > > > > > >> > >>> > > > > > > > user
>
> > > > > > > > > >> > >>> > > has
>
> > > > > > > > > >> > >>> > > > > no
>
> > > > > > > > > >> > >>> > > > > > > way
>
> > > > > > > > > >> > >>> > > > > > > > of getting to the docs of the actual
>
> > > > > > operator).
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > When I tried to manually remove
> Symbol
>
> > > > > > > > > >> > >>> > > > > > > > from
>
> > > > > > the
>
> > > > > > > > URL
>
> > > > > > > > > to
>
> > > > > > > > > >> > get
>
> > > > > > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a
>
> > > > > > > > > >> > >>> > > > > > > > "Not
>
> > > > > > found"
>
> > > > > > > > > >> webpage
>
> > > > > > > > > >> > >>> > > > > > > > which I
>
> > > > > > > > > >> > >>> > > guess
>
> > > > > > > > > >> > >>> > > > > > also
>
> > > > > > > > > >> > >>> > > > > > > > should not happen (ignoring the fact
>
> > > > > > > > > >> > >>> > > > > > > > that
>
> > > > > this
>
> > > > > > > > > should
>
> > > > > > > > > >> > >>> exist,
>
> > > > > > > > > >> > >>> > > going
>
> > > > > > > > > >> > >>> > > > to
>
> > > > > > > > > >> > >>> > > > > > > > random URL under the website should
>
> > > > > > > > > >> > >>> > > > > > > > redirect
>
> > > > > > to
>
> > > > > > > > the
>
> > > > > > > > > >> main
>
> > > > > > > > > >> > >>> > > > > > > > page I
>
> > > > > > > > > >> > >>> > > > > think).
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > Przemek
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
>
> > > > > > > > > apeforest@gmail.com
>
> > > > > > > > > >> >
>
> > > > > > > > > >> > >>> wrote:
>
> > > > > > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron
> and
>
> > > > > > > > > >> > >>> > > > > > > > > many
>
> > > > > > others
>
> > > > > > > > > for
>
> > > > > > > > > >> > >>> > > > > > > > > launching
>
> > > > > > > > > >> > >>> > > > > this!
>
> > > > > > > > > >> > >>> > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM
> Carin
>
> > > > > Meier
>
> > > > > > <
>
> > > > > > > > > >> > >>> > > > carinmeier@gmail.com>
>
> > > > > > > > > >> > >>> > > > > > > > wrote:
>
> > > > > > > > > >> > >>> > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
>
> > > > > > > > > >> > >>> > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM
>
> > > > > > > > > >> > >>> > > > > > > > > > Aaron
>
> > > > > > > > Markham <
>
> > > > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
>
> > > > > > > > > >> > >>> > > > > > > > > > wrote:
>
> > > > > > > > > >> > >>> > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is
>
> > > launched.
>
> > > > > You
>
> > > > > > > > might
>
> > > > > > > > > >> need
>
> > > > > > > > > >> > to
>
> > > > > > > > > >> > >>> > > > > > > > > > > clear
>
> > > > > > > > > >> > >>> > > > > your
>
> > > > > > > > > >> > >>> > > > > > > > cache.
>
> > > > > > > > > >> > >>> > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > Cheers, Aaron
>
> > > > > > > > > >> > >>> > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33
> PM
>
> > > > > > > > > >> > >>> > > > > > > > > > > Aaron
>
> > > > > > > > Markham
>
> > > > > > > > > <
>
> > > > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
>
> > > > > > > > > >> > >>> > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > wrote:
>
> > > > > > > > > >> > >>> > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs
> passed
>
> > > > > > > > > >> > >>> > > > > > > > > > > > CI,
>
> > > > > > but
>
> > > > > > > > > please
>
> > > > > > > > > >> > >>> > > > > > > > > > > > continue
>
> > > > > > > > > >> > >>> > > > > holding
>
> > > > > > > > > >> > >>> > > > > > > > off on
>
> > > > > > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless
> there
>
> > > > > > > > > >> > >>> > > > > > > > > > > > are
>
> > > > > > any
>
> > > > > > > > > >> > objections,
>
> > > > > > > > > >> > >>> > > > > > > > > > > > I'd
>
> > > > > > > > > >> > >>> > > > like
>
> > > > > > > > > >> > >>> > > > > to
>
> > > > > > > > > >> > >>> > > > > > > > launch
>
> > > > > > > > > >> > >>> > > > > > > > > > > > the new website today.
>
> > > > > > > > > >> > >>> > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at
> 7:46 AM
>
> > > > > Aaron
>
> > > > > > > > > Markham
>
> > > > > > > > > >> <
>
> > > > > > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
>
> > > > > > > > > >> > >>> > > > > > > > > > > wrote:
>
> > > > > > > > > >> > >>> > > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > Hi everyone, The last two
> PRs
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > [1][2] for the
>
> > > > > new
>
> > > > > > > > > website
>
> > > > > > > > > >> and
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > docs
>
> > > > > > > > > >> > >>> > > have
>
> > > > > > > > > >> > >>> > > > > > > passed
>
> > > > > > > > > >> > >>> > > > > > > > CI
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not
> make
>
> > > > > > changes to
>
> > > > > > > > > >> /docs
>
> > > > > > > > > >> > or
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > /ci
>
> > > > > > > > > >> > >>> > > > until
>
> > > > > > > > > >> > >>> > > > > > we
>
> > > > > > > > > >> > >>> > > > > > > > get
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > these approved and merged.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > Every
>
> > > > > > time
>
> > > > > > > > > >> there's a
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > merge
>
> > > > > > > > > >> > >>> > > > > > conflict
>
> > > > > > > > > >> > >>> > > > > > > > it has
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > set us back a day or two
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > while
>
> > > > > > > > shepherding
>
> > > > > > > > > >> the
>
> > > > > > > > > >> > >>> PRs
>
> > > > > > > > > >> > >>> > > > through
>
> > > > > > > > > >> > >>> > > > > CI
>
> > > > > > > > > >> > >>> > > > > > > > again.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > Unless there are
> catastrophic
>
> > > > > issues
>
> > > > > > > > > >> discovered
>
> > > > > > > > > >> > >>> in
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > a
>
> > > > > > > > > >> > >>> > > > > review,
>
> > > > > > > > > >> > >>> > > > > > I
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > recommend that we hold any
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > patches
>
> > > > > > or
>
> > > > > > > > > >> updates
>
> > > > > > > > > >> > to
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > the
>
> > > > > > > > > >> > >>> > > PRs
>
> > > > > > > > > >> > >>> > > > to
>
> > > > > > > > > >> > >>> > > > > > > > follow-up
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > PRs.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > There are four steps to
>
> > > launch:
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are
> approved,
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > the
>
> > > > > > plan
>
> > > > > > > > is
>
> > > > > > > > > to
>
> > > > > > > > > >> > >>> merge
>
> > > > > > > > > >> > >>> > > 15885
>
> > > > > > > > > >> > >>> > > > to
>
> > > > > > > > > >> > >>> > > > > > > > delete
>
> > > > > > > > > >> > >>> > > > > > > > > > the
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > old content first.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > 15883 to
>
> > > > > > add
>
> > > > > > > > in
>
> > > > > > > > > >> the
>
> > > > > > > > > >> > new
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > CI
>
> > > > > > > > > >> > >>> > > > flows
>
> > > > > > > > > >> > >>> > > > > > and
>
> > > > > > > > > >> > >>> > > > > > > > > > updates
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > to the content Thomas and
> I
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > have
>
> > > > > > already
>
> > > > > > > > > had
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > merged in
>
> > > > > > > > > >> > >>> > > > > 15884
>
> > > > > > > > > >> > >>> > > > > > > [3].
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > 3. I will change the
> website
>
> > > > > > validation
>
> > > > > > > > > >> Jenkins
>
> > > > > > > > > >> > >>> > > pipeline
>
> > > > > > > > > >> > >>> > > > to
>
> > > > > > > > > >> > >>> > > > > > > > point to
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > the new pipeline.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > 4. I will change the
> website
>
> > > > > > publishing
>
> > > > > > > > > >> Jenkins
>
> > > > > > > > > >> > >>> > > pipeline
>
> > > > > > > > > >> > >>> > > > to
>
> > > > > > > > > >> > >>> > > > > > > > point to
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > its new pipeline as well.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > Once
>
> > > > > > > > triggered,
>
> > > > > > > > > >> the
>
> > > > > > > > > >> > old
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > site
>
> > > > > > > > > >> > >>> > > > will
>
> > > > > > > > > >> > >>> > > > > > be
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > replaced with the new one.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > update
>
> > > > > > the DNS
>
> > > > > > > > > for
>
> > > > > > > > > >> > >>> > > > beta.mxnet.io
>
> > > > > > > > > >> > >>> > > > > > to
>
> > > > > > > > > >> > >>> > > > > > > > point
>
> > > > > > > > > >> > >>> > > > > > > > > > to
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > production, and there will
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > likely
>
> > > > > be
>
> > > > > > > > some
>
> > > > > > > > > >> > >>> > > > > redirect/.htaccess
>
> > > > > > > > > >> > >>> > > > > > > > updates
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > needed next week to assist
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > with
>
> > > > > any
>
> > > > > > deep
>
> > > > > > > > > >> > linking
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > and
>
> > > > > > > > > >> > >>> > > 404
>
> > > > > > > > > >> > >>> > > > > > issues
>
> > > > > > > > > >> > >>> > > > > > > > that
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > pop up.
>
> > > > > > > > > >> > >>> > > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > Cheers, Aaron
>
> > > > > > > > > >> > >>> > > > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > [1]
>
> > > > > > > > > >> > >>> > > https://github.com/apache/incubator-
>
> > mxnet/pull/15
>
> > > > > > > > > >> > >>> > > 885
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > [2]
>
> > > > > > > > > >> > >>> > > https://github.com/apache/incubator-
>
> > mxnet/pull/15
>
> > > > > > > > > >> > >>> > > 883
>
> > > > > > > > > >> > >>> > > > > > > > > > > > > [3]
>
> > > > > > > > > >> > >>> > > https://github.com/apache/incubator-
>
> > mxnet/pull/15
>
> > > > > > > > > >> > >>> > > 884
>
> > > > > > > > > >> > >>> > > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > >
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > --
>
> > > > > > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
>
> > > > > > > > > >> > >>> > > > > > > *+1 (973) 953-6299*
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > > [image:
>
> > > > > > https://www.linkedin.com//in/chaibapat25]
>
> > > > > > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya
> >[image:
>
> > > > > > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
>
> > > > > > > > > >> > >>> > > > > > > ]
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > <https://www.facebook.com/chaibapchya>[image:
>
> > > > > > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
>
> > > > > > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
>
> > > > > > > > > >> > >>> > > > > > >[image:
>
> > > > > > > > > >> > >>> > > > > > >
> https://www.linkedin.com//in/chaibapat25]
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > > ><
> https://www.linkedin.com//in/chaibapchy
>
> > a/
>
> > > > > > > > > >> > >>> > > > > > >>
>
> > > > > > > > > >> > >>> > > > > > >
>
> > > > > > > > > >> > >>> > > > > >
>
> > > > > > > > > >> > >>> > > > >
>
> > > > > > > > > >> > >>> > > >
>
> > > > > > > > > >> > >>> > >
>
> > > > > > > > > >> > >>>
>
> > > > > > > > > >> > >>
>
> > > > > > > > > >> >
>
> > > > > > > > > >>
>
> > > > > > > > > >
>
> > > > > > > > >
>
> > > > > > > >
>
> > > > > >
>
> > > > >
>
> > >
>

RE: new website, docs code freeze

["Zhao, Patric" <pa...@intel.com>]

Thanks, Thomas, it's good to have a site-wide search bar 😊



FYI, the similar thing in https://pytorch.org/



--Patric



> -----Original Message-----

> From: Thomas DELTEIL <th...@gmail.com>

> Sent: Wednesday, October 9, 2019 1:41 AM

> To: dev@mxnet.incubator.apache.org

> Subject: Re: new website, docs code freeze

>

> Hi Patric,

>

> The search bar is available in the python docs:

> https://mxnet.apache.org/api/python/docs/api/ (on the top right). Since the

> homepage is not built by sphinx anymore there are no more search bar there.

> We are considering using an external plugin to maintain a site-wide index and

> provide better search experience than the sphinx one.

> btw you were asking about the mkldnn tutorials, they are now here:

> https://mxnet.apache.org/api/python/docs/tutorials/performance/backend

> /mkldnn/index.html

>

> All the best,

>

> Thomas Delteil

>

> Le lun. 7 oct. 2019 à 19:58, Zhao, Patric <pa...@intel.com> a écrit :

>

> > I find there is no "search bar" in the website today.

> >

> > Could anyone check it?

> >

> > Thanks,

> >

> > --Patric

> >

> > > -----Original Message-----

> > > From: Thomas DELTEIL <th...@gmail.com>

> > > Sent: Saturday, October 5, 2019 3:41 AM

> > > To: dev@mxnet.incubator.apache.org

> > > Subject: Re: new website, docs code freeze

> > >

> > > Hi Haibin,

> > >

> > > We are currently working with Soji on overhauling the way the python

> > > docs are organized to get better and more consistent docs with full

> > > coverage,

> > the

> > > current system is a brittle and hard to browse. We hope to finish

> > > our dev work by tonight, ETA for early next week.

> > > There is no ETA on bringing back the old docs, though that's the

> > > next

> > highest

> > > priority feature on the list after improving the coverage of the

> > > python

> > API.

> > >

> > > All the best,

> > >

> > > Thomas Delteil

> > >

> > > On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com> wrote:

> > >

> > > > Yes, that is the correct one.

> > > >

> > > > On a separate note, are we removing documentation versioning from

> > > > the website? How do we switch between the master/nightly version

> > > > and the stable version for the python API doc? Maybe there's a

> > > > switch somewhere but I cannot find it.

> > > >

> > > > Also, I find that the API doc for many methods are missing, for

> > > > example, the Dataset.transform function has detailed documentation

> > > > on input and output types, but the doc only shows the one-line

> > > > description of the method

> > > >

> > > >

> > >

> https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.gl

> > > u

> > > o

> > > > n.data.Dataset.html?highlight=dataset#

> > > > .

> > > > Same for other methods such as filter, shard, etc.

> > > >

> > > > Thanks.

> > > >

> > > > Best,

> > > > Haibin

> > > >

> > > >

> > > > On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham

> > > > <aa...@gmail.com>

> > > > wrote:

> > > >

> > > > > Hi Haibin, you mean this one?

> > > > >

> > > > >

> > > > https://github.com/apache/incubator-

> > > mxnet/blob/master/docs/static_site

> > > > /src/pages/api/faq/distributed_training.md

> > > > > If so, it looks like a link update is needed.

> > > > >

> > > > > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin

> > > > > <ha...@gmail.com>

> > > > > wrote:

> > > > > >

> > > > > > I find that the 'distributed training with KVStore' tutorial

> > > > > > is

> > gone.

> > > > Are

> > > > > > we adding it back?

> > > > > >

> > > > >

> > > >

> > >

> https://mxnet.apache.org/api/python/docs/tutorials/performance/index

> > > .h

> > > > tml?highlight=distributed#distributed-training

> > > > > >

> > > > > >

> > > > > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu

> > > > > > <marco.g.abreu@gmail.com

> > > > >

> > > > > > wrote:

> > > > > >

> > > > > > > Thanks for the update, great job!

> > > > > > >

> > > > > > > Are the lighthouse results accessible somewhere? I'd be curious.

> > > > > > >

> > > > > > > -Marco

> > > > > > >

> > > > > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1.

> > Okt.

> > > > > 2019,

> > > > > > > 13:49:

> > > > > > >

> > > > > > > > Update on the website:

> > > > > > > >

> > > > > > > > Highlights:

> > > > > > > > - Broken links: a good amount of them have been fixed in

> > > > > > > > this

> > > > #16284

> > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284>,

> > > > > > > > tutorials

> > > > > have

> > > > > > > > been

> > > > > > > > reorganized (not yet deployed because of CI). A new 404

> > > > > > > > with quick

> > > > > links

> > > > > > > > has been added and deployed in #16287

> > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16287>

> > > > > > > > - Broken Search: Search has been fixed in #16284

> > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284> and

> > > > > > > > merged

> > > > > but

> > > > > > > not

> > > > > > > > deployed yet.

> > > > > > > > - Google index issues: new website seems to be indexed

> > > > > > > > now, in this

> > > > > > > google

> > > > > > > > search: "MXNet NDArray" <

> > > > > https://www.google.com/search?q=mxnet+ndarray>

> > > > > > > > new

> > > > > > > > website is the top result. Redirects for old links to new

> > > > > > > > ones have

> > > > > been

> > > > > > > > added to the .htaccess, thanks Soji for the help! #16342

> > > > > > > > <https://github.com/apache/incubator-mxnet/pull/16342> is

> > > > > > > > still

> > > > > waiting

> > > > > > > to

> > > > > > > > be merged but a manual update to the website has been done

> > > > > > > > in the meanwhile.

> > > > > > > > - Automated analysis from google lighthouse scoring,

> > > > > > > > compared to

> > > > the

> > > > > old

> > > > > > > > website: Performance saw a > ~100% improvement, SEO saw a

> > > > > > > > ~25%

> > > > > > > improvement,

> > > > > > > > and best practices improved by ~19%. Thanks Russell D. for

> > > > > > > > running

> > > > > the

> > > > > > > > analysis.

> > > > > > > >

> > > > > > > > Remaining

> > > > > > > > - *[high priority]* API docs are still missing some

> > > > > > > > classes /

> > > > > packages /

> > > > > > > > methods. ETA for fix is EOW, root cause has been

> > > > > > > > identified, we are

> > > > > still

> > > > > > > > deciding what's the best way forward for good

> > > > > > > > discoverability as

> > > > > well as

> > > > > > > > good coverage and maintainability.

> > > > > > > > - Adding quick links to directly access Python API docs on

> > > > homepage.

> > > > > > > >

> > > > > > > > All the best,

> > > > > > > >

> > > > > > > > Thomas Delteil

> > > > > > > >

> > > > > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <

> > > > > thomas.delteil1@gmail.com

> > > > > > > >

> > > > > > > > a

> > > > > > > > écrit :

> > > > > > > >

> > > > > > > > > @Philip Yes we're looking at link redirects for older

> > > > > > > > > links that

> > > > > might

> > > > > > > be

> > > > > > > > > hosted externally (using htaccess is my preferred way to

> > > > > > > > > handle

> > > > it

> > > > > for

> > > > > > > > now

> > > > > > > > > as you sugested) and we'll use a broken link checker to

> > > > > > > > > update

> > > > the

> > > > > > > links

> > > > > > > > > that are hosted internally. We'll update the 404 to add

> > > > > > > > > an

> > > > > explanation

> > > > > > > on

> > > > > > > > > the website update. Google indexes will slowly update

> > > > > > > > > across the

> > > > > week

> > > > > > > so

> > > > > > > > > the google search issues will be less of a problem.

> > > > > > > > >

> > > > > > > > > If you find any such links yourself, or missing

> > > > > > > > > tutorials, please

> > > > > > > > consider

> > > > > > > > > stepping up and helping fixing them. The more people get

> > > > > > > > > familiar

> > > > > with

> > > > > > > > the

> > > > > > > > > new website architecture, the least likely it is to fall

> > > > > > > > > in a

> > > > > state of

> > > > > > > > > stalled updates like the previous one.

> > > > > > > > >

> > > > > > > > > For the sphinx issues in the python mini-website,

> > > > > > > > > missing API

> > > > > classes,

> > > > > > > if

> > > > > > > > > anybody is familiar with it, I'd love for us to bring

> > > > > > > > > back the

> > > > > > > automatic

> > > > > > > > > doc generation for each package so at least we have a

> > > > > > > > > list of all

> > > > > > > > available

> > > > > > > > > classes in each sub package rather than relying on

> > > > > > > > > manual

> > > > > insertion of

> > > > > > > > each

> > > > > > > > > class, which is brittle and not future proof. @Lin,

> > > > > > > > > Haibin <ha...@amazon.com> if you have experience with

> > > > > > > > > it, could we

> > > > > sync up

> > > > > > > > > offline on how you suggest to do that based on your

> > > > > > > > > gluon-nlp

> > > > > > > experience?

> > > > > > > > >

> > > > > > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and

> > > > > > > > > Aaron is

> > > > > on

> > > > > > > PTO

> > > > > > > > > in Europe, I'll try make time today to help with the

> > > > > > > > > fixes since

> > > > > it is

> > > > > > > > > impacting a lot of users.

> > > > > > > > >

> > > > > > > > > In the meanwhile, any help is appreciated, and more than

> > > > > > > > > the

> > > > value

> > > > > of

> > > > > > > the

> > > > > > > > > fixes, let me repeat that there is tremendous value in

> > > > > > > > > having

> > > > more

> > > > > > > people

> > > > > > > > > familiar with the website build pipelines. Aaron is the

> > > > > > > > > main

> > > > owner

> > > > > for

> > > > > > > > the

> > > > > > > > > docs but he is already super busy with all his other

> > > > > responsibilities.

> > > > > > > > I'm

> > > > > > > > > available to help if anybody is stuck. I believe Aaron

> > > > > > > > > has

> > > > updated

> > > > > the

> > > > > > > > > READMEs on how to test the websites locally, if they're

> > > > > > > > > not

> > > > clear,

> > > > > feel

> > > > > > > > > free to contribute your own explanations or ask for help

> > > > > > > > > directly

> > > > > to me

> > > > > > > > by

> > > > > > > > > email or on the discuss forum.

> > > > > > > > >

> > > > > > > > > Good hunting!

> > > > > > > > >

> > > > > > > > > Thomas

> > > > > > > > >

> > > > > > > > >

> > > > > > > > >

> > > > > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <

> > > > > marco.g.abreu@gmail.com

> > > > > > > >

> > > > > > > > a

> > > > > > > > > écrit :

> > > > > > > > >

> > > > > > > > >> Good catch, Mu! Also good idea, Philip!

> > > > > > > > >>

> > > > > > > > >> Aaron and Thomas, are you going to work on this?

> > > > > > > > >>

> > > > > > > > >> -Marco

> > > > > > > > >>

> > > > > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li

> > > > > > > > >> <mu...@gmail.com>

> > > > wrote:

> > > > > > > > >>

> > > > > > > > >> > The questions I found are:

> > > > > > > > >> >

> > > > > > > > >> > 1. Not ever page contains, especially the homepage

> > > > > > > > >> >

> > > > > > > > >> >

> > > > > > > > >>

> > > > > > > >

> > > > > > >

> > > > >

> > > > http://mxnet.incubator.apache.org/api/python/docs/_static/google_a

> > > > naly

> > > > tics.js

> > > > > > > > >> > 2. The correct tracking id is UA-96378503-1 instead

> > > > > > > > >> > of

> > > > > > > UA-96378503-11

> > > > > > > > in

> > > > > > > > >> >

> > > > > > > > >> >

> > > > > > > > >>

> > > > > > > >

> > > > > > >

> > > > >

> > > > http://mxnet.incubator.apache.org/api/python/docs/_static/google_a

> > > > naly

> > > > tics.js

> > > > > > > > >> >

> > > > > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li

> > > > > > > > >> > <mu...@gmail.com>

> > > > > wrote:

> > > > > > > > >> >

> > > > > > > > >> > > I think the reason is that the google tracker is

> > > > > > > > >> > > not

> > > > included

> > > > > in

> > > > > > > the

> > > > > > > > >> new

> > > > > > > > >> > > website.

> > > > > > > > >> > >

> > > > > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <

> > > > > > > > >> marco.g.abreu@gmail.com>

> > > > > > > > >> > > wrote:

> > > > > > > > >> > >

> > > > > > > > >> > >> Hello,

> > > > > > > > >> > >>

> > > > > > > > >> > >> I checked the Google Analytics statistics and the

> > > > > > > > >> > >> launch of

> > > > > the

> > > > > > > new

> > > > > > > > >> > >> website reduced the traffic by over 80%:

> > > > > > > > >> > >>

> > > > > > > > >> > >> [image: image.png]

> > > > > > > > >> > >>

> > > > > > > > >> > >> (Please let me know if the image is not visible)

> > > > > > > > >> > >>

> > > > > > > > >> > >> How shall we handle this?

> > > > > > > > >> > >>

> > > > > > > > >> > >> Best regards,

> > > > > > > > >> > >> Marco

> > > > > > > > >> > >>

> > > > > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <

> > > > > > > > patric.zhao@intel.com>

> > > > > > > > >> > >> wrote:

> > > > > > > > >> > >>

> > > > > > > > >> > >>> For the install page [1], I suggest to add the

> > > > > > > > >> > >>> selection

> > > > of

> > > > > > > > backend

> > > > > > > > >> > >>> DeepNumpy [2] which will be more clean.

> > > > > > > > >> > >>>

> > > > > > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html

> > > > > > > > >> > >>> [2] https://numpy.mxnet.io/#installation

> > > > > > > > >> > >>>

> > > > > > > > >> > >>>

> > > > > > > > >> > >>>

> > > > > > > > >> > >>> > -----Original Message-----

> > > > > > > > >> > >>> > From: kellen sunderland

> > > > > > > > >> > >>> > <ke...@gmail.com>

> > > > > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM

> > > > > > > > >> > >>> > To: dev@mxnet.incubator.apache.org

> > > > > > > > >> > >>> > Subject: Re: new website, docs code freeze

> > > > > > > > >> > >>> >

> > > > > > > > >> > >>> > New site looks good.  I do notice that a few

> > > > > > > > >> > >>> > tutorials

> > > > > from

> > > > > > > the

> > > > > > > > >> old

> > > > > > > > >> > >>> site are

> > > > > > > > >> > >>> > missing (for example the TensorRT tutorial).

> > > > > > > > >> > >>> > Any plans

> > > > to

> > > > > > > bring

> > > > > > > > >> them

> > > > > > > > >> > >>> back?

> > > > > > > > >> > >>> >

> > > > > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <

> > > > > > > > >> > haibin.lin.aws@gmail.com>

> > > > > > > > >> > >>> > wrote:

> > > > > > > > >> > >>> >

> > > > > > > > >> > >>> > > Another issue I found with the current website:

> > > > > > > > >> > >>> > > the

> > > > > Sphinx

> > > > > > > > >> object

> > > > > > > > >> > >>> > > inventory

> > > > > > > > >> > >>> > > <https://www.sphinx-

> > > > > > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.

> > > > > > > > >> > >>> > htm

> > > > > > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv

> > > > > > > > >> > >>> > > l> is

> > > > > missing.

> > > > > > > > >> GluonNLP

> > > > > > > > >> > >>> > > relies on this file to link document across

> > projects.

> > > > > Shall

> > > > > > > we

> > > > > > > > >> add

> > > > > > > > >> > it

> > > > > > > > >> > >>> > > back?

> > > > > > > > >> > >>> > >

> > > > > > > > >> > >>> > > Best,

> > > > > > > > >> > >>> > > Haibin

> > > > > > > > >> > >>> > >

> > > > > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven

> > > > > > > > >> > >>> > > Govaerts <

> > > > > > > > lgo@mobsol.be>

> > > > > > > > >> > >>> wrote:

> > > > > > > > >> > >>> > >

> > > > > > > > >> > >>> > > > Hi,

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas

> > > > > > > > >> > >>> > > > DELTEIL <th...@gmail.com>

> > > > > > > > >> > >>> > > > wrote:

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > > Thanks all for the feedback,

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > We'll send an email next week with the

> > > > > > > > >> > >>> > > > > list of

> > > > > missing

> > > > > > > > >> > features,

> > > > > > > > >> > >>> > > content

> > > > > > > > >> > >>> > > > > and bugs that we plan to fix.

> > > > > > > > >> > >>> > > > > We took the option of releasing early,

> > > > > > > > >> > >>> > > > > with some

> > > > > > > features

> > > > > > > > >> > >>> missing,

> > > > > > > > >> > >>> > > rather

> > > > > > > > >> > >>> > > > > than trying to be at feature parity with

> > > > > > > > >> > >>> > > > > the old

> > > > > website

> > > > > > > > >> before

> > > > > > > > >> > >>> > > launching

> > > > > > > > >> > >>> > > > > the website.

> > > > > > > > >> > >>> > > > > The reason why we decided to do that is

> > two-fold:

> > > > > > > > >> > >>> > > > > - playing catch-up with docs in master

> > > > > > > > >> > >>> > > > > introduce

> > > > > daily

> > > > > > > > >> > conflicts

> > > > > > > > >> > >>> > > > > that

> > > > > > > > >> > >>> > > > need

> > > > > > > > >> > >>> > > > > to be resolved and introduce opportunity

> > > > > > > > >> > >>> > > > > for

> > > > errors

> > > > > > > > >> > >>> > > > > - by releasing early, we can take

> > > > > > > > >> > >>> > > > > advantage of the

> > > > > > > > community

> > > > > > > > >> > >>> > > > contributions

> > > > > > > > >> > >>> > > > > in modifying whatever the community feels

> > > > > > > > >> > >>> > > > > like a

> > > > > better

> > > > > > > > way

> > > > > > > > >> of

> > > > > > > > >> > >>> > > > > doing things.

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > One of the goals of the new website was

> > > > > > > > >> > >>> > > > > to

> > > > > disentangle

> > > > > > > the

> > > > > > > > >> main

> > > > > > > > >> > >>> > > website,

> > > > > > > > >> > >>> > > > > now called "static_site" to the

> > > > > > > > >> > >>> > > > > auto-generated

> > > > > docs. Now

> > > > > > > > the

> > > > > > > > >> > >>> > > > > overall

> > > > > > > > >> > >>> > > site

> > > > > > > > >> > >>> > > > > is made of a main static site, with easy

> > > > > > > > >> > >>> > > > > to modify

> > > > > > > content

> > > > > > > > >> and

> > > > > > > > >> > >>> > > > > easy to understand architecture for

> > > > > > > > >> > >>> > > > > anybody

> > > > familiar

> > > > > > > with

> > > > > > > > >> basic

> > > > > > > > >> > >>> > > > > html, and a collection of mini-websites

> > > > > > > > >> > >>> > > > > for each

> > > > > > > language

> > > > > > > > >> > >>> bindings

> > > > > > > > >> > >>> > > > > that can be

> > > > > > > > >> > >>> > > built

> > > > > > > > >> > >>> > > > in

> > > > > > > > >> > >>> > > > > isolation and that are self-contained.

> > > > > > > > >> > >>> > > > > Actually

> > > > the

> > > > > new

> > > > > > > CI

> > > > > > > > >> jobs

> > > > > > > > >> > >>> > > > > builds

> > > > > > > > >> > >>> > > > all

> > > > > > > > >> > >>> > > > > of them in parallel independently.

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > There is PLENTY of room for improvement,

> > > > > > > > >> > >>> > > > > it would

> > > > be

> > > > > > > great

> > > > > > > > >> if

> > > > > > > > >> > the

> > > > > > > > >> > >>> > > > community

> > > > > > > > >> > >>> > > > > can help contribute to bring the new

> > > > > > > > >> > >>> > > > > website at

> > > > the

> > > > > same

> > > > > > > > >> level

> > > > > > > > >> > of

> > > > > > > > >> > >>> > > content

> > > > > > > > >> > >>> > > > > richness as the old one, and then even

> > further.

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > Missing features:

> > > > > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do

> > > > > > > > >> > >>> > > > > not have

> > > > the

> > > > > > > full

> > > > > > > > >> list

> > > > > > > > >> > of

> > > > > > > > >> > >>> > > > operators

> > > > > > > > >> > >>> > > > > and classes. There is a mix of

> > > > > > > > >> > >>> > > > > auto-generated docs

> > > > > based

> > > > > > > > on

> > > > > > > > >> > >>> > > > > packages,

> > > > > > > > >> > >>> > > and

> > > > > > > > >> > >>> > > > > some docs that are spelled out manually

> > > > > > > > >> > >>> > > > > to improve

> > > > > the

> > > > > > > > >> logical

> > > > > > > > >> > >>> > > > organization

> > > > > > > > >> > >>> > > > > of the package where there is a need. The

> > > > > > > > >> > >>> > > > > drawback

> > > > > with

> > > > > > > > >> > manually

> > > > > > > > >> > >>> > > > > listed classes in a package is that it's

> > > > > > > > >> > >>> > > > > very easy

> > > > > to

> > > > > > > miss

> > > > > > > > >> > some.

> > > > > > > > >> > >>> > > > > If someone

> > > > > > > > >> > >>> > > > wanted

> > > > > > > > >> > >>> > > > > to build a sanity check that would

> > > > > > > > >> > >>> > > > > automatically

> > > > > detect

> > > > > > > > >> which

> > > > > > > > >> > >>> > > > > classes

> > > > > > > > >> > >>> > > are

> > > > > > > > >> > >>> > > > > not in the documentation, or if someone

> > > > > > > > >> > >>> > > > > knew how

> > > > to

> > > > > > > enable

> > > > > > > > >> that

> > > > > > > > >> > >>> > > > > with sphinx, that would be a great

> > > > > > > > >> > >>> > > > > addition to the

> > > > > > > python

> > > > > > > > >> docs

> > > > > > > > >> > >>> > > > > - There is missing content in the python

> > > > tutorials,

> > > > > and

> > > > > > > > the

> > > > > > > > >> > >>> > > > discoverability

> > > > > > > > >> > >>> > > > > could be improved. Some old tutorials

> > > > > > > > >> > >>> > > > > have not

> > > > been

> > > > > > > > migrated

> > > > > > > > >> > >>> just yet.

> > > > > > > > >> > >>> > > > > - The nightly tests on tutorials have

> > > > > > > > >> > >>> > > > > been

> > > > disabled

> > > > > for

> > > > > > > > now

> > > > > > > > >> > >>> > > > > - There is no "Download jupyter notebook"

> > > > > > > > >> > >>> > > > > for

> > > > > tutorials

> > > > > > > > just

> > > > > > > > >> > yet.

> > > > > > > > >> > >>> > > > > - Non-python tutorials might benefit from

> > > > > > > > >> > >>> > > > > a blurb

> > > > > > > > >> description

> > > > > > > > >> > and

> > > > > > > > >> > >>> > > > > a

> > > > > > > > >> > >>> > > > better

> > > > > > > > >> > >>> > > > > content organization.

> > > > > > > > >> > >>> > > > > - Python tutorials could be better

> > > > > > > > >> > >>> > > > > organized,

> > > > have a

> > > > > > > > picture

> > > > > > > > >> > >>> > > accompanying

> > > > > > > > >> > >>> > > > > their description

> > > > > > > > >> > >>> > > > > - There is no site-wide search, this is

> > > > > > > > >> > >>> > > > > not an

> > > > easy

> > > > > > > > problem

> > > > > > > > >> to

> > > > > > > > >> > >>> > > > > solve to

> > > > > > > > >> > >>> > > > be

> > > > > > > > >> > >>> > > > > fair given the static nature of the

> > > > > > > > >> > >>> > > > > website, but

> > > > > maybe

> > > > > > > an

> > > > > > > > >> > >>> external

> > > > > > > > >> > >>> > > plugin

> > > > > > > > >> > >>> > > > > might be able to give a half-way solution

> > > > > > > > >> > >>> > > > > - There is no version selector for the

> > > > > > > > >> > >>> > > > > docs

> > > > > > > > >> > >>> > > > > - There is bug in search box of the

> > > > > > > > >> > >>> > > > > python docs,

> > > > but

> > > > > > > this

> > > > > > > > is

> > > > > > > > >> > just

> > > > > > > > >> > >>> > > > > a

> > > > > > > > >> > >>> > > small

> > > > > > > > >> > >>> > > > > JS bug that can be fixed easily (on my

> > > > > > > > >> > >>> > > > > list for

> > > > next

> > > > > > > week)

> > > > > > > > >> > >>> > > > > - Most old links have not had a redirect

> > > > > > > > >> > >>> > > > > put in

> > > > > place.

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > I noticed on the Ubuntu home page in the

> > > > > > > > >> > >>> > > > Developer

> > > > > > > dropdown

> > > > > > > > >> that

> > > > > > > > >> > >>> the

> > > > > > > > >> > >>> > > > link MXNet on Ubuntu <

> > > > > https://mxnet.incubator.apache.org/install/index.html

> > > > > > > > >> > >>> > > > >with

> > > > > > > > >> > >>> > > > Nvidia

> > > > > > > > >> > >>> > > > <

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > >

> > > > > > > > >> > >>>

> > > > > > > > >>

> > > > > > >

> > > > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applicati

> > > > ons/

> > > > > > > > >> > >>> > > mxnet/

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > doesn't work anymore, it points to:

> > > > > > > > >> > >>> > > >

> > > > https://mxnet.incubator.apache.org/install/index.html

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > Also, on the MXNet 'getting started' page

> > > > > > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_star

> > > > > > > > >> > >>> > > > ted

> > > > > > > > >> > >>> > > > ,

> > > > the

> > > > > link

> > > > > > > > >> > "Ubuntu

> > > > > > > > >> > >>> > > > Installation Guide" at the bottom doesn't

> > > > > > > > >> > >>> > > > work

> > > > > either, it

> > > > > > > > >> points

> > > > > > > > >> > >>> to:

> > > > > > > > >> > >>> > > >

> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > I suggest you do a scan of the new website

> > > > > > > > >> > >>> > > > to find

> > > > > these

> > > > > > > > >> dangling

> > > > > > > > >> > >>> links.

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > regards,

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > Lieven

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > > > > We'll formalize this in github issues

> > > > > > > > >> > >>> > > > > next week,

> > > > but

> > > > > > > they

> > > > > > > > >> are

> > > > > > > > >> > all

> > > > > > > > >> > >>> > > fairly

> > > > > > > > >> > >>> > > > > small and helping out on these would be a

> > > > > > > > >> > >>> > > > > great

> > > > way

> > > > > of

> > > > > > > > >> > >>> > > > > familiarizing yourself with the new

> > > > > > > > >> > >>> > > > > website build

> > > > > system

> > > > > > > > and

> > > > > > > > >> > >>> website

> > > > > > > > >> > >>> > architecture.

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > >  Thanks all for the feedback, please keep

> > > > > > > > >> > >>> > > > > it

> > > > coming!

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > Thomas Delteil

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin

> > > > > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > > > > It looks like my previous email did not

> > > > > > > > >> > >>> > > > > > go

> > > > > through.

> > > > > > > > >> > Re-sending:

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > > Hi Aaron,

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > > The website looks cool. Thanks for

> > > > > > > > >> > >>> > > > > > pushing this

> > > > to

> > > > > > > > >> > production.

> > > > > > > > >> > >>> A

> > > > > > > > >> > >>> > > > > > few

> > > > > > > > >> > >>> > > > > > questions:

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > > - I was looking for the API doc for

> > > > > > > > >> > >>> > > > > > mx.sym.dot,

> > > > > but I

> > > > > > > > find

> > > > > > > > >> > that

> > > > > > > > >> > >>> > > > > > most operators under mx.sym.* are missing.

> > > > > > > > >> > >>> > > > > > Is

> > > > this

> > > > > > > > >> expected?

> > > > > > > > >> > >>> > > > > > - I was also checking the search

> > > > > > > > >> > >>> > > > > > functionality,

> > > > > > > > searching

> > > > > > > > >> the

> > > > > > > > >> > >>> > > > > > keyword "ndarray" only returns one

> > > > > > > > >> > >>> > > > > > result "mxnet.ndarray.NDArray", which

> > > > > > > > >> > >>> > > > doesn't

> > > > > > > > >> > >>> > > > > > seem right. There animation keeps going

> > > > > (Searching. ->

> > > > > > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives

> > > > > > > > >> > >>> > > > > > me an

> > > > > > > impression

> > > > > > > > >> that

> > > > > > > > >> > >>> > > > > > the search is never completely done(?).

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > > Best,

> > > > > > > > >> > >>> > > > > > Haibin

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM

> > > > > > > > >> > >>> > > > > > Chaitanya Bapat

> > > > <

> > > > > > > > >> > >>> > > chai.bapat@gmail.com>

> > > > > > > > >> > >>> > > > > > wrote:

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > > > > Thanks Aaron and the team for

> > > > > > > > >> > >>> > > > > > > launching new

> > > > > website!

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > 1. There's no search button anywhere

> > > > > > > > >> > >>> > > > > > > on the

> > > > > landing

> > > > > > > > >> page.

> > > > > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and

> > > > > > > > >> > >>> > > > > > > without

> > > > search

> > > > > > > > button

> > > > > > > > >> I

> > > > > > > > >> > >>> dont

> > > > > > > > >> > >>> > > > > > > have

> > > > > > > > >> > >>> > > > > > option

> > > > > > > > >> > >>> > > > > > > but to go manually on each menu).

> > > > > > > > >> > >>> > > > > > > Only when I

> > > > > go to

> > > > > > > > >> > >>> > > > > > > Docs&Tutorials

> > > > > > > > >> > >>> > > ->

> > > > > > > > >> > >>> > > > > FAQ

> > > > > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got

> > > > > > > > >> > >>> > > > > > > -> what I

> > > > > wanted).

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > Suggestions Might want to make this

> > > > > > > > >> > >>> > > > > > > searchable and pop FAQ

> > > > > on

> > > > > > > the

> > > > > > > > >> main

> > > > > > > > >> > >>> > > > > > > page (or somewhere prominent)

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > Thanks, Chai

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław

> > > > Trędak

> > > > > <

> > > > > > > > >> > >>> > > ptrendx@apache.org>

> > > > > > > > >> > >>> > > > > > > wrote:

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > > There seems to be a problem with (at

> > > > > > > > >> > >>> > > > > > > > least

> > > > > Python,

> > > > > > > > did

> > > > > > > > >> > not

> > > > > > > > >> > >>> > > > > > > > check

> > > > > > > > >> > >>> > > > > > others)

> > > > > > > > >> > >>> > > > > > > > APIs. For example this page:

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > >

> > > > > > > > >> > >>> >

> > > > > > > > >> >

> > > > > > > >

> > > > >

> > >

> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autog

> > > > > en

> > > > > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > > > says that it is a convenience method

> > > > > > > > >> > >>> > > > > > > > for

> > > > > argmax

> > > > > > > > (with

> > > > > > > > >> a

> > > > > > > > >> > >>> > > > > > > > link),

> > > > > > > > >> > >>> > > but

> > > > > > > > >> > >>> > > > > > > > clicking that link just points to the

> > > > > > > > >> > >>> > > > > > > > same

> > > > > website

> > > > > > > > >> (and

> > > > > > > > >> > so

> > > > > > > > >> > >>> > > > > > > > user

> > > > > > > > >> > >>> > > has

> > > > > > > > >> > >>> > > > > no

> > > > > > > > >> > >>> > > > > > > way

> > > > > > > > >> > >>> > > > > > > > of getting to the docs of the actual

> > > > > operator).

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > > > When I tried to manually remove Symbol

> > > > > > > > >> > >>> > > > > > > > from

> > > > > the

> > > > > > > URL

> > > > > > > > to

> > > > > > > > >> > get

> > > > > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a

> > > > > > > > >> > >>> > > > > > > > "Not

> > > > > found"

> > > > > > > > >> webpage

> > > > > > > > >> > >>> > > > > > > > which I

> > > > > > > > >> > >>> > > guess

> > > > > > > > >> > >>> > > > > > also

> > > > > > > > >> > >>> > > > > > > > should not happen (ignoring the fact

> > > > > > > > >> > >>> > > > > > > > that

> > > > this

> > > > > > > > should

> > > > > > > > >> > >>> exist,

> > > > > > > > >> > >>> > > going

> > > > > > > > >> > >>> > > > to

> > > > > > > > >> > >>> > > > > > > > random URL under the website should

> > > > > > > > >> > >>> > > > > > > > redirect

> > > > > to

> > > > > > > the

> > > > > > > > >> main

> > > > > > > > >> > >>> > > > > > > > page I

> > > > > > > > >> > >>> > > > > think).

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > > > Przemek

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <

> > > > > > > > apeforest@gmail.com

> > > > > > > > >> >

> > > > > > > > >> > >>> wrote:

> > > > > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and

> > > > > > > > >> > >>> > > > > > > > > many

> > > > > others

> > > > > > > > for

> > > > > > > > >> > >>> > > > > > > > > launching

> > > > > > > > >> > >>> > > > > this!

> > > > > > > > >> > >>> > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin

> > > > Meier

> > > > > <

> > > > > > > > >> > >>> > > > carinmeier@gmail.com>

> > > > > > > > >> > >>> > > > > > > > wrote:

> > > > > > > > >> > >>> > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!

> > > > > > > > >> > >>> > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM

> > > > > > > > >> > >>> > > > > > > > > > Aaron

> > > > > > > Markham <

> > > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>

> > > > > > > > >> > >>> > > > > > > > > > wrote:

> > > > > > > > >> > >>> > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is

> > launched.

> > > > You

> > > > > > > might

> > > > > > > > >> need

> > > > > > > > >> > to

> > > > > > > > >> > >>> > > > > > > > > > > clear

> > > > > > > > >> > >>> > > > > your

> > > > > > > > >> > >>> > > > > > > > cache.

> > > > > > > > >> > >>> > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > Cheers, Aaron

> > > > > > > > >> > >>> > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM

> > > > > > > > >> > >>> > > > > > > > > > > Aaron

> > > > > > > Markham

> > > > > > > > <

> > > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com

> > > > > > > > >> > >>> > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > wrote:

> > > > > > > > >> > >>> > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed

> > > > > > > > >> > >>> > > > > > > > > > > > CI,

> > > > > but

> > > > > > > > please

> > > > > > > > >> > >>> > > > > > > > > > > > continue

> > > > > > > > >> > >>> > > > > holding

> > > > > > > > >> > >>> > > > > > > > off on

> > > > > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there

> > > > > > > > >> > >>> > > > > > > > > > > > are

> > > > > any

> > > > > > > > >> > objections,

> > > > > > > > >> > >>> > > > > > > > > > > > I'd

> > > > > > > > >> > >>> > > > like

> > > > > > > > >> > >>> > > > > to

> > > > > > > > >> > >>> > > > > > > > launch

> > > > > > > > >> > >>> > > > > > > > > > > > the new website today.

> > > > > > > > >> > >>> > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM

> > > > Aaron

> > > > > > > > Markham

> > > > > > > > >> <

> > > > > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>

> > > > > > > > >> > >>> > > > > > > > > > > wrote:

> > > > > > > > >> > >>> > > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > > Hi everyone, The last two PRs

> > > > > > > > >> > >>> > > > > > > > > > > > > [1][2] for the

> > > > new

> > > > > > > > website

> > > > > > > > >> and

> > > > > > > > >> > >>> > > > > > > > > > > > > docs

> > > > > > > > >> > >>> > > have

> > > > > > > > >> > >>> > > > > > > passed

> > > > > > > > >> > >>> > > > > > > > CI

> > > > > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not make

> > > > > changes to

> > > > > > > > >> /docs

> > > > > > > > >> > or

> > > > > > > > >> > >>> > > > > > > > > > > > > /ci

> > > > > > > > >> > >>> > > > until

> > > > > > > > >> > >>> > > > > > we

> > > > > > > > >> > >>> > > > > > > > get

> > > > > > > > >> > >>> > > > > > > > > > > > > these approved and merged.

> > > > > > > > >> > >>> > > > > > > > > > > > > Every

> > > > > time

> > > > > > > > >> there's a

> > > > > > > > >> > >>> > > > > > > > > > > > > merge

> > > > > > > > >> > >>> > > > > > conflict

> > > > > > > > >> > >>> > > > > > > > it has

> > > > > > > > >> > >>> > > > > > > > > > > > > set us back a day or two

> > > > > > > > >> > >>> > > > > > > > > > > > > while

> > > > > > > shepherding

> > > > > > > > >> the

> > > > > > > > >> > >>> PRs

> > > > > > > > >> > >>> > > > through

> > > > > > > > >> > >>> > > > > CI

> > > > > > > > >> > >>> > > > > > > > again.

> > > > > > > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic

> > > > issues

> > > > > > > > >> discovered

> > > > > > > > >> > >>> in

> > > > > > > > >> > >>> > > > > > > > > > > > > a

> > > > > > > > >> > >>> > > > > review,

> > > > > > > > >> > >>> > > > > > I

> > > > > > > > >> > >>> > > > > > > > > > > > > recommend that we hold any

> > > > > > > > >> > >>> > > > > > > > > > > > > patches

> > > > > or

> > > > > > > > >> updates

> > > > > > > > >> > to

> > > > > > > > >> > >>> > > > > > > > > > > > > the

> > > > > > > > >> > >>> > > PRs

> > > > > > > > >> > >>> > > > to

> > > > > > > > >> > >>> > > > > > > > follow-up

> > > > > > > > >> > >>> > > > > > > > > > > > > PRs.

> > > > > > > > >> > >>> > > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > > There are four steps to

> > launch:

> > > > > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved,

> > > > > > > > >> > >>> > > > > > > > > > > > > the

> > > > > plan

> > > > > > > is

> > > > > > > > to

> > > > > > > > >> > >>> merge

> > > > > > > > >> > >>> > > 15885

> > > > > > > > >> > >>> > > > to

> > > > > > > > >> > >>> > > > > > > > delete

> > > > > > > > >> > >>> > > > > > > > > > the

> > > > > > > > >> > >>> > > > > > > > > > > > > old content first.

> > > > > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge

> > > > > > > > >> > >>> > > > > > > > > > > > > 15883 to

> > > > > add

> > > > > > > in

> > > > > > > > >> the

> > > > > > > > >> > new

> > > > > > > > >> > >>> > > > > > > > > > > > > CI

> > > > > > > > >> > >>> > > > flows

> > > > > > > > >> > >>> > > > > > and

> > > > > > > > >> > >>> > > > > > > > > > updates

> > > > > > > > >> > >>> > > > > > > > > > > > > to the content Thomas and I

> > > > > > > > >> > >>> > > > > > > > > > > > > have

> > > > > already

> > > > > > > > had

> > > > > > > > >> > >>> > > > > > > > > > > > > merged in

> > > > > > > > >> > >>> > > > > 15884

> > > > > > > > >> > >>> > > > > > > [3].

> > > > > > > > >> > >>> > > > > > > > > > > > > 3. I will change the website

> > > > > validation

> > > > > > > > >> Jenkins

> > > > > > > > >> > >>> > > pipeline

> > > > > > > > >> > >>> > > > to

> > > > > > > > >> > >>> > > > > > > > point to

> > > > > > > > >> > >>> > > > > > > > > > > > > the new pipeline.

> > > > > > > > >> > >>> > > > > > > > > > > > > 4. I will change the website

> > > > > publishing

> > > > > > > > >> Jenkins

> > > > > > > > >> > >>> > > pipeline

> > > > > > > > >> > >>> > > > to

> > > > > > > > >> > >>> > > > > > > > point to

> > > > > > > > >> > >>> > > > > > > > > > > > > its new pipeline as well.

> > > > > > > > >> > >>> > > > > > > > > > > > > Once

> > > > > > > triggered,

> > > > > > > > >> the

> > > > > > > > >> > old

> > > > > > > > >> > >>> > > > > > > > > > > > > site

> > > > > > > > >> > >>> > > > will

> > > > > > > > >> > >>> > > > > > be

> > > > > > > > >> > >>> > > > > > > > > > > > > replaced with the new one.

> > > > > > > > >> > >>> > > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to

> > > > > > > > >> > >>> > > > > > > > > > > > > update

> > > > > the DNS

> > > > > > > > for

> > > > > > > > >> > >>> > > > beta.mxnet.io

> > > > > > > > >> > >>> > > > > > to

> > > > > > > > >> > >>> > > > > > > > point

> > > > > > > > >> > >>> > > > > > > > > > to

> > > > > > > > >> > >>> > > > > > > > > > > > > production, and there will

> > > > > > > > >> > >>> > > > > > > > > > > > > likely

> > > > be

> > > > > > > some

> > > > > > > > >> > >>> > > > > redirect/.htaccess

> > > > > > > > >> > >>> > > > > > > > updates

> > > > > > > > >> > >>> > > > > > > > > > > > > needed next week to assist

> > > > > > > > >> > >>> > > > > > > > > > > > > with

> > > > any

> > > > > deep

> > > > > > > > >> > linking

> > > > > > > > >> > >>> > > > > > > > > > > > > and

> > > > > > > > >> > >>> > > 404

> > > > > > > > >> > >>> > > > > > issues

> > > > > > > > >> > >>> > > > > > > > that

> > > > > > > > >> > >>> > > > > > > > > > > > > pop up.

> > > > > > > > >> > >>> > > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > > Cheers, Aaron

> > > > > > > > >> > >>> > > > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > > > > > [1]

> > > > > > > > >> > >>> > > https://github.com/apache/incubator-

> mxnet/pull/15

> > > > > > > > >> > >>> > > 885

> > > > > > > > >> > >>> > > > > > > > > > > > > [2]

> > > > > > > > >> > >>> > > https://github.com/apache/incubator-

> mxnet/pull/15

> > > > > > > > >> > >>> > > 883

> > > > > > > > >> > >>> > > > > > > > > > > > > [3]

> > > > > > > > >> > >>> > > https://github.com/apache/incubator-

> mxnet/pull/15

> > > > > > > > >> > >>> > > 884

> > > > > > > > >> > >>> > > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > > >

> > > > > > > > >> > >>> > > > > > > > >

> > > > > > > > >> > >>> > > > > > > >

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > --

> > > > > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*

> > > > > > > > >> > >>> > > > > > > *+1 (973) 953-6299*

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > > [image:

> > > > > https://www.linkedin.com//in/chaibapat25]

> > > > > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:

> > > > > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat

> > > > > > > > >> > >>> > > > > > > ]

> > > > > > > > >> > >>> > > > > > >

> > > <https://www.facebook.com/chaibapchya>[image:

> > > > > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]

> > > > > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya

> > > > > > > > >> > >>> > > > > > >[image:

> > > > > > > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > > ><https://www.linkedin.com//in/chaibapchy

> a/

> > > > > > > > >> > >>> > > > > > >>

> > > > > > > > >> > >>> > > > > > >

> > > > > > > > >> > >>> > > > > >

> > > > > > > > >> > >>> > > > >

> > > > > > > > >> > >>> > > >

> > > > > > > > >> > >>> > >

> > > > > > > > >> > >>>

> > > > > > > > >> > >>

> > > > > > > > >> >

> > > > > > > > >>

> > > > > > > > >

> > > > > > > >

> > > > > > >

> > > > >

> > > >

> >

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

Hi Patric,

The search bar is available in the python docs:
https://mxnet.apache.org/api/python/docs/api/ (on the top right). Since the
homepage is not built by sphinx anymore there are no more search bar there.
We are considering using an external plugin to maintain a site-wide index
and provide better search experience than the sphinx one.
btw you were asking about the mkldnn tutorials, they are now here:
https://mxnet.apache.org/api/python/docs/tutorials/performance/backend/mkldnn/index.html

All the best,

Thomas Delteil

Le lun. 7 oct. 2019 à 19:58, Zhao, Patric <pa...@intel.com> a écrit :

> I find there is no "search bar" in the website today.
>
> Could anyone check it?
>
> Thanks,
>
> --Patric
>
> > -----Original Message-----
> > From: Thomas DELTEIL <th...@gmail.com>
> > Sent: Saturday, October 5, 2019 3:41 AM
> > To: dev@mxnet.incubator.apache.org
> > Subject: Re: new website, docs code freeze
> >
> > Hi Haibin,
> >
> > We are currently working with Soji on overhauling the way the python docs
> > are organized to get better and more consistent docs with full coverage,
> the
> > current system is a brittle and hard to browse. We hope to finish our dev
> > work by tonight, ETA for early next week.
> > There is no ETA on bringing back the old docs, though that's the next
> highest
> > priority feature on the list after improving the coverage of the python
> API.
> >
> > All the best,
> >
> > Thomas Delteil
> >
> > On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com> wrote:
> >
> > > Yes, that is the correct one.
> > >
> > > On a separate note, are we removing documentation versioning from the
> > > website? How do we switch between the master/nightly version and the
> > > stable version for the python API doc? Maybe there's a switch
> > > somewhere but I cannot find it.
> > >
> > > Also, I find that the API doc for many methods are missing, for
> > > example, the Dataset.transform function has detailed documentation on
> > > input and output types, but the doc only shows the one-line
> > > description of the method
> > >
> > >
> > https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.glu
> > o
> > > n.data.Dataset.html?highlight=dataset#
> > > .
> > > Same for other methods such as filter, shard, etc.
> > >
> > > Thanks.
> > >
> > > Best,
> > > Haibin
> > >
> > >
> > > On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham
> > > <aa...@gmail.com>
> > > wrote:
> > >
> > > > Hi Haibin, you mean this one?
> > > >
> > > >
> > > https://github.com/apache/incubator-
> > mxnet/blob/master/docs/static_site
> > > /src/pages/api/faq/distributed_training.md
> > > > If so, it looks like a link update is needed.
> > > >
> > > > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin <ha...@gmail.com>
> > > > wrote:
> > > > >
> > > > > I find that the 'distributed training with KVStore' tutorial is
> gone.
> > > Are
> > > > > we adding it back?
> > > > >
> > > >
> > >
> > https://mxnet.apache.org/api/python/docs/tutorials/performance/index.h
> > > tml?highlight=distributed#distributed-training
> > > > >
> > > > >
> > > > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu
> > > > > <marco.g.abreu@gmail.com
> > > >
> > > > > wrote:
> > > > >
> > > > > > Thanks for the update, great job!
> > > > > >
> > > > > > Are the lighthouse results accessible somewhere? I'd be curious.
> > > > > >
> > > > > > -Marco
> > > > > >
> > > > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1.
> Okt.
> > > > 2019,
> > > > > > 13:49:
> > > > > >
> > > > > > > Update on the website:
> > > > > > >
> > > > > > > Highlights:
> > > > > > > - Broken links: a good amount of them have been fixed in this
> > > #16284
> > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284>,
> > > > > > > tutorials
> > > > have
> > > > > > > been
> > > > > > > reorganized (not yet deployed because of CI). A new 404 with
> > > > > > > quick
> > > > links
> > > > > > > has been added and deployed in #16287
> > > > > > > <https://github.com/apache/incubator-mxnet/pull/16287>
> > > > > > > - Broken Search: Search has been fixed in #16284
> > > > > > > <https://github.com/apache/incubator-mxnet/pull/16284> and
> > > > > > > merged
> > > > but
> > > > > > not
> > > > > > > deployed yet.
> > > > > > > - Google index issues: new website seems to be indexed now, in
> > > > > > > this
> > > > > > google
> > > > > > > search: "MXNet NDArray" <
> > > > https://www.google.com/search?q=mxnet+ndarray>
> > > > > > > new
> > > > > > > website is the top result. Redirects for old links to new ones
> > > > > > > have
> > > > been
> > > > > > > added to the .htaccess, thanks Soji for the help! #16342
> > > > > > > <https://github.com/apache/incubator-mxnet/pull/16342> is
> > > > > > > still
> > > > waiting
> > > > > > to
> > > > > > > be merged but a manual update to the website has been done in
> > > > > > > the meanwhile.
> > > > > > > - Automated analysis from google lighthouse scoring, compared
> > > > > > > to
> > > the
> > > > old
> > > > > > > website: Performance saw a > ~100% improvement, SEO saw a ~25%
> > > > > > improvement,
> > > > > > > and best practices improved by ~19%. Thanks Russell D. for
> > > > > > > running
> > > > the
> > > > > > > analysis.
> > > > > > >
> > > > > > > Remaining
> > > > > > > - *[high priority]* API docs are still missing some classes /
> > > > packages /
> > > > > > > methods. ETA for fix is EOW, root cause has been identified,
> > > > > > > we are
> > > > still
> > > > > > > deciding what's the best way forward for good discoverability
> > > > > > > as
> > > > well as
> > > > > > > good coverage and maintainability.
> > > > > > > - Adding quick links to directly access Python API docs on
> > > homepage.
> > > > > > >
> > > > > > > All the best,
> > > > > > >
> > > > > > > Thomas Delteil
> > > > > > >
> > > > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
> > > > thomas.delteil1@gmail.com
> > > > > > >
> > > > > > > a
> > > > > > > écrit :
> > > > > > >
> > > > > > > > @Philip Yes we're looking at link redirects for older links
> > > > > > > > that
> > > > might
> > > > > > be
> > > > > > > > hosted externally (using htaccess is my preferred way to
> > > > > > > > handle
> > > it
> > > > for
> > > > > > > now
> > > > > > > > as you sugested) and we'll use a broken link checker to
> > > > > > > > update
> > > the
> > > > > > links
> > > > > > > > that are hosted internally. We'll update the 404 to add an
> > > > explanation
> > > > > > on
> > > > > > > > the website update. Google indexes will slowly update across
> > > > > > > > the
> > > > week
> > > > > > so
> > > > > > > > the google search issues will be less of a problem.
> > > > > > > >
> > > > > > > > If you find any such links yourself, or missing tutorials,
> > > > > > > > please
> > > > > > > consider
> > > > > > > > stepping up and helping fixing them. The more people get
> > > > > > > > familiar
> > > > with
> > > > > > > the
> > > > > > > > new website architecture, the least likely it is to fall in
> > > > > > > > a
> > > > state of
> > > > > > > > stalled updates like the previous one.
> > > > > > > >
> > > > > > > > For the sphinx issues in the python mini-website, missing
> > > > > > > > API
> > > > classes,
> > > > > > if
> > > > > > > > anybody is familiar with it, I'd love for us to bring back
> > > > > > > > the
> > > > > > automatic
> > > > > > > > doc generation for each package so at least we have a list
> > > > > > > > of all
> > > > > > > available
> > > > > > > > classes in each sub package rather than relying on manual
> > > > insertion of
> > > > > > > each
> > > > > > > > class, which is brittle and not future proof. @Lin, Haibin
> > > > > > > > <ha...@amazon.com> if you have experience with it, could
> > > > > > > > we
> > > > sync up
> > > > > > > > offline on how you suggest to do that based on your
> > > > > > > > gluon-nlp
> > > > > > experience?
> > > > > > > >
> > > > > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and
> > > > > > > > Aaron is
> > > > on
> > > > > > PTO
> > > > > > > > in Europe, I'll try make time today to help with the fixes
> > > > > > > > since
> > > > it is
> > > > > > > > impacting a lot of users.
> > > > > > > >
> > > > > > > > In the meanwhile, any help is appreciated, and more than the
> > > value
> > > > of
> > > > > > the
> > > > > > > > fixes, let me repeat that there is tremendous value in
> > > > > > > > having
> > > more
> > > > > > people
> > > > > > > > familiar with the website build pipelines. Aaron is the main
> > > owner
> > > > for
> > > > > > > the
> > > > > > > > docs but he is already super busy with all his other
> > > > responsibilities.
> > > > > > > I'm
> > > > > > > > available to help if anybody is stuck. I believe Aaron has
> > > updated
> > > > the
> > > > > > > > READMEs on how to test the websites locally, if they're not
> > > clear,
> > > > feel
> > > > > > > > free to contribute your own explanations or ask for help
> > > > > > > > directly
> > > > to me
> > > > > > > by
> > > > > > > > email or on the discuss forum.
> > > > > > > >
> > > > > > > > Good hunting!
> > > > > > > >
> > > > > > > > Thomas
> > > > > > > >
> > > > > > > >
> > > > > > > >
> > > > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
> > > > marco.g.abreu@gmail.com
> > > > > > >
> > > > > > > a
> > > > > > > > écrit :
> > > > > > > >
> > > > > > > >> Good catch, Mu! Also good idea, Philip!
> > > > > > > >>
> > > > > > > >> Aaron and Thomas, are you going to work on this?
> > > > > > > >>
> > > > > > > >> -Marco
> > > > > > > >>
> > > > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com>
> > > wrote:
> > > > > > > >>
> > > > > > > >> > The questions I found are:
> > > > > > > >> >
> > > > > > > >> > 1. Not ever page contains, especially the homepage
> > > > > > > >> >
> > > > > > > >> >
> > > > > > > >>
> > > > > > >
> > > > > >
> > > >
> > > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analy
> > > tics.js
> > > > > > > >> > 2. The correct tracking id is UA-96378503-1 instead of
> > > > > > UA-96378503-11
> > > > > > > in
> > > > > > > >> >
> > > > > > > >> >
> > > > > > > >>
> > > > > > >
> > > > > >
> > > >
> > > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analy
> > > tics.js
> > > > > > > >> >
> > > > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li
> > > > > > > >> > <mu...@gmail.com>
> > > > wrote:
> > > > > > > >> >
> > > > > > > >> > > I think the reason is that the google tracker is not
> > > included
> > > > in
> > > > > > the
> > > > > > > >> new
> > > > > > > >> > > website.
> > > > > > > >> > >
> > > > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > > > > > > >> marco.g.abreu@gmail.com>
> > > > > > > >> > > wrote:
> > > > > > > >> > >
> > > > > > > >> > >> Hello,
> > > > > > > >> > >>
> > > > > > > >> > >> I checked the Google Analytics statistics and the
> > > > > > > >> > >> launch of
> > > > the
> > > > > > new
> > > > > > > >> > >> website reduced the traffic by over 80%:
> > > > > > > >> > >>
> > > > > > > >> > >> [image: image.png]
> > > > > > > >> > >>
> > > > > > > >> > >> (Please let me know if the image is not visible)
> > > > > > > >> > >>
> > > > > > > >> > >> How shall we handle this?
> > > > > > > >> > >>
> > > > > > > >> > >> Best regards,
> > > > > > > >> > >> Marco
> > > > > > > >> > >>
> > > > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> > > > > > > patric.zhao@intel.com>
> > > > > > > >> > >> wrote:
> > > > > > > >> > >>
> > > > > > > >> > >>> For the install page [1], I suggest to add the
> > > > > > > >> > >>> selection
> > > of
> > > > > > > backend
> > > > > > > >> > >>> DeepNumpy [2] which will be more clean.
> > > > > > > >> > >>>
> > > > > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > > > > > >> > >>> [2] https://numpy.mxnet.io/#installation
> > > > > > > >> > >>>
> > > > > > > >> > >>>
> > > > > > > >> > >>>
> > > > > > > >> > >>> > -----Original Message-----
> > > > > > > >> > >>> > From: kellen sunderland
> > > > > > > >> > >>> > <ke...@gmail.com>
> > > > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > > > > > >> > >>> > To: dev@mxnet.incubator.apache.org
> > > > > > > >> > >>> > Subject: Re: new website, docs code freeze
> > > > > > > >> > >>> >
> > > > > > > >> > >>> > New site looks good.  I do notice that a few
> > > > > > > >> > >>> > tutorials
> > > > from
> > > > > > the
> > > > > > > >> old
> > > > > > > >> > >>> site are
> > > > > > > >> > >>> > missing (for example the TensorRT tutorial).  Any
> > > > > > > >> > >>> > plans
> > > to
> > > > > > bring
> > > > > > > >> them
> > > > > > > >> > >>> back?
> > > > > > > >> > >>> >
> > > > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > > > > > >> > haibin.lin.aws@gmail.com>
> > > > > > > >> > >>> > wrote:
> > > > > > > >> > >>> >
> > > > > > > >> > >>> > > Another issue I found with the current website:
> > > > > > > >> > >>> > > the
> > > > Sphinx
> > > > > > > >> object
> > > > > > > >> > >>> > > inventory
> > > > > > > >> > >>> > > <https://www.sphinx-
> > > > > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > > > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is
> > > > missing.
> > > > > > > >> GluonNLP
> > > > > > > >> > >>> > > relies on this file to link document across
> projects.
> > > > Shall
> > > > > > we
> > > > > > > >> add
> > > > > > > >> > it
> > > > > > > >> > >>> > > back?
> > > > > > > >> > >>> > >
> > > > > > > >> > >>> > > Best,
> > > > > > > >> > >>> > > Haibin
> > > > > > > >> > >>> > >
> > > > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> > > > > > > lgo@mobsol.be>
> > > > > > > >> > >>> wrote:
> > > > > > > >> > >>> > >
> > > > > > > >> > >>> > > > Hi,
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > > > > > >> > >>> > > > <th...@gmail.com>
> > > > > > > >> > >>> > > > wrote:
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > > Thanks all for the feedback,
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > We'll send an email next week with the list
> > > > > > > >> > >>> > > > > of
> > > > missing
> > > > > > > >> > features,
> > > > > > > >> > >>> > > content
> > > > > > > >> > >>> > > > > and bugs that we plan to fix.
> > > > > > > >> > >>> > > > > We took the option of releasing early, with
> > > > > > > >> > >>> > > > > some
> > > > > > features
> > > > > > > >> > >>> missing,
> > > > > > > >> > >>> > > rather
> > > > > > > >> > >>> > > > > than trying to be at feature parity with the
> > > > > > > >> > >>> > > > > old
> > > > website
> > > > > > > >> before
> > > > > > > >> > >>> > > launching
> > > > > > > >> > >>> > > > > the website.
> > > > > > > >> > >>> > > > > The reason why we decided to do that is
> two-fold:
> > > > > > > >> > >>> > > > > - playing catch-up with docs in master
> > > > > > > >> > >>> > > > > introduce
> > > > daily
> > > > > > > >> > conflicts
> > > > > > > >> > >>> > > > > that
> > > > > > > >> > >>> > > > need
> > > > > > > >> > >>> > > > > to be resolved and introduce opportunity for
> > > errors
> > > > > > > >> > >>> > > > > - by releasing early, we can take advantage
> > > > > > > >> > >>> > > > > of the
> > > > > > > community
> > > > > > > >> > >>> > > > contributions
> > > > > > > >> > >>> > > > > in modifying whatever the community feels
> > > > > > > >> > >>> > > > > like a
> > > > better
> > > > > > > way
> > > > > > > >> of
> > > > > > > >> > >>> > > > > doing things.
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > One of the goals of the new website was to
> > > > disentangle
> > > > > > the
> > > > > > > >> main
> > > > > > > >> > >>> > > website,
> > > > > > > >> > >>> > > > > now called "static_site" to the
> > > > > > > >> > >>> > > > > auto-generated
> > > > docs. Now
> > > > > > > the
> > > > > > > >> > >>> > > > > overall
> > > > > > > >> > >>> > > site
> > > > > > > >> > >>> > > > > is made of a main static site, with easy to
> > > > > > > >> > >>> > > > > modify
> > > > > > content
> > > > > > > >> and
> > > > > > > >> > >>> > > > > easy to understand architecture for anybody
> > > familiar
> > > > > > with
> > > > > > > >> basic
> > > > > > > >> > >>> > > > > html, and a collection of mini-websites for
> > > > > > > >> > >>> > > > > each
> > > > > > language
> > > > > > > >> > >>> bindings
> > > > > > > >> > >>> > > > > that can be
> > > > > > > >> > >>> > > built
> > > > > > > >> > >>> > > > in
> > > > > > > >> > >>> > > > > isolation and that are self-contained.
> > > > > > > >> > >>> > > > > Actually
> > > the
> > > > new
> > > > > > CI
> > > > > > > >> jobs
> > > > > > > >> > >>> > > > > builds
> > > > > > > >> > >>> > > > all
> > > > > > > >> > >>> > > > > of them in parallel independently.
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > There is PLENTY of room for improvement, it
> > > > > > > >> > >>> > > > > would
> > > be
> > > > > > great
> > > > > > > >> if
> > > > > > > >> > the
> > > > > > > >> > >>> > > > community
> > > > > > > >> > >>> > > > > can help contribute to bring the new website
> > > > > > > >> > >>> > > > > at
> > > the
> > > > same
> > > > > > > >> level
> > > > > > > >> > of
> > > > > > > >> > >>> > > content
> > > > > > > >> > >>> > > > > richness as the old one, and then even
> further.
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > Missing features:
> > > > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do not
> > > > > > > >> > >>> > > > > have
> > > the
> > > > > > full
> > > > > > > >> list
> > > > > > > >> > of
> > > > > > > >> > >>> > > > operators
> > > > > > > >> > >>> > > > > and classes. There is a mix of auto-generated
> > > > > > > >> > >>> > > > > docs
> > > > based
> > > > > > > on
> > > > > > > >> > >>> > > > > packages,
> > > > > > > >> > >>> > > and
> > > > > > > >> > >>> > > > > some docs that are spelled out manually to
> > > > > > > >> > >>> > > > > improve
> > > > the
> > > > > > > >> logical
> > > > > > > >> > >>> > > > organization
> > > > > > > >> > >>> > > > > of the package where there is a need. The
> > > > > > > >> > >>> > > > > drawback
> > > > with
> > > > > > > >> > manually
> > > > > > > >> > >>> > > > > listed classes in a package is that it's very
> > > > > > > >> > >>> > > > > easy
> > > > to
> > > > > > miss
> > > > > > > >> > some.
> > > > > > > >> > >>> > > > > If someone
> > > > > > > >> > >>> > > > wanted
> > > > > > > >> > >>> > > > > to build a sanity check that would
> > > > > > > >> > >>> > > > > automatically
> > > > detect
> > > > > > > >> which
> > > > > > > >> > >>> > > > > classes
> > > > > > > >> > >>> > > are
> > > > > > > >> > >>> > > > > not in the documentation, or if someone knew
> > > > > > > >> > >>> > > > > how
> > > to
> > > > > > enable
> > > > > > > >> that
> > > > > > > >> > >>> > > > > with sphinx, that would be a great addition
> > > > > > > >> > >>> > > > > to the
> > > > > > python
> > > > > > > >> docs
> > > > > > > >> > >>> > > > > - There is missing content in the python
> > > tutorials,
> > > > and
> > > > > > > the
> > > > > > > >> > >>> > > > discoverability
> > > > > > > >> > >>> > > > > could be improved. Some old tutorials have
> > > > > > > >> > >>> > > > > not
> > > been
> > > > > > > migrated
> > > > > > > >> > >>> just yet.
> > > > > > > >> > >>> > > > > - The nightly tests on tutorials have been
> > > disabled
> > > > for
> > > > > > > now
> > > > > > > >> > >>> > > > > - There is no "Download jupyter notebook" for
> > > > tutorials
> > > > > > > just
> > > > > > > >> > yet.
> > > > > > > >> > >>> > > > > - Non-python tutorials might benefit from a
> > > > > > > >> > >>> > > > > blurb
> > > > > > > >> description
> > > > > > > >> > and
> > > > > > > >> > >>> > > > > a
> > > > > > > >> > >>> > > > better
> > > > > > > >> > >>> > > > > content organization.
> > > > > > > >> > >>> > > > > - Python tutorials could be better organized,
> > > have a
> > > > > > > picture
> > > > > > > >> > >>> > > accompanying
> > > > > > > >> > >>> > > > > their description
> > > > > > > >> > >>> > > > > - There is no site-wide search, this is not
> > > > > > > >> > >>> > > > > an
> > > easy
> > > > > > > problem
> > > > > > > >> to
> > > > > > > >> > >>> > > > > solve to
> > > > > > > >> > >>> > > > be
> > > > > > > >> > >>> > > > > fair given the static nature of the website,
> > > > > > > >> > >>> > > > > but
> > > > maybe
> > > > > > an
> > > > > > > >> > >>> external
> > > > > > > >> > >>> > > plugin
> > > > > > > >> > >>> > > > > might be able to give a half-way solution
> > > > > > > >> > >>> > > > > - There is no version selector for the docs
> > > > > > > >> > >>> > > > > - There is bug in search box of the python
> > > > > > > >> > >>> > > > > docs,
> > > but
> > > > > > this
> > > > > > > is
> > > > > > > >> > just
> > > > > > > >> > >>> > > > > a
> > > > > > > >> > >>> > > small
> > > > > > > >> > >>> > > > > JS bug that can be fixed easily (on my list
> > > > > > > >> > >>> > > > > for
> > > next
> > > > > > week)
> > > > > > > >> > >>> > > > > - Most old links have not had a redirect put
> > > > > > > >> > >>> > > > > in
> > > > place.
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > I noticed on the Ubuntu home page in the
> > > > > > > >> > >>> > > > Developer
> > > > > > dropdown
> > > > > > > >> that
> > > > > > > >> > >>> the
> > > > > > > >> > >>> > > > link MXNet on Ubuntu <
> > > > https://mxnet.incubator.apache.org/install/index.html
> > > > > > > >> > >>> > > > >with
> > > > > > > >> > >>> > > > Nvidia
> > > > > > > >> > >>> > > > <
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > >
> > > > > > > >> > >>>
> > > > > > > >>
> > > > > >
> > > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > > > > > >> > >>> > > mxnet/
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > doesn't work anymore, it points to:
> > > > > > > >> > >>> > > >
> > > https://mxnet.incubator.apache.org/install/index.html
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > Also, on the MXNet 'getting started' page
> > > > > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_started
> > > > > > > >> > >>> > > > ,
> > > the
> > > > link
> > > > > > > >> > "Ubuntu
> > > > > > > >> > >>> > > > Installation Guide" at the bottom doesn't work
> > > > either, it
> > > > > > > >> points
> > > > > > > >> > >>> to:
> > > > > > > >> > >>> > > >
> > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > I suggest you do a scan of the new website to
> > > > > > > >> > >>> > > > find
> > > > these
> > > > > > > >> dangling
> > > > > > > >> > >>> links.
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > regards,
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > Lieven
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > > > > We'll formalize this in github issues next
> > > > > > > >> > >>> > > > > week,
> > > but
> > > > > > they
> > > > > > > >> are
> > > > > > > >> > all
> > > > > > > >> > >>> > > fairly
> > > > > > > >> > >>> > > > > small and helping out on these would be a
> > > > > > > >> > >>> > > > > great
> > > way
> > > > of
> > > > > > > >> > >>> > > > > familiarizing yourself with the new website
> > > > > > > >> > >>> > > > > build
> > > > system
> > > > > > > and
> > > > > > > >> > >>> website
> > > > > > > >> > >>> > architecture.
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > >  Thanks all for the feedback, please keep it
> > > coming!
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > Thomas Delteil
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > > > > It looks like my previous email did not go
> > > > through.
> > > > > > > >> > Re-sending:
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > > Hi Aaron,
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > > The website looks cool. Thanks for pushing
> > > > > > > >> > >>> > > > > > this
> > > to
> > > > > > > >> > production.
> > > > > > > >> > >>> A
> > > > > > > >> > >>> > > > > > few
> > > > > > > >> > >>> > > > > > questions:
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > > - I was looking for the API doc for
> > > > > > > >> > >>> > > > > > mx.sym.dot,
> > > > but I
> > > > > > > find
> > > > > > > >> > that
> > > > > > > >> > >>> > > > > > most operators under mx.sym.* are missing.
> > > > > > > >> > >>> > > > > > Is
> > > this
> > > > > > > >> expected?
> > > > > > > >> > >>> > > > > > - I was also checking the search
> > > > > > > >> > >>> > > > > > functionality,
> > > > > > > searching
> > > > > > > >> the
> > > > > > > >> > >>> > > > > > keyword "ndarray" only returns one result
> > > > > > > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > > > > > >> > >>> > > > doesn't
> > > > > > > >> > >>> > > > > > seem right. There animation keeps going
> > > > (Searching. ->
> > > > > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives me
> > > > > > > >> > >>> > > > > > an
> > > > > > impression
> > > > > > > >> that
> > > > > > > >> > >>> > > > > > the search is never completely done(?).
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > > Best,
> > > > > > > >> > >>> > > > > > Haibin
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya
> > > > > > > >> > >>> > > > > > Bapat
> > > <
> > > > > > > >> > >>> > > chai.bapat@gmail.com>
> > > > > > > >> > >>> > > > > > wrote:
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > > > > Thanks Aaron and the team for launching
> > > > > > > >> > >>> > > > > > > new
> > > > website!
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > 1. There's no search button anywhere on
> > > > > > > >> > >>> > > > > > > the
> > > > landing
> > > > > > > >> page.
> > > > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without
> > > search
> > > > > > > button
> > > > > > > >> I
> > > > > > > >> > >>> dont
> > > > > > > >> > >>> > > > > > > have
> > > > > > > >> > >>> > > > > > option
> > > > > > > >> > >>> > > > > > > but to go manually on each menu). Only
> > > > > > > >> > >>> > > > > > > when I
> > > > go to
> > > > > > > >> > >>> > > > > > > Docs&Tutorials
> > > > > > > >> > >>> > > ->
> > > > > > > >> > >>> > > > > FAQ
> > > > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got what
> > > > > > > >> > >>> > > > > > > -> I
> > > > wanted).
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > Suggestions Might want to make this
> > > > > > > >> > >>> > > > > > > searchable and pop FAQ
> > > > on
> > > > > > the
> > > > > > > >> main
> > > > > > > >> > >>> > > > > > > page (or somewhere prominent)
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > Thanks,
> > > > > > > >> > >>> > > > > > > Chai
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław
> > > Trędak
> > > > <
> > > > > > > >> > >>> > > ptrendx@apache.org>
> > > > > > > >> > >>> > > > > > > wrote:
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > > There seems to be a problem with (at
> > > > > > > >> > >>> > > > > > > > least
> > > > Python,
> > > > > > > did
> > > > > > > >> > not
> > > > > > > >> > >>> > > > > > > > check
> > > > > > > >> > >>> > > > > > others)
> > > > > > > >> > >>> > > > > > > > APIs. For example this page:
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > >
> > > > > > > >> > >>> >
> > > > > > > >> >
> > > > > > >
> > > >
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autog
> > > > en
> > > > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > > > says that it is a convenience method
> > > > > > > >> > >>> > > > > > > > for
> > > > argmax
> > > > > > > (with
> > > > > > > >> a
> > > > > > > >> > >>> > > > > > > > link),
> > > > > > > >> > >>> > > but
> > > > > > > >> > >>> > > > > > > > clicking that link just points to the
> > > > > > > >> > >>> > > > > > > > same
> > > > website
> > > > > > > >> (and
> > > > > > > >> > so
> > > > > > > >> > >>> > > > > > > > user
> > > > > > > >> > >>> > > has
> > > > > > > >> > >>> > > > > no
> > > > > > > >> > >>> > > > > > > way
> > > > > > > >> > >>> > > > > > > > of getting to the docs of the actual
> > > > operator).
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > > > When I tried to manually remove Symbol
> > > > > > > >> > >>> > > > > > > > from
> > > > the
> > > > > > URL
> > > > > > > to
> > > > > > > >> > get
> > > > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a
> > > > > > > >> > >>> > > > > > > > "Not
> > > > found"
> > > > > > > >> webpage
> > > > > > > >> > >>> > > > > > > > which I
> > > > > > > >> > >>> > > guess
> > > > > > > >> > >>> > > > > > also
> > > > > > > >> > >>> > > > > > > > should not happen (ignoring the fact
> > > > > > > >> > >>> > > > > > > > that
> > > this
> > > > > > > should
> > > > > > > >> > >>> exist,
> > > > > > > >> > >>> > > going
> > > > > > > >> > >>> > > > to
> > > > > > > >> > >>> > > > > > > > random URL under the website should
> > > > > > > >> > >>> > > > > > > > redirect
> > > > to
> > > > > > the
> > > > > > > >> main
> > > > > > > >> > >>> > > > > > > > page I
> > > > > > > >> > >>> > > > > think).
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > > > Przemek
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> > > > > > > apeforest@gmail.com
> > > > > > > >> >
> > > > > > > >> > >>> wrote:
> > > > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and
> > > > > > > >> > >>> > > > > > > > > many
> > > > others
> > > > > > > for
> > > > > > > >> > >>> > > > > > > > > launching
> > > > > > > >> > >>> > > > > this!
> > > > > > > >> > >>> > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin
> > > Meier
> > > > <
> > > > > > > >> > >>> > > > carinmeier@gmail.com>
> > > > > > > >> > >>> > > > > > > > wrote:
> > > > > > > >> > >>> > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > > > > > >> > >>> > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM
> > > > > > > >> > >>> > > > > > > > > > Aaron
> > > > > > Markham <
> > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > > > > > >> > >>> > > > > > > > > > wrote:
> > > > > > > >> > >>> > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is
> launched.
> > > You
> > > > > > might
> > > > > > > >> need
> > > > > > > >> > to
> > > > > > > >> > >>> > > > > > > > > > > clear
> > > > > > > >> > >>> > > > > your
> > > > > > > >> > >>> > > > > > > > cache.
> > > > > > > >> > >>> > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > Cheers, Aaron
> > > > > > > >> > >>> > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM
> > > > > > > >> > >>> > > > > > > > > > > Aaron
> > > > > > Markham
> > > > > > > <
> > > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> > > > > > > >> > >>> > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > wrote:
> > > > > > > >> > >>> > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed
> > > > > > > >> > >>> > > > > > > > > > > > CI,
> > > > but
> > > > > > > please
> > > > > > > >> > >>> > > > > > > > > > > > continue
> > > > > > > >> > >>> > > > > holding
> > > > > > > >> > >>> > > > > > > > off on
> > > > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there
> > > > > > > >> > >>> > > > > > > > > > > > are
> > > > any
> > > > > > > >> > objections,
> > > > > > > >> > >>> > > > > > > > > > > > I'd
> > > > > > > >> > >>> > > > like
> > > > > > > >> > >>> > > > > to
> > > > > > > >> > >>> > > > > > > > launch
> > > > > > > >> > >>> > > > > > > > > > > > the new website today.
> > > > > > > >> > >>> > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM
> > > Aaron
> > > > > > > Markham
> > > > > > > >> <
> > > > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > > > > > >> > >>> > > > > > > > > > > wrote:
> > > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > > Hi everyone, The last two PRs
> > > > > > > >> > >>> > > > > > > > > > > > > [1][2] for the
> > > new
> > > > > > > website
> > > > > > > >> and
> > > > > > > >> > >>> > > > > > > > > > > > > docs
> > > > > > > >> > >>> > > have
> > > > > > > >> > >>> > > > > > > passed
> > > > > > > >> > >>> > > > > > > > CI
> > > > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not make
> > > > changes to
> > > > > > > >> /docs
> > > > > > > >> > or
> > > > > > > >> > >>> > > > > > > > > > > > > /ci
> > > > > > > >> > >>> > > > until
> > > > > > > >> > >>> > > > > > we
> > > > > > > >> > >>> > > > > > > > get
> > > > > > > >> > >>> > > > > > > > > > > > > these approved and merged.
> > > > > > > >> > >>> > > > > > > > > > > > > Every
> > > > time
> > > > > > > >> there's a
> > > > > > > >> > >>> > > > > > > > > > > > > merge
> > > > > > > >> > >>> > > > > > conflict
> > > > > > > >> > >>> > > > > > > > it has
> > > > > > > >> > >>> > > > > > > > > > > > > set us back a day or two
> > > > > > > >> > >>> > > > > > > > > > > > > while
> > > > > > shepherding
> > > > > > > >> the
> > > > > > > >> > >>> PRs
> > > > > > > >> > >>> > > > through
> > > > > > > >> > >>> > > > > CI
> > > > > > > >> > >>> > > > > > > > again.
> > > > > > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic
> > > issues
> > > > > > > >> discovered
> > > > > > > >> > >>> in
> > > > > > > >> > >>> > > > > > > > > > > > > a
> > > > > > > >> > >>> > > > > review,
> > > > > > > >> > >>> > > > > > I
> > > > > > > >> > >>> > > > > > > > > > > > > recommend that we hold any
> > > > > > > >> > >>> > > > > > > > > > > > > patches
> > > > or
> > > > > > > >> updates
> > > > > > > >> > to
> > > > > > > >> > >>> > > > > > > > > > > > > the
> > > > > > > >> > >>> > > PRs
> > > > > > > >> > >>> > > > to
> > > > > > > >> > >>> > > > > > > > follow-up
> > > > > > > >> > >>> > > > > > > > > > > > > PRs.
> > > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > > There are four steps to
> launch:
> > > > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved,
> > > > > > > >> > >>> > > > > > > > > > > > > the
> > > > plan
> > > > > > is
> > > > > > > to
> > > > > > > >> > >>> merge
> > > > > > > >> > >>> > > 15885
> > > > > > > >> > >>> > > > to
> > > > > > > >> > >>> > > > > > > > delete
> > > > > > > >> > >>> > > > > > > > > > the
> > > > > > > >> > >>> > > > > > > > > > > > > old content first.
> > > > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge
> > > > > > > >> > >>> > > > > > > > > > > > > 15883 to
> > > > add
> > > > > > in
> > > > > > > >> the
> > > > > > > >> > new
> > > > > > > >> > >>> > > > > > > > > > > > > CI
> > > > > > > >> > >>> > > > flows
> > > > > > > >> > >>> > > > > > and
> > > > > > > >> > >>> > > > > > > > > > updates
> > > > > > > >> > >>> > > > > > > > > > > > > to the content Thomas and I
> > > > > > > >> > >>> > > > > > > > > > > > > have
> > > > already
> > > > > > > had
> > > > > > > >> > >>> > > > > > > > > > > > > merged in
> > > > > > > >> > >>> > > > > 15884
> > > > > > > >> > >>> > > > > > > [3].
> > > > > > > >> > >>> > > > > > > > > > > > > 3. I will change the website
> > > > validation
> > > > > > > >> Jenkins
> > > > > > > >> > >>> > > pipeline
> > > > > > > >> > >>> > > > to
> > > > > > > >> > >>> > > > > > > > point to
> > > > > > > >> > >>> > > > > > > > > > > > > the new pipeline.
> > > > > > > >> > >>> > > > > > > > > > > > > 4. I will change the website
> > > > publishing
> > > > > > > >> Jenkins
> > > > > > > >> > >>> > > pipeline
> > > > > > > >> > >>> > > > to
> > > > > > > >> > >>> > > > > > > > point to
> > > > > > > >> > >>> > > > > > > > > > > > > its new pipeline as well.
> > > > > > > >> > >>> > > > > > > > > > > > > Once
> > > > > > triggered,
> > > > > > > >> the
> > > > > > > >> > old
> > > > > > > >> > >>> > > > > > > > > > > > > site
> > > > > > > >> > >>> > > > will
> > > > > > > >> > >>> > > > > > be
> > > > > > > >> > >>> > > > > > > > > > > > > replaced with the new one.
> > > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to
> > > > > > > >> > >>> > > > > > > > > > > > > update
> > > > the DNS
> > > > > > > for
> > > > > > > >> > >>> > > > beta.mxnet.io
> > > > > > > >> > >>> > > > > > to
> > > > > > > >> > >>> > > > > > > > point
> > > > > > > >> > >>> > > > > > > > > > to
> > > > > > > >> > >>> > > > > > > > > > > > > production, and there will
> > > > > > > >> > >>> > > > > > > > > > > > > likely
> > > be
> > > > > > some
> > > > > > > >> > >>> > > > > redirect/.htaccess
> > > > > > > >> > >>> > > > > > > > updates
> > > > > > > >> > >>> > > > > > > > > > > > > needed next week to assist
> > > > > > > >> > >>> > > > > > > > > > > > > with
> > > any
> > > > deep
> > > > > > > >> > linking
> > > > > > > >> > >>> > > > > > > > > > > > > and
> > > > > > > >> > >>> > > 404
> > > > > > > >> > >>> > > > > > issues
> > > > > > > >> > >>> > > > > > > > that
> > > > > > > >> > >>> > > > > > > > > > > > > pop up.
> > > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > > Cheers, Aaron
> > > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > > > > > [1]
> > > > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15
> > > > > > > >> > >>> > > 885
> > > > > > > >> > >>> > > > > > > > > > > > > [2]
> > > > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15
> > > > > > > >> > >>> > > 883
> > > > > > > >> > >>> > > > > > > > > > > > > [3]
> > > > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15
> > > > > > > >> > >>> > > 884
> > > > > > > >> > >>> > > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > > >
> > > > > > > >> > >>> > > > > > > > >
> > > > > > > >> > >>> > > > > > > >
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > --
> > > > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > > > > > >> > >>> > > > > > > *+1 (973) 953-6299*
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > > [image:
> > > > https://www.linkedin.com//in/chaibapat25]
> > > > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
> > > > > > > >> > >>> > > > > > > ]
> > > > > > > >> > >>> > > > > > >
> > <https://www.facebook.com/chaibapchya>[image:
> > > > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > > > > > >> > >>> > > > > > >[image:
> > > > > > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > > ><https://www.linkedin.com//in/chaibapchya/
> > > > > > > >> > >>> > > > > > >>
> > > > > > > >> > >>> > > > > > >
> > > > > > > >> > >>> > > > > >
> > > > > > > >> > >>> > > > >
> > > > > > > >> > >>> > > >
> > > > > > > >> > >>> > >
> > > > > > > >> > >>>
> > > > > > > >> > >>
> > > > > > > >> >
> > > > > > > >>
> > > > > > > >
> > > > > > >
> > > > > >
> > > >
> > >
>

RE: new website, docs code freeze

["Zhao, Patric" <pa...@intel.com>]

I find there is no "search bar" in the website today. 

Could anyone check it?

Thanks,

--Patric

> -----Original Message-----
> From: Thomas DELTEIL <th...@gmail.com>
> Sent: Saturday, October 5, 2019 3:41 AM
> To: dev@mxnet.incubator.apache.org
> Subject: Re: new website, docs code freeze
> 
> Hi Haibin,
> 
> We are currently working with Soji on overhauling the way the python docs
> are organized to get better and more consistent docs with full coverage, the
> current system is a brittle and hard to browse. We hope to finish our dev
> work by tonight, ETA for early next week.
> There is no ETA on bringing back the old docs, though that's the next highest
> priority feature on the list after improving the coverage of the python API.
> 
> All the best,
> 
> Thomas Delteil
> 
> On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com> wrote:
> 
> > Yes, that is the correct one.
> >
> > On a separate note, are we removing documentation versioning from the
> > website? How do we switch between the master/nightly version and the
> > stable version for the python API doc? Maybe there's a switch
> > somewhere but I cannot find it.
> >
> > Also, I find that the API doc for many methods are missing, for
> > example, the Dataset.transform function has detailed documentation on
> > input and output types, but the doc only shows the one-line
> > description of the method
> >
> >
> https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.glu
> o
> > n.data.Dataset.html?highlight=dataset#
> > .
> > Same for other methods such as filter, shard, etc.
> >
> > Thanks.
> >
> > Best,
> > Haibin
> >
> >
> > On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham
> > <aa...@gmail.com>
> > wrote:
> >
> > > Hi Haibin, you mean this one?
> > >
> > >
> > https://github.com/apache/incubator-
> mxnet/blob/master/docs/static_site
> > /src/pages/api/faq/distributed_training.md
> > > If so, it looks like a link update is needed.
> > >
> > > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin <ha...@gmail.com>
> > > wrote:
> > > >
> > > > I find that the 'distributed training with KVStore' tutorial is gone.
> > Are
> > > > we adding it back?
> > > >
> > >
> >
> https://mxnet.apache.org/api/python/docs/tutorials/performance/index.h
> > tml?highlight=distributed#distributed-training
> > > >
> > > >
> > > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu
> > > > <marco.g.abreu@gmail.com
> > >
> > > > wrote:
> > > >
> > > > > Thanks for the update, great job!
> > > > >
> > > > > Are the lighthouse results accessible somewhere? I'd be curious.
> > > > >
> > > > > -Marco
> > > > >
> > > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt.
> > > 2019,
> > > > > 13:49:
> > > > >
> > > > > > Update on the website:
> > > > > >
> > > > > > Highlights:
> > > > > > - Broken links: a good amount of them have been fixed in this
> > #16284
> > > > > > <https://github.com/apache/incubator-mxnet/pull/16284>,
> > > > > > tutorials
> > > have
> > > > > > been
> > > > > > reorganized (not yet deployed because of CI). A new 404 with
> > > > > > quick
> > > links
> > > > > > has been added and deployed in #16287
> > > > > > <https://github.com/apache/incubator-mxnet/pull/16287>
> > > > > > - Broken Search: Search has been fixed in #16284
> > > > > > <https://github.com/apache/incubator-mxnet/pull/16284> and
> > > > > > merged
> > > but
> > > > > not
> > > > > > deployed yet.
> > > > > > - Google index issues: new website seems to be indexed now, in
> > > > > > this
> > > > > google
> > > > > > search: "MXNet NDArray" <
> > > https://www.google.com/search?q=mxnet+ndarray>
> > > > > > new
> > > > > > website is the top result. Redirects for old links to new ones
> > > > > > have
> > > been
> > > > > > added to the .htaccess, thanks Soji for the help! #16342
> > > > > > <https://github.com/apache/incubator-mxnet/pull/16342> is
> > > > > > still
> > > waiting
> > > > > to
> > > > > > be merged but a manual update to the website has been done in
> > > > > > the meanwhile.
> > > > > > - Automated analysis from google lighthouse scoring, compared
> > > > > > to
> > the
> > > old
> > > > > > website: Performance saw a > ~100% improvement, SEO saw a ~25%
> > > > > improvement,
> > > > > > and best practices improved by ~19%. Thanks Russell D. for
> > > > > > running
> > > the
> > > > > > analysis.
> > > > > >
> > > > > > Remaining
> > > > > > - *[high priority]* API docs are still missing some classes /
> > > packages /
> > > > > > methods. ETA for fix is EOW, root cause has been identified,
> > > > > > we are
> > > still
> > > > > > deciding what's the best way forward for good discoverability
> > > > > > as
> > > well as
> > > > > > good coverage and maintainability.
> > > > > > - Adding quick links to directly access Python API docs on
> > homepage.
> > > > > >
> > > > > > All the best,
> > > > > >
> > > > > > Thomas Delteil
> > > > > >
> > > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
> > > thomas.delteil1@gmail.com
> > > > > >
> > > > > > a
> > > > > > écrit :
> > > > > >
> > > > > > > @Philip Yes we're looking at link redirects for older links
> > > > > > > that
> > > might
> > > > > be
> > > > > > > hosted externally (using htaccess is my preferred way to
> > > > > > > handle
> > it
> > > for
> > > > > > now
> > > > > > > as you sugested) and we'll use a broken link checker to
> > > > > > > update
> > the
> > > > > links
> > > > > > > that are hosted internally. We'll update the 404 to add an
> > > explanation
> > > > > on
> > > > > > > the website update. Google indexes will slowly update across
> > > > > > > the
> > > week
> > > > > so
> > > > > > > the google search issues will be less of a problem.
> > > > > > >
> > > > > > > If you find any such links yourself, or missing tutorials,
> > > > > > > please
> > > > > > consider
> > > > > > > stepping up and helping fixing them. The more people get
> > > > > > > familiar
> > > with
> > > > > > the
> > > > > > > new website architecture, the least likely it is to fall in
> > > > > > > a
> > > state of
> > > > > > > stalled updates like the previous one.
> > > > > > >
> > > > > > > For the sphinx issues in the python mini-website, missing
> > > > > > > API
> > > classes,
> > > > > if
> > > > > > > anybody is familiar with it, I'd love for us to bring back
> > > > > > > the
> > > > > automatic
> > > > > > > doc generation for each package so at least we have a list
> > > > > > > of all
> > > > > > available
> > > > > > > classes in each sub package rather than relying on manual
> > > insertion of
> > > > > > each
> > > > > > > class, which is brittle and not future proof. @Lin, Haibin
> > > > > > > <ha...@amazon.com> if you have experience with it, could
> > > > > > > we
> > > sync up
> > > > > > > offline on how you suggest to do that based on your
> > > > > > > gluon-nlp
> > > > > experience?
> > > > > > >
> > > > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and
> > > > > > > Aaron is
> > > on
> > > > > PTO
> > > > > > > in Europe, I'll try make time today to help with the fixes
> > > > > > > since
> > > it is
> > > > > > > impacting a lot of users.
> > > > > > >
> > > > > > > In the meanwhile, any help is appreciated, and more than the
> > value
> > > of
> > > > > the
> > > > > > > fixes, let me repeat that there is tremendous value in
> > > > > > > having
> > more
> > > > > people
> > > > > > > familiar with the website build pipelines. Aaron is the main
> > owner
> > > for
> > > > > > the
> > > > > > > docs but he is already super busy with all his other
> > > responsibilities.
> > > > > > I'm
> > > > > > > available to help if anybody is stuck. I believe Aaron has
> > updated
> > > the
> > > > > > > READMEs on how to test the websites locally, if they're not
> > clear,
> > > feel
> > > > > > > free to contribute your own explanations or ask for help
> > > > > > > directly
> > > to me
> > > > > > by
> > > > > > > email or on the discuss forum.
> > > > > > >
> > > > > > > Good hunting!
> > > > > > >
> > > > > > > Thomas
> > > > > > >
> > > > > > >
> > > > > > >
> > > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
> > > marco.g.abreu@gmail.com
> > > > > >
> > > > > > a
> > > > > > > écrit :
> > > > > > >
> > > > > > >> Good catch, Mu! Also good idea, Philip!
> > > > > > >>
> > > > > > >> Aaron and Thomas, are you going to work on this?
> > > > > > >>
> > > > > > >> -Marco
> > > > > > >>
> > > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com>
> > wrote:
> > > > > > >>
> > > > > > >> > The questions I found are:
> > > > > > >> >
> > > > > > >> > 1. Not ever page contains, especially the homepage
> > > > > > >> >
> > > > > > >> >
> > > > > > >>
> > > > > >
> > > > >
> > >
> > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analy
> > tics.js
> > > > > > >> > 2. The correct tracking id is UA-96378503-1 instead of
> > > > > UA-96378503-11
> > > > > > in
> > > > > > >> >
> > > > > > >> >
> > > > > > >>
> > > > > >
> > > > >
> > >
> > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analy
> > tics.js
> > > > > > >> >
> > > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li
> > > > > > >> > <mu...@gmail.com>
> > > wrote:
> > > > > > >> >
> > > > > > >> > > I think the reason is that the google tracker is not
> > included
> > > in
> > > > > the
> > > > > > >> new
> > > > > > >> > > website.
> > > > > > >> > >
> > > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > > > > > >> marco.g.abreu@gmail.com>
> > > > > > >> > > wrote:
> > > > > > >> > >
> > > > > > >> > >> Hello,
> > > > > > >> > >>
> > > > > > >> > >> I checked the Google Analytics statistics and the
> > > > > > >> > >> launch of
> > > the
> > > > > new
> > > > > > >> > >> website reduced the traffic by over 80%:
> > > > > > >> > >>
> > > > > > >> > >> [image: image.png]
> > > > > > >> > >>
> > > > > > >> > >> (Please let me know if the image is not visible)
> > > > > > >> > >>
> > > > > > >> > >> How shall we handle this?
> > > > > > >> > >>
> > > > > > >> > >> Best regards,
> > > > > > >> > >> Marco
> > > > > > >> > >>
> > > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> > > > > > patric.zhao@intel.com>
> > > > > > >> > >> wrote:
> > > > > > >> > >>
> > > > > > >> > >>> For the install page [1], I suggest to add the
> > > > > > >> > >>> selection
> > of
> > > > > > backend
> > > > > > >> > >>> DeepNumpy [2] which will be more clean.
> > > > > > >> > >>>
> > > > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > > > > >> > >>> [2] https://numpy.mxnet.io/#installation
> > > > > > >> > >>>
> > > > > > >> > >>>
> > > > > > >> > >>>
> > > > > > >> > >>> > -----Original Message-----
> > > > > > >> > >>> > From: kellen sunderland
> > > > > > >> > >>> > <ke...@gmail.com>
> > > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > > > > >> > >>> > To: dev@mxnet.incubator.apache.org
> > > > > > >> > >>> > Subject: Re: new website, docs code freeze
> > > > > > >> > >>> >
> > > > > > >> > >>> > New site looks good.  I do notice that a few
> > > > > > >> > >>> > tutorials
> > > from
> > > > > the
> > > > > > >> old
> > > > > > >> > >>> site are
> > > > > > >> > >>> > missing (for example the TensorRT tutorial).  Any
> > > > > > >> > >>> > plans
> > to
> > > > > bring
> > > > > > >> them
> > > > > > >> > >>> back?
> > > > > > >> > >>> >
> > > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > > > > >> > haibin.lin.aws@gmail.com>
> > > > > > >> > >>> > wrote:
> > > > > > >> > >>> >
> > > > > > >> > >>> > > Another issue I found with the current website:
> > > > > > >> > >>> > > the
> > > Sphinx
> > > > > > >> object
> > > > > > >> > >>> > > inventory
> > > > > > >> > >>> > > <https://www.sphinx-
> > > > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is
> > > missing.
> > > > > > >> GluonNLP
> > > > > > >> > >>> > > relies on this file to link document across projects.
> > > Shall
> > > > > we
> > > > > > >> add
> > > > > > >> > it
> > > > > > >> > >>> > > back?
> > > > > > >> > >>> > >
> > > > > > >> > >>> > > Best,
> > > > > > >> > >>> > > Haibin
> > > > > > >> > >>> > >
> > > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> > > > > > lgo@mobsol.be>
> > > > > > >> > >>> wrote:
> > > > > > >> > >>> > >
> > > > > > >> > >>> > > > Hi,
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > > > > >> > >>> > > > <th...@gmail.com>
> > > > > > >> > >>> > > > wrote:
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > > Thanks all for the feedback,
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > We'll send an email next week with the list
> > > > > > >> > >>> > > > > of
> > > missing
> > > > > > >> > features,
> > > > > > >> > >>> > > content
> > > > > > >> > >>> > > > > and bugs that we plan to fix.
> > > > > > >> > >>> > > > > We took the option of releasing early, with
> > > > > > >> > >>> > > > > some
> > > > > features
> > > > > > >> > >>> missing,
> > > > > > >> > >>> > > rather
> > > > > > >> > >>> > > > > than trying to be at feature parity with the
> > > > > > >> > >>> > > > > old
> > > website
> > > > > > >> before
> > > > > > >> > >>> > > launching
> > > > > > >> > >>> > > > > the website.
> > > > > > >> > >>> > > > > The reason why we decided to do that is two-fold:
> > > > > > >> > >>> > > > > - playing catch-up with docs in master
> > > > > > >> > >>> > > > > introduce
> > > daily
> > > > > > >> > conflicts
> > > > > > >> > >>> > > > > that
> > > > > > >> > >>> > > > need
> > > > > > >> > >>> > > > > to be resolved and introduce opportunity for
> > errors
> > > > > > >> > >>> > > > > - by releasing early, we can take advantage
> > > > > > >> > >>> > > > > of the
> > > > > > community
> > > > > > >> > >>> > > > contributions
> > > > > > >> > >>> > > > > in modifying whatever the community feels
> > > > > > >> > >>> > > > > like a
> > > better
> > > > > > way
> > > > > > >> of
> > > > > > >> > >>> > > > > doing things.
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > One of the goals of the new website was to
> > > disentangle
> > > > > the
> > > > > > >> main
> > > > > > >> > >>> > > website,
> > > > > > >> > >>> > > > > now called "static_site" to the
> > > > > > >> > >>> > > > > auto-generated
> > > docs. Now
> > > > > > the
> > > > > > >> > >>> > > > > overall
> > > > > > >> > >>> > > site
> > > > > > >> > >>> > > > > is made of a main static site, with easy to
> > > > > > >> > >>> > > > > modify
> > > > > content
> > > > > > >> and
> > > > > > >> > >>> > > > > easy to understand architecture for anybody
> > familiar
> > > > > with
> > > > > > >> basic
> > > > > > >> > >>> > > > > html, and a collection of mini-websites for
> > > > > > >> > >>> > > > > each
> > > > > language
> > > > > > >> > >>> bindings
> > > > > > >> > >>> > > > > that can be
> > > > > > >> > >>> > > built
> > > > > > >> > >>> > > > in
> > > > > > >> > >>> > > > > isolation and that are self-contained.
> > > > > > >> > >>> > > > > Actually
> > the
> > > new
> > > > > CI
> > > > > > >> jobs
> > > > > > >> > >>> > > > > builds
> > > > > > >> > >>> > > > all
> > > > > > >> > >>> > > > > of them in parallel independently.
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > There is PLENTY of room for improvement, it
> > > > > > >> > >>> > > > > would
> > be
> > > > > great
> > > > > > >> if
> > > > > > >> > the
> > > > > > >> > >>> > > > community
> > > > > > >> > >>> > > > > can help contribute to bring the new website
> > > > > > >> > >>> > > > > at
> > the
> > > same
> > > > > > >> level
> > > > > > >> > of
> > > > > > >> > >>> > > content
> > > > > > >> > >>> > > > > richness as the old one, and then even further.
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > Missing features:
> > > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do not
> > > > > > >> > >>> > > > > have
> > the
> > > > > full
> > > > > > >> list
> > > > > > >> > of
> > > > > > >> > >>> > > > operators
> > > > > > >> > >>> > > > > and classes. There is a mix of auto-generated
> > > > > > >> > >>> > > > > docs
> > > based
> > > > > > on
> > > > > > >> > >>> > > > > packages,
> > > > > > >> > >>> > > and
> > > > > > >> > >>> > > > > some docs that are spelled out manually to
> > > > > > >> > >>> > > > > improve
> > > the
> > > > > > >> logical
> > > > > > >> > >>> > > > organization
> > > > > > >> > >>> > > > > of the package where there is a need. The
> > > > > > >> > >>> > > > > drawback
> > > with
> > > > > > >> > manually
> > > > > > >> > >>> > > > > listed classes in a package is that it's very
> > > > > > >> > >>> > > > > easy
> > > to
> > > > > miss
> > > > > > >> > some.
> > > > > > >> > >>> > > > > If someone
> > > > > > >> > >>> > > > wanted
> > > > > > >> > >>> > > > > to build a sanity check that would
> > > > > > >> > >>> > > > > automatically
> > > detect
> > > > > > >> which
> > > > > > >> > >>> > > > > classes
> > > > > > >> > >>> > > are
> > > > > > >> > >>> > > > > not in the documentation, or if someone knew
> > > > > > >> > >>> > > > > how
> > to
> > > > > enable
> > > > > > >> that
> > > > > > >> > >>> > > > > with sphinx, that would be a great addition
> > > > > > >> > >>> > > > > to the
> > > > > python
> > > > > > >> docs
> > > > > > >> > >>> > > > > - There is missing content in the python
> > tutorials,
> > > and
> > > > > > the
> > > > > > >> > >>> > > > discoverability
> > > > > > >> > >>> > > > > could be improved. Some old tutorials have
> > > > > > >> > >>> > > > > not
> > been
> > > > > > migrated
> > > > > > >> > >>> just yet.
> > > > > > >> > >>> > > > > - The nightly tests on tutorials have been
> > disabled
> > > for
> > > > > > now
> > > > > > >> > >>> > > > > - There is no "Download jupyter notebook" for
> > > tutorials
> > > > > > just
> > > > > > >> > yet.
> > > > > > >> > >>> > > > > - Non-python tutorials might benefit from a
> > > > > > >> > >>> > > > > blurb
> > > > > > >> description
> > > > > > >> > and
> > > > > > >> > >>> > > > > a
> > > > > > >> > >>> > > > better
> > > > > > >> > >>> > > > > content organization.
> > > > > > >> > >>> > > > > - Python tutorials could be better organized,
> > have a
> > > > > > picture
> > > > > > >> > >>> > > accompanying
> > > > > > >> > >>> > > > > their description
> > > > > > >> > >>> > > > > - There is no site-wide search, this is not
> > > > > > >> > >>> > > > > an
> > easy
> > > > > > problem
> > > > > > >> to
> > > > > > >> > >>> > > > > solve to
> > > > > > >> > >>> > > > be
> > > > > > >> > >>> > > > > fair given the static nature of the website,
> > > > > > >> > >>> > > > > but
> > > maybe
> > > > > an
> > > > > > >> > >>> external
> > > > > > >> > >>> > > plugin
> > > > > > >> > >>> > > > > might be able to give a half-way solution
> > > > > > >> > >>> > > > > - There is no version selector for the docs
> > > > > > >> > >>> > > > > - There is bug in search box of the python
> > > > > > >> > >>> > > > > docs,
> > but
> > > > > this
> > > > > > is
> > > > > > >> > just
> > > > > > >> > >>> > > > > a
> > > > > > >> > >>> > > small
> > > > > > >> > >>> > > > > JS bug that can be fixed easily (on my list
> > > > > > >> > >>> > > > > for
> > next
> > > > > week)
> > > > > > >> > >>> > > > > - Most old links have not had a redirect put
> > > > > > >> > >>> > > > > in
> > > place.
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > I noticed on the Ubuntu home page in the
> > > > > > >> > >>> > > > Developer
> > > > > dropdown
> > > > > > >> that
> > > > > > >> > >>> the
> > > > > > >> > >>> > > > link MXNet on Ubuntu <
> > > https://mxnet.incubator.apache.org/install/index.html
> > > > > > >> > >>> > > > >with
> > > > > > >> > >>> > > > Nvidia
> > > > > > >> > >>> > > > <
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > >
> > > > > > >> > >>>
> > > > > > >>
> > > > >
> > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > > > > >> > >>> > > mxnet/
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > doesn't work anymore, it points to:
> > > > > > >> > >>> > > >
> > https://mxnet.incubator.apache.org/install/index.html
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > Also, on the MXNet 'getting started' page
> > > > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_started
> > > > > > >> > >>> > > > ,
> > the
> > > link
> > > > > > >> > "Ubuntu
> > > > > > >> > >>> > > > Installation Guide" at the bottom doesn't work
> > > either, it
> > > > > > >> points
> > > > > > >> > >>> to:
> > > > > > >> > >>> > > >
> > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > I suggest you do a scan of the new website to
> > > > > > >> > >>> > > > find
> > > these
> > > > > > >> dangling
> > > > > > >> > >>> links.
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > regards,
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > Lieven
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > > > > We'll formalize this in github issues next
> > > > > > >> > >>> > > > > week,
> > but
> > > > > they
> > > > > > >> are
> > > > > > >> > all
> > > > > > >> > >>> > > fairly
> > > > > > >> > >>> > > > > small and helping out on these would be a
> > > > > > >> > >>> > > > > great
> > way
> > > of
> > > > > > >> > >>> > > > > familiarizing yourself with the new website
> > > > > > >> > >>> > > > > build
> > > system
> > > > > > and
> > > > > > >> > >>> website
> > > > > > >> > >>> > architecture.
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > >  Thanks all for the feedback, please keep it
> > coming!
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > Thomas Delteil
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > > > > It looks like my previous email did not go
> > > through.
> > > > > > >> > Re-sending:
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > > Hi Aaron,
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > > The website looks cool. Thanks for pushing
> > > > > > >> > >>> > > > > > this
> > to
> > > > > > >> > production.
> > > > > > >> > >>> A
> > > > > > >> > >>> > > > > > few
> > > > > > >> > >>> > > > > > questions:
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > > - I was looking for the API doc for
> > > > > > >> > >>> > > > > > mx.sym.dot,
> > > but I
> > > > > > find
> > > > > > >> > that
> > > > > > >> > >>> > > > > > most operators under mx.sym.* are missing.
> > > > > > >> > >>> > > > > > Is
> > this
> > > > > > >> expected?
> > > > > > >> > >>> > > > > > - I was also checking the search
> > > > > > >> > >>> > > > > > functionality,
> > > > > > searching
> > > > > > >> the
> > > > > > >> > >>> > > > > > keyword "ndarray" only returns one result
> > > > > > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > > > > >> > >>> > > > doesn't
> > > > > > >> > >>> > > > > > seem right. There animation keeps going
> > > (Searching. ->
> > > > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives me
> > > > > > >> > >>> > > > > > an
> > > > > impression
> > > > > > >> that
> > > > > > >> > >>> > > > > > the search is never completely done(?).
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > > Best,
> > > > > > >> > >>> > > > > > Haibin
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya
> > > > > > >> > >>> > > > > > Bapat
> > <
> > > > > > >> > >>> > > chai.bapat@gmail.com>
> > > > > > >> > >>> > > > > > wrote:
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > > > > Thanks Aaron and the team for launching
> > > > > > >> > >>> > > > > > > new
> > > website!
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > 1. There's no search button anywhere on
> > > > > > >> > >>> > > > > > > the
> > > landing
> > > > > > >> page.
> > > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without
> > search
> > > > > > button
> > > > > > >> I
> > > > > > >> > >>> dont
> > > > > > >> > >>> > > > > > > have
> > > > > > >> > >>> > > > > > option
> > > > > > >> > >>> > > > > > > but to go manually on each menu). Only
> > > > > > >> > >>> > > > > > > when I
> > > go to
> > > > > > >> > >>> > > > > > > Docs&Tutorials
> > > > > > >> > >>> > > ->
> > > > > > >> > >>> > > > > FAQ
> > > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got what
> > > > > > >> > >>> > > > > > > -> I
> > > wanted).
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > Suggestions Might want to make this
> > > > > > >> > >>> > > > > > > searchable and pop FAQ
> > > on
> > > > > the
> > > > > > >> main
> > > > > > >> > >>> > > > > > > page (or somewhere prominent)
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > Thanks,
> > > > > > >> > >>> > > > > > > Chai
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław
> > Trędak
> > > <
> > > > > > >> > >>> > > ptrendx@apache.org>
> > > > > > >> > >>> > > > > > > wrote:
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > > There seems to be a problem with (at
> > > > > > >> > >>> > > > > > > > least
> > > Python,
> > > > > > did
> > > > > > >> > not
> > > > > > >> > >>> > > > > > > > check
> > > > > > >> > >>> > > > > > others)
> > > > > > >> > >>> > > > > > > > APIs. For example this page:
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > >
> > > > > > >> > >>> >
> > > > > > >> >
> > > > > >
> > >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autog
> > > en
> > > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > > > says that it is a convenience method
> > > > > > >> > >>> > > > > > > > for
> > > argmax
> > > > > > (with
> > > > > > >> a
> > > > > > >> > >>> > > > > > > > link),
> > > > > > >> > >>> > > but
> > > > > > >> > >>> > > > > > > > clicking that link just points to the
> > > > > > >> > >>> > > > > > > > same
> > > website
> > > > > > >> (and
> > > > > > >> > so
> > > > > > >> > >>> > > > > > > > user
> > > > > > >> > >>> > > has
> > > > > > >> > >>> > > > > no
> > > > > > >> > >>> > > > > > > way
> > > > > > >> > >>> > > > > > > > of getting to the docs of the actual
> > > operator).
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > > > When I tried to manually remove Symbol
> > > > > > >> > >>> > > > > > > > from
> > > the
> > > > > URL
> > > > > > to
> > > > > > >> > get
> > > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a
> > > > > > >> > >>> > > > > > > > "Not
> > > found"
> > > > > > >> webpage
> > > > > > >> > >>> > > > > > > > which I
> > > > > > >> > >>> > > guess
> > > > > > >> > >>> > > > > > also
> > > > > > >> > >>> > > > > > > > should not happen (ignoring the fact
> > > > > > >> > >>> > > > > > > > that
> > this
> > > > > > should
> > > > > > >> > >>> exist,
> > > > > > >> > >>> > > going
> > > > > > >> > >>> > > > to
> > > > > > >> > >>> > > > > > > > random URL under the website should
> > > > > > >> > >>> > > > > > > > redirect
> > > to
> > > > > the
> > > > > > >> main
> > > > > > >> > >>> > > > > > > > page I
> > > > > > >> > >>> > > > > think).
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > > > Przemek
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> > > > > > apeforest@gmail.com
> > > > > > >> >
> > > > > > >> > >>> wrote:
> > > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and
> > > > > > >> > >>> > > > > > > > > many
> > > others
> > > > > > for
> > > > > > >> > >>> > > > > > > > > launching
> > > > > > >> > >>> > > > > this!
> > > > > > >> > >>> > > > > > > > >
> > > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin
> > Meier
> > > <
> > > > > > >> > >>> > > > carinmeier@gmail.com>
> > > > > > >> > >>> > > > > > > > wrote:
> > > > > > >> > >>> > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > > > > >> > >>> > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM
> > > > > > >> > >>> > > > > > > > > > Aaron
> > > > > Markham <
> > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > > > > >> > >>> > > > > > > > > > wrote:
> > > > > > >> > >>> > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is launched.
> > You
> > > > > might
> > > > > > >> need
> > > > > > >> > to
> > > > > > >> > >>> > > > > > > > > > > clear
> > > > > > >> > >>> > > > > your
> > > > > > >> > >>> > > > > > > > cache.
> > > > > > >> > >>> > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > Cheers, Aaron
> > > > > > >> > >>> > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM
> > > > > > >> > >>> > > > > > > > > > > Aaron
> > > > > Markham
> > > > > > <
> > > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> > > > > > >> > >>> > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > wrote:
> > > > > > >> > >>> > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed
> > > > > > >> > >>> > > > > > > > > > > > CI,
> > > but
> > > > > > please
> > > > > > >> > >>> > > > > > > > > > > > continue
> > > > > > >> > >>> > > > > holding
> > > > > > >> > >>> > > > > > > > off on
> > > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there
> > > > > > >> > >>> > > > > > > > > > > > are
> > > any
> > > > > > >> > objections,
> > > > > > >> > >>> > > > > > > > > > > > I'd
> > > > > > >> > >>> > > > like
> > > > > > >> > >>> > > > > to
> > > > > > >> > >>> > > > > > > > launch
> > > > > > >> > >>> > > > > > > > > > > > the new website today.
> > > > > > >> > >>> > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM
> > Aaron
> > > > > > Markham
> > > > > > >> <
> > > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > > > > >> > >>> > > > > > > > > > > wrote:
> > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > > Hi everyone, The last two PRs
> > > > > > >> > >>> > > > > > > > > > > > > [1][2] for the
> > new
> > > > > > website
> > > > > > >> and
> > > > > > >> > >>> > > > > > > > > > > > > docs
> > > > > > >> > >>> > > have
> > > > > > >> > >>> > > > > > > passed
> > > > > > >> > >>> > > > > > > > CI
> > > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not make
> > > changes to
> > > > > > >> /docs
> > > > > > >> > or
> > > > > > >> > >>> > > > > > > > > > > > > /ci
> > > > > > >> > >>> > > > until
> > > > > > >> > >>> > > > > > we
> > > > > > >> > >>> > > > > > > > get
> > > > > > >> > >>> > > > > > > > > > > > > these approved and merged.
> > > > > > >> > >>> > > > > > > > > > > > > Every
> > > time
> > > > > > >> there's a
> > > > > > >> > >>> > > > > > > > > > > > > merge
> > > > > > >> > >>> > > > > > conflict
> > > > > > >> > >>> > > > > > > > it has
> > > > > > >> > >>> > > > > > > > > > > > > set us back a day or two
> > > > > > >> > >>> > > > > > > > > > > > > while
> > > > > shepherding
> > > > > > >> the
> > > > > > >> > >>> PRs
> > > > > > >> > >>> > > > through
> > > > > > >> > >>> > > > > CI
> > > > > > >> > >>> > > > > > > > again.
> > > > > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic
> > issues
> > > > > > >> discovered
> > > > > > >> > >>> in
> > > > > > >> > >>> > > > > > > > > > > > > a
> > > > > > >> > >>> > > > > review,
> > > > > > >> > >>> > > > > > I
> > > > > > >> > >>> > > > > > > > > > > > > recommend that we hold any
> > > > > > >> > >>> > > > > > > > > > > > > patches
> > > or
> > > > > > >> updates
> > > > > > >> > to
> > > > > > >> > >>> > > > > > > > > > > > > the
> > > > > > >> > >>> > > PRs
> > > > > > >> > >>> > > > to
> > > > > > >> > >>> > > > > > > > follow-up
> > > > > > >> > >>> > > > > > > > > > > > > PRs.
> > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > > There are four steps to launch:
> > > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved,
> > > > > > >> > >>> > > > > > > > > > > > > the
> > > plan
> > > > > is
> > > > > > to
> > > > > > >> > >>> merge
> > > > > > >> > >>> > > 15885
> > > > > > >> > >>> > > > to
> > > > > > >> > >>> > > > > > > > delete
> > > > > > >> > >>> > > > > > > > > > the
> > > > > > >> > >>> > > > > > > > > > > > > old content first.
> > > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge
> > > > > > >> > >>> > > > > > > > > > > > > 15883 to
> > > add
> > > > > in
> > > > > > >> the
> > > > > > >> > new
> > > > > > >> > >>> > > > > > > > > > > > > CI
> > > > > > >> > >>> > > > flows
> > > > > > >> > >>> > > > > > and
> > > > > > >> > >>> > > > > > > > > > updates
> > > > > > >> > >>> > > > > > > > > > > > > to the content Thomas and I
> > > > > > >> > >>> > > > > > > > > > > > > have
> > > already
> > > > > > had
> > > > > > >> > >>> > > > > > > > > > > > > merged in
> > > > > > >> > >>> > > > > 15884
> > > > > > >> > >>> > > > > > > [3].
> > > > > > >> > >>> > > > > > > > > > > > > 3. I will change the website
> > > validation
> > > > > > >> Jenkins
> > > > > > >> > >>> > > pipeline
> > > > > > >> > >>> > > > to
> > > > > > >> > >>> > > > > > > > point to
> > > > > > >> > >>> > > > > > > > > > > > > the new pipeline.
> > > > > > >> > >>> > > > > > > > > > > > > 4. I will change the website
> > > publishing
> > > > > > >> Jenkins
> > > > > > >> > >>> > > pipeline
> > > > > > >> > >>> > > > to
> > > > > > >> > >>> > > > > > > > point to
> > > > > > >> > >>> > > > > > > > > > > > > its new pipeline as well.
> > > > > > >> > >>> > > > > > > > > > > > > Once
> > > > > triggered,
> > > > > > >> the
> > > > > > >> > old
> > > > > > >> > >>> > > > > > > > > > > > > site
> > > > > > >> > >>> > > > will
> > > > > > >> > >>> > > > > > be
> > > > > > >> > >>> > > > > > > > > > > > > replaced with the new one.
> > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to
> > > > > > >> > >>> > > > > > > > > > > > > update
> > > the DNS
> > > > > > for
> > > > > > >> > >>> > > > beta.mxnet.io
> > > > > > >> > >>> > > > > > to
> > > > > > >> > >>> > > > > > > > point
> > > > > > >> > >>> > > > > > > > > > to
> > > > > > >> > >>> > > > > > > > > > > > > production, and there will
> > > > > > >> > >>> > > > > > > > > > > > > likely
> > be
> > > > > some
> > > > > > >> > >>> > > > > redirect/.htaccess
> > > > > > >> > >>> > > > > > > > updates
> > > > > > >> > >>> > > > > > > > > > > > > needed next week to assist
> > > > > > >> > >>> > > > > > > > > > > > > with
> > any
> > > deep
> > > > > > >> > linking
> > > > > > >> > >>> > > > > > > > > > > > > and
> > > > > > >> > >>> > > 404
> > > > > > >> > >>> > > > > > issues
> > > > > > >> > >>> > > > > > > > that
> > > > > > >> > >>> > > > > > > > > > > > > pop up.
> > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > > Cheers, Aaron
> > > > > > >> > >>> > > > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > > > > > [1]
> > > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15
> > > > > > >> > >>> > > 885
> > > > > > >> > >>> > > > > > > > > > > > > [2]
> > > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15
> > > > > > >> > >>> > > 883
> > > > > > >> > >>> > > > > > > > > > > > > [3]
> > > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15
> > > > > > >> > >>> > > 884
> > > > > > >> > >>> > > > > > > > > > >
> > > > > > >> > >>> > > > > > > > > >
> > > > > > >> > >>> > > > > > > > >
> > > > > > >> > >>> > > > > > > >
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > --
> > > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > > > > >> > >>> > > > > > > *+1 (973) 953-6299*
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > > [image:
> > > https://www.linkedin.com//in/chaibapat25]
> > > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
> > > > > > >> > >>> > > > > > > ]
> > > > > > >> > >>> > > > > > >
> <https://www.facebook.com/chaibapchya>[image:
> > > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > > > > >> > >>> > > > > > >[image:
> > > > > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > > ><https://www.linkedin.com//in/chaibapchya/
> > > > > > >> > >>> > > > > > >>
> > > > > > >> > >>> > > > > > >
> > > > > > >> > >>> > > > > >
> > > > > > >> > >>> > > > >
> > > > > > >> > >>> > > >
> > > > > > >> > >>> > >
> > > > > > >> > >>>
> > > > > > >> > >>
> > > > > > >> >
> > > > > > >>
> > > > > > >
> > > > > >
> > > > >
> > >
> >

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

@Marco Lighthouse Reports
https://cwiki.apache.org/confluence/display/MXNET/New+Website+Lighthouse+Reports,
forgot about that
@Haibin and others: WIP PR to re-reorganize and add full coverage of the
python docs API: https://github.com/apache/incubator-mxnet/pull/16377



Le ven. 4 oct. 2019 à 12:41, Thomas DELTEIL <th...@gmail.com> a
écrit :

> Hi Haibin,
>
> We are currently working with Soji on overhauling the way the python docs
> are organized to get better and more consistent docs with full coverage,
> the current system is a brittle and hard to browse. We hope to finish our
> dev work by tonight, ETA for early next week.
> There is no ETA on bringing back the old docs, though that's the next
> highest priority feature on the list after improving the coverage of the
> python API.
>
> All the best,
>
> Thomas Delteil
>
> On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com> wrote:
>
>> Yes, that is the correct one.
>>
>> On a separate note, are we removing documentation versioning from the
>> website? How do we switch between the master/nightly version and the
>> stable
>> version for the python API doc? Maybe there's a switch somewhere but I
>> cannot find it.
>>
>> Also, I find that the API doc for many methods are missing, for example,
>> the Dataset.transform function has detailed documentation on input and
>> output types, but the doc only shows the one-line description of the
>> method
>>
>> https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.gluon.data.Dataset.html?highlight=dataset#
>> .
>> Same for other methods such as filter, shard, etc.
>>
>> Thanks.
>>
>> Best,
>> Haibin
>>
>>
>> On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham <aa...@gmail.com>
>> wrote:
>>
>> > Hi Haibin, you mean this one?
>> >
>> >
>> https://github.com/apache/incubator-mxnet/blob/master/docs/static_site/src/pages/api/faq/distributed_training.md
>> > If so, it looks like a link update is needed.
>> >
>> > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin <ha...@gmail.com>
>> > wrote:
>> > >
>> > > I find that the 'distributed training with KVStore' tutorial is gone.
>> Are
>> > > we adding it back?
>> > >
>> >
>> https://mxnet.apache.org/api/python/docs/tutorials/performance/index.html?highlight=distributed#distributed-training
>> > >
>> > >
>> > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu <
>> marco.g.abreu@gmail.com>
>> > > wrote:
>> > >
>> > > > Thanks for the update, great job!
>> > > >
>> > > > Are the lighthouse results accessible somewhere? I'd be curious.
>> > > >
>> > > > -Marco
>> > > >
>> > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt.
>> > 2019,
>> > > > 13:49:
>> > > >
>> > > > > Update on the website:
>> > > > >
>> > > > > Highlights:
>> > > > > - Broken links: a good amount of them have been fixed in this
>> #16284
>> > > > > <https://github.com/apache/incubator-mxnet/pull/16284>, tutorials
>> > have
>> > > > > been
>> > > > > reorganized (not yet deployed because of CI). A new 404 with quick
>> > links
>> > > > > has been added and deployed in #16287
>> > > > > <https://github.com/apache/incubator-mxnet/pull/16287>
>> > > > > - Broken Search: Search has been fixed in #16284
>> > > > > <https://github.com/apache/incubator-mxnet/pull/16284> and merged
>> > but
>> > > > not
>> > > > > deployed yet.
>> > > > > - Google index issues: new website seems to be indexed now, in
>> this
>> > > > google
>> > > > > search: "MXNet NDArray" <
>> > https://www.google.com/search?q=mxnet+ndarray>
>> > > > > new
>> > > > > website is the top result. Redirects for old links to new ones
>> have
>> > been
>> > > > > added to the .htaccess, thanks Soji for the help! #16342
>> > > > > <https://github.com/apache/incubator-mxnet/pull/16342> is still
>> > waiting
>> > > > to
>> > > > > be merged but a manual update to the website has been done in the
>> > > > > meanwhile.
>> > > > > - Automated analysis from google lighthouse scoring, compared to
>> the
>> > old
>> > > > > website: Performance saw a > ~100% improvement, SEO saw a ~25%
>> > > > improvement,
>> > > > > and best practices improved by ~19%. Thanks Russell D. for running
>> > the
>> > > > > analysis.
>> > > > >
>> > > > > Remaining
>> > > > > - *[high priority]* API docs are still missing some classes /
>> > packages /
>> > > > > methods. ETA for fix is EOW, root cause has been identified, we
>> are
>> > still
>> > > > > deciding what's the best way forward for good discoverability as
>> > well as
>> > > > > good coverage and maintainability.
>> > > > > - Adding quick links to directly access Python API docs on
>> homepage.
>> > > > >
>> > > > > All the best,
>> > > > >
>> > > > > Thomas Delteil
>> > > > >
>> > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
>> > thomas.delteil1@gmail.com
>> > > > >
>> > > > > a
>> > > > > écrit :
>> > > > >
>> > > > > > @Philip Yes we're looking at link redirects for older links that
>> > might
>> > > > be
>> > > > > > hosted externally (using htaccess is my preferred way to handle
>> it
>> > for
>> > > > > now
>> > > > > > as you sugested) and we'll use a broken link checker to update
>> the
>> > > > links
>> > > > > > that are hosted internally. We'll update the 404 to add an
>> > explanation
>> > > > on
>> > > > > > the website update. Google indexes will slowly update across the
>> > week
>> > > > so
>> > > > > > the google search issues will be less of a problem.
>> > > > > >
>> > > > > > If you find any such links yourself, or missing tutorials,
>> please
>> > > > > consider
>> > > > > > stepping up and helping fixing them. The more people get
>> familiar
>> > with
>> > > > > the
>> > > > > > new website architecture, the least likely it is to fall in a
>> > state of
>> > > > > > stalled updates like the previous one.
>> > > > > >
>> > > > > > For the sphinx issues in the python mini-website, missing API
>> > classes,
>> > > > if
>> > > > > > anybody is familiar with it, I'd love for us to bring back the
>> > > > automatic
>> > > > > > doc generation for each package so at least we have a list of
>> all
>> > > > > available
>> > > > > > classes in each sub package rather than relying on manual
>> > insertion of
>> > > > > each
>> > > > > > class, which is brittle and not future proof. @Lin, Haibin
>> > > > > > <ha...@amazon.com> if you have experience with it, could we
>> > sync up
>> > > > > > offline on how you suggest to do that based on your gluon-nlp
>> > > > experience?
>> > > > > >
>> > > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron
>> is
>> > on
>> > > > PTO
>> > > > > > in Europe, I'll try make time today to help with the fixes since
>> > it is
>> > > > > > impacting a lot of users.
>> > > > > >
>> > > > > > In the meanwhile, any help is appreciated, and more than the
>> value
>> > of
>> > > > the
>> > > > > > fixes, let me repeat that there is tremendous value in having
>> more
>> > > > people
>> > > > > > familiar with the website build pipelines. Aaron is the main
>> owner
>> > for
>> > > > > the
>> > > > > > docs but he is already super busy with all his other
>> > responsibilities.
>> > > > > I'm
>> > > > > > available to help if anybody is stuck. I believe Aaron has
>> updated
>> > the
>> > > > > > READMEs on how to test the websites locally, if they're not
>> clear,
>> > feel
>> > > > > > free to contribute your own explanations or ask for help
>> directly
>> > to me
>> > > > > by
>> > > > > > email or on the discuss forum.
>> > > > > >
>> > > > > > Good hunting!
>> > > > > >
>> > > > > > Thomas
>> > > > > >
>> > > > > >
>> > > > > >
>> > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
>> > marco.g.abreu@gmail.com
>> > > > >
>> > > > > a
>> > > > > > écrit :
>> > > > > >
>> > > > > >> Good catch, Mu! Also good idea, Philip!
>> > > > > >>
>> > > > > >> Aaron and Thomas, are you going to work on this?
>> > > > > >>
>> > > > > >> -Marco
>> > > > > >>
>> > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com>
>> wrote:
>> > > > > >>
>> > > > > >> > The questions I found are:
>> > > > > >> >
>> > > > > >> > 1. Not ever page contains, especially the homepage
>> > > > > >> >
>> > > > > >> >
>> > > > > >>
>> > > > >
>> > > >
>> >
>> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>> > > > > >> > 2. The correct tracking id is UA-96378503-1 instead of
>> > > > UA-96378503-11
>> > > > > in
>> > > > > >> >
>> > > > > >> >
>> > > > > >>
>> > > > >
>> > > >
>> >
>> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>> > > > > >> >
>> > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com>
>> > wrote:
>> > > > > >> >
>> > > > > >> > > I think the reason is that the google tracker is not
>> included
>> > in
>> > > > the
>> > > > > >> new
>> > > > > >> > > website.
>> > > > > >> > >
>> > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
>> > > > > >> marco.g.abreu@gmail.com>
>> > > > > >> > > wrote:
>> > > > > >> > >
>> > > > > >> > >> Hello,
>> > > > > >> > >>
>> > > > > >> > >> I checked the Google Analytics statistics and the launch
>> of
>> > the
>> > > > new
>> > > > > >> > >> website reduced the traffic by over 80%:
>> > > > > >> > >>
>> > > > > >> > >> [image: image.png]
>> > > > > >> > >>
>> > > > > >> > >> (Please let me know if the image is not visible)
>> > > > > >> > >>
>> > > > > >> > >> How shall we handle this?
>> > > > > >> > >>
>> > > > > >> > >> Best regards,
>> > > > > >> > >> Marco
>> > > > > >> > >>
>> > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
>> > > > > patric.zhao@intel.com>
>> > > > > >> > >> wrote:
>> > > > > >> > >>
>> > > > > >> > >>> For the install page [1], I suggest to add the selection
>> of
>> > > > > backend
>> > > > > >> > >>> DeepNumpy [2] which will be more clean.
>> > > > > >> > >>>
>> > > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
>> > > > > >> > >>> [2] https://numpy.mxnet.io/#installation
>> > > > > >> > >>>
>> > > > > >> > >>>
>> > > > > >> > >>>
>> > > > > >> > >>> > -----Original Message-----
>> > > > > >> > >>> > From: kellen sunderland <ke...@gmail.com>
>> > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
>> > > > > >> > >>> > To: dev@mxnet.incubator.apache.org
>> > > > > >> > >>> > Subject: Re: new website, docs code freeze
>> > > > > >> > >>> >
>> > > > > >> > >>> > New site looks good.  I do notice that a few tutorials
>> > from
>> > > > the
>> > > > > >> old
>> > > > > >> > >>> site are
>> > > > > >> > >>> > missing (for example the TensorRT tutorial).  Any
>> plans to
>> > > > bring
>> > > > > >> them
>> > > > > >> > >>> back?
>> > > > > >> > >>> >
>> > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
>> > > > > >> > haibin.lin.aws@gmail.com>
>> > > > > >> > >>> > wrote:
>> > > > > >> > >>> >
>> > > > > >> > >>> > > Another issue I found with the current website: the
>> > Sphinx
>> > > > > >> object
>> > > > > >> > >>> > > inventory
>> > > > > >> > >>> > > <https://www.sphinx-
>> > > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
>> > > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is
>> > missing.
>> > > > > >> GluonNLP
>> > > > > >> > >>> > > relies on this file to link document across projects.
>> > Shall
>> > > > we
>> > > > > >> add
>> > > > > >> > it
>> > > > > >> > >>> > > back?
>> > > > > >> > >>> > >
>> > > > > >> > >>> > > Best,
>> > > > > >> > >>> > > Haibin
>> > > > > >> > >>> > >
>> > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
>> > > > > lgo@mobsol.be>
>> > > > > >> > >>> wrote:
>> > > > > >> > >>> > >
>> > > > > >> > >>> > > > Hi,
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
>> > > > > >> > >>> > > > <th...@gmail.com>
>> > > > > >> > >>> > > > wrote:
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > > Thanks all for the feedback,
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > We'll send an email next week with the list of
>> > missing
>> > > > > >> > features,
>> > > > > >> > >>> > > content
>> > > > > >> > >>> > > > > and bugs that we plan to fix.
>> > > > > >> > >>> > > > > We took the option of releasing early, with some
>> > > > features
>> > > > > >> > >>> missing,
>> > > > > >> > >>> > > rather
>> > > > > >> > >>> > > > > than trying to be at feature parity with the old
>> > website
>> > > > > >> before
>> > > > > >> > >>> > > launching
>> > > > > >> > >>> > > > > the website.
>> > > > > >> > >>> > > > > The reason why we decided to do that is two-fold:
>> > > > > >> > >>> > > > > - playing catch-up with docs in master introduce
>> > daily
>> > > > > >> > conflicts
>> > > > > >> > >>> > > > > that
>> > > > > >> > >>> > > > need
>> > > > > >> > >>> > > > > to be resolved and introduce opportunity for
>> errors
>> > > > > >> > >>> > > > > - by releasing early, we can take advantage of
>> the
>> > > > > community
>> > > > > >> > >>> > > > contributions
>> > > > > >> > >>> > > > > in modifying whatever the community feels like a
>> > better
>> > > > > way
>> > > > > >> of
>> > > > > >> > >>> > > > > doing things.
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > One of the goals of the new website was to
>> > disentangle
>> > > > the
>> > > > > >> main
>> > > > > >> > >>> > > website,
>> > > > > >> > >>> > > > > now called "static_site" to the auto-generated
>> > docs. Now
>> > > > > the
>> > > > > >> > >>> > > > > overall
>> > > > > >> > >>> > > site
>> > > > > >> > >>> > > > > is made of a main static site, with easy to
>> modify
>> > > > content
>> > > > > >> and
>> > > > > >> > >>> > > > > easy to understand architecture for anybody
>> familiar
>> > > > with
>> > > > > >> basic
>> > > > > >> > >>> > > > > html, and a collection of mini-websites for each
>> > > > language
>> > > > > >> > >>> bindings
>> > > > > >> > >>> > > > > that can be
>> > > > > >> > >>> > > built
>> > > > > >> > >>> > > > in
>> > > > > >> > >>> > > > > isolation and that are self-contained. Actually
>> the
>> > new
>> > > > CI
>> > > > > >> jobs
>> > > > > >> > >>> > > > > builds
>> > > > > >> > >>> > > > all
>> > > > > >> > >>> > > > > of them in parallel independently.
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > There is PLENTY of room for improvement, it
>> would be
>> > > > great
>> > > > > >> if
>> > > > > >> > the
>> > > > > >> > >>> > > > community
>> > > > > >> > >>> > > > > can help contribute to bring the new website at
>> the
>> > same
>> > > > > >> level
>> > > > > >> > of
>> > > > > >> > >>> > > content
>> > > > > >> > >>> > > > > richness as the old one, and then even further.
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > Missing features:
>> > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do not have
>> the
>> > > > full
>> > > > > >> list
>> > > > > >> > of
>> > > > > >> > >>> > > > operators
>> > > > > >> > >>> > > > > and classes. There is a mix of auto-generated
>> docs
>> > based
>> > > > > on
>> > > > > >> > >>> > > > > packages,
>> > > > > >> > >>> > > and
>> > > > > >> > >>> > > > > some docs that are spelled out manually to
>> improve
>> > the
>> > > > > >> logical
>> > > > > >> > >>> > > > organization
>> > > > > >> > >>> > > > > of the package where there is a need. The
>> drawback
>> > with
>> > > > > >> > manually
>> > > > > >> > >>> > > > > listed classes in a package is that it's very
>> easy
>> > to
>> > > > miss
>> > > > > >> > some.
>> > > > > >> > >>> > > > > If someone
>> > > > > >> > >>> > > > wanted
>> > > > > >> > >>> > > > > to build a sanity check that would automatically
>> > detect
>> > > > > >> which
>> > > > > >> > >>> > > > > classes
>> > > > > >> > >>> > > are
>> > > > > >> > >>> > > > > not in the documentation, or if someone knew how
>> to
>> > > > enable
>> > > > > >> that
>> > > > > >> > >>> > > > > with sphinx, that would be a great addition to
>> the
>> > > > python
>> > > > > >> docs
>> > > > > >> > >>> > > > > - There is missing content in the python
>> tutorials,
>> > and
>> > > > > the
>> > > > > >> > >>> > > > discoverability
>> > > > > >> > >>> > > > > could be improved. Some old tutorials have not
>> been
>> > > > > migrated
>> > > > > >> > >>> just yet.
>> > > > > >> > >>> > > > > - The nightly tests on tutorials have been
>> disabled
>> > for
>> > > > > now
>> > > > > >> > >>> > > > > - There is no "Download jupyter notebook" for
>> > tutorials
>> > > > > just
>> > > > > >> > yet.
>> > > > > >> > >>> > > > > - Non-python tutorials might benefit from a blurb
>> > > > > >> description
>> > > > > >> > and
>> > > > > >> > >>> > > > > a
>> > > > > >> > >>> > > > better
>> > > > > >> > >>> > > > > content organization.
>> > > > > >> > >>> > > > > - Python tutorials could be better organized,
>> have a
>> > > > > picture
>> > > > > >> > >>> > > accompanying
>> > > > > >> > >>> > > > > their description
>> > > > > >> > >>> > > > > - There is no site-wide search, this is not an
>> easy
>> > > > > problem
>> > > > > >> to
>> > > > > >> > >>> > > > > solve to
>> > > > > >> > >>> > > > be
>> > > > > >> > >>> > > > > fair given the static nature of the website, but
>> > maybe
>> > > > an
>> > > > > >> > >>> external
>> > > > > >> > >>> > > plugin
>> > > > > >> > >>> > > > > might be able to give a half-way solution
>> > > > > >> > >>> > > > > - There is no version selector for the docs
>> > > > > >> > >>> > > > > - There is bug in search box of the python docs,
>> but
>> > > > this
>> > > > > is
>> > > > > >> > just
>> > > > > >> > >>> > > > > a
>> > > > > >> > >>> > > small
>> > > > > >> > >>> > > > > JS bug that can be fixed easily (on my list for
>> next
>> > > > week)
>> > > > > >> > >>> > > > > - Most old links have not had a redirect put in
>> > place.
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > I noticed on the Ubuntu home page in the Developer
>> > > > dropdown
>> > > > > >> that
>> > > > > >> > >>> the
>> > > > > >> > >>> > > > link MXNet on Ubuntu
>> > > > > >> > >>> > > > <
>> > https://mxnet.incubator.apache.org/install/index.html
>> > > > > >> > >>> > > > >with
>> > > > > >> > >>> > > > Nvidia
>> > > > > >> > >>> > > > <
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > >
>> > > > > >> > >>>
>> > > > > >>
>> > > >
>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
>> > > > > >> > >>> > > mxnet/
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > doesn't work anymore, it points to:
>> > > > > >> > >>> > > >
>> https://mxnet.incubator.apache.org/install/index.html
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > Also, on the MXNet 'getting started' page
>> > > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_started ,
>> the
>> > link
>> > > > > >> > "Ubuntu
>> > > > > >> > >>> > > > Installation Guide" at the bottom doesn't work
>> > either, it
>> > > > > >> points
>> > > > > >> > >>> to:
>> > > > > >> > >>> > > >
>> https://mxnet.incubator.apache.org/ubuntu_setup.html
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > I suggest you do a scan of the new website to find
>> > these
>> > > > > >> dangling
>> > > > > >> > >>> links.
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > regards,
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > Lieven
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > > > > We'll formalize this in github issues next week,
>> but
>> > > > they
>> > > > > >> are
>> > > > > >> > all
>> > > > > >> > >>> > > fairly
>> > > > > >> > >>> > > > > small and helping out on these would be a great
>> way
>> > of
>> > > > > >> > >>> > > > > familiarizing yourself with the new website build
>> > system
>> > > > > and
>> > > > > >> > >>> website
>> > > > > >> > >>> > architecture.
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > >  Thanks all for the feedback, please keep it
>> coming!
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > Thomas Delteil
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>> > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > > > > It looks like my previous email did not go
>> > through.
>> > > > > >> > Re-sending:
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > > Hi Aaron,
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > > The website looks cool. Thanks for pushing
>> this to
>> > > > > >> > production.
>> > > > > >> > >>> A
>> > > > > >> > >>> > > > > > few
>> > > > > >> > >>> > > > > > questions:
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > > - I was looking for the API doc for mx.sym.dot,
>> > but I
>> > > > > find
>> > > > > >> > that
>> > > > > >> > >>> > > > > > most operators under mx.sym.* are missing. Is
>> this
>> > > > > >> expected?
>> > > > > >> > >>> > > > > > - I was also checking the search functionality,
>> > > > > searching
>> > > > > >> the
>> > > > > >> > >>> > > > > > keyword "ndarray" only returns one result
>> > > > > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
>> > > > > >> > >>> > > > doesn't
>> > > > > >> > >>> > > > > > seem right. There animation keeps going
>> > (Searching. ->
>> > > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives me an
>> > > > impression
>> > > > > >> that
>> > > > > >> > >>> > > > > > the search is never completely done(?).
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > > Best,
>> > > > > >> > >>> > > > > > Haibin
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya
>> Bapat <
>> > > > > >> > >>> > > chai.bapat@gmail.com>
>> > > > > >> > >>> > > > > > wrote:
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > > > > Thanks Aaron and the team for launching new
>> > website!
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > 1. There's no search button anywhere on the
>> > landing
>> > > > > >> page.
>> > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without
>> search
>> > > > > button
>> > > > > >> I
>> > > > > >> > >>> dont
>> > > > > >> > >>> > > > > > > have
>> > > > > >> > >>> > > > > > option
>> > > > > >> > >>> > > > > > > but to go manually on each menu). Only when I
>> > go to
>> > > > > >> > >>> > > > > > > Docs&Tutorials
>> > > > > >> > >>> > > ->
>> > > > > >> > >>> > > > > FAQ
>> > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got what I
>> > wanted).
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > Suggestions
>> > > > > >> > >>> > > > > > > Might want to make this searchable and pop
>> FAQ
>> > on
>> > > > the
>> > > > > >> main
>> > > > > >> > >>> > > > > > > page (or somewhere prominent)
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > Thanks,
>> > > > > >> > >>> > > > > > > Chai
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław
>> Trędak
>> > <
>> > > > > >> > >>> > > ptrendx@apache.org>
>> > > > > >> > >>> > > > > > > wrote:
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > > There seems to be a problem with (at least
>> > Python,
>> > > > > did
>> > > > > >> > not
>> > > > > >> > >>> > > > > > > > check
>> > > > > >> > >>> > > > > > others)
>> > > > > >> > >>> > > > > > > > APIs. For example this page:
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > >
>> > > > > >> > >>> >
>> > > > > >> >
>> > > > >
>> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
>> > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > > > says that it is a convenience method for
>> > argmax
>> > > > > (with
>> > > > > >> a
>> > > > > >> > >>> > > > > > > > link),
>> > > > > >> > >>> > > but
>> > > > > >> > >>> > > > > > > > clicking that link just points to the same
>> > website
>> > > > > >> (and
>> > > > > >> > so
>> > > > > >> > >>> > > > > > > > user
>> > > > > >> > >>> > > has
>> > > > > >> > >>> > > > > no
>> > > > > >> > >>> > > > > > > way
>> > > > > >> > >>> > > > > > > > of getting to the docs of the actual
>> > operator).
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > > > When I tried to manually remove Symbol from
>> > the
>> > > > URL
>> > > > > to
>> > > > > >> > get
>> > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not
>> > found"
>> > > > > >> webpage
>> > > > > >> > >>> > > > > > > > which I
>> > > > > >> > >>> > > guess
>> > > > > >> > >>> > > > > > also
>> > > > > >> > >>> > > > > > > > should not happen (ignoring the fact that
>> this
>> > > > > should
>> > > > > >> > >>> exist,
>> > > > > >> > >>> > > going
>> > > > > >> > >>> > > > to
>> > > > > >> > >>> > > > > > > > random URL under the website should
>> redirect
>> > to
>> > > > the
>> > > > > >> main
>> > > > > >> > >>> > > > > > > > page I
>> > > > > >> > >>> > > > > think).
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > > > Przemek
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
>> > > > > apeforest@gmail.com
>> > > > > >> >
>> > > > > >> > >>> wrote:
>> > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many
>> > others
>> > > > > for
>> > > > > >> > >>> > > > > > > > > launching
>> > > > > >> > >>> > > > > this!
>> > > > > >> > >>> > > > > > > > >
>> > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin
>> Meier
>> > <
>> > > > > >> > >>> > > > carinmeier@gmail.com>
>> > > > > >> > >>> > > > > > > > wrote:
>> > > > > >> > >>> > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
>> > > > > >> > >>> > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron
>> > > > Markham <
>> > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
>> > > > > >> > >>> > > > > > > > > > wrote:
>> > > > > >> > >>> > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is launched.
>> You
>> > > > might
>> > > > > >> need
>> > > > > >> > to
>> > > > > >> > >>> > > > > > > > > > > clear
>> > > > > >> > >>> > > > > your
>> > > > > >> > >>> > > > > > > > cache.
>> > > > > >> > >>> > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > Cheers,
>> > > > > >> > >>> > > > > > > > > > > Aaron
>> > > > > >> > >>> > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron
>> > > > Markham
>> > > > > <
>> > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
>> > > > > >> > >>> > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > wrote:
>> > > > > >> > >>> > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI,
>> > but
>> > > > > please
>> > > > > >> > >>> > > > > > > > > > > > continue
>> > > > > >> > >>> > > > > holding
>> > > > > >> > >>> > > > > > > > off on
>> > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there are
>> > any
>> > > > > >> > objections,
>> > > > > >> > >>> > > > > > > > > > > > I'd
>> > > > > >> > >>> > > > like
>> > > > > >> > >>> > > > > to
>> > > > > >> > >>> > > > > > > > launch
>> > > > > >> > >>> > > > > > > > > > > > the new website today.
>> > > > > >> > >>> > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM
>> Aaron
>> > > > > Markham
>> > > > > >> <
>> > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
>> > > > > >> > >>> > > > > > > > > > > wrote:
>> > > > > >> > >>> > > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > > Hi everyone,
>> > > > > >> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the
>> new
>> > > > > website
>> > > > > >> and
>> > > > > >> > >>> > > > > > > > > > > > > docs
>> > > > > >> > >>> > > have
>> > > > > >> > >>> > > > > > > passed
>> > > > > >> > >>> > > > > > > > CI
>> > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not make
>> > changes to
>> > > > > >> /docs
>> > > > > >> > or
>> > > > > >> > >>> > > > > > > > > > > > > /ci
>> > > > > >> > >>> > > > until
>> > > > > >> > >>> > > > > > we
>> > > > > >> > >>> > > > > > > > get
>> > > > > >> > >>> > > > > > > > > > > > > these approved and merged. Every
>> > time
>> > > > > >> there's a
>> > > > > >> > >>> > > > > > > > > > > > > merge
>> > > > > >> > >>> > > > > > conflict
>> > > > > >> > >>> > > > > > > > it has
>> > > > > >> > >>> > > > > > > > > > > > > set us back a day or two while
>> > > > shepherding
>> > > > > >> the
>> > > > > >> > >>> PRs
>> > > > > >> > >>> > > > through
>> > > > > >> > >>> > > > > CI
>> > > > > >> > >>> > > > > > > > again.
>> > > > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic
>> issues
>> > > > > >> discovered
>> > > > > >> > >>> in
>> > > > > >> > >>> > > > > > > > > > > > > a
>> > > > > >> > >>> > > > > review,
>> > > > > >> > >>> > > > > > I
>> > > > > >> > >>> > > > > > > > > > > > > recommend that we hold any
>> patches
>> > or
>> > > > > >> updates
>> > > > > >> > to
>> > > > > >> > >>> > > > > > > > > > > > > the
>> > > > > >> > >>> > > PRs
>> > > > > >> > >>> > > > to
>> > > > > >> > >>> > > > > > > > follow-up
>> > > > > >> > >>> > > > > > > > > > > > > PRs.
>> > > > > >> > >>> > > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > > There are four steps to launch:
>> > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the
>> > plan
>> > > > is
>> > > > > to
>> > > > > >> > >>> merge
>> > > > > >> > >>> > > 15885
>> > > > > >> > >>> > > > to
>> > > > > >> > >>> > > > > > > > delete
>> > > > > >> > >>> > > > > > > > > > the
>> > > > > >> > >>> > > > > > > > > > > > > old content first.
>> > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883
>> to
>> > add
>> > > > in
>> > > > > >> the
>> > > > > >> > new
>> > > > > >> > >>> > > > > > > > > > > > > CI
>> > > > > >> > >>> > > > flows
>> > > > > >> > >>> > > > > > and
>> > > > > >> > >>> > > > > > > > > > updates
>> > > > > >> > >>> > > > > > > > > > > > > to the content Thomas and I have
>> > already
>> > > > > had
>> > > > > >> > >>> > > > > > > > > > > > > merged in
>> > > > > >> > >>> > > > > 15884
>> > > > > >> > >>> > > > > > > [3].
>> > > > > >> > >>> > > > > > > > > > > > > 3. I will change the website
>> > validation
>> > > > > >> Jenkins
>> > > > > >> > >>> > > pipeline
>> > > > > >> > >>> > > > to
>> > > > > >> > >>> > > > > > > > point to
>> > > > > >> > >>> > > > > > > > > > > > > the new pipeline.
>> > > > > >> > >>> > > > > > > > > > > > > 4. I will change the website
>> > publishing
>> > > > > >> Jenkins
>> > > > > >> > >>> > > pipeline
>> > > > > >> > >>> > > > to
>> > > > > >> > >>> > > > > > > > point to
>> > > > > >> > >>> > > > > > > > > > > > > its new pipeline as well. Once
>> > > > triggered,
>> > > > > >> the
>> > > > > >> > old
>> > > > > >> > >>> > > > > > > > > > > > > site
>> > > > > >> > >>> > > > will
>> > > > > >> > >>> > > > > > be
>> > > > > >> > >>> > > > > > > > > > > > > replaced with the new one.
>> > > > > >> > >>> > > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to update
>> > the DNS
>> > > > > for
>> > > > > >> > >>> > > > beta.mxnet.io
>> > > > > >> > >>> > > > > > to
>> > > > > >> > >>> > > > > > > > point
>> > > > > >> > >>> > > > > > > > > > to
>> > > > > >> > >>> > > > > > > > > > > > > production, and there will
>> likely be
>> > > > some
>> > > > > >> > >>> > > > > redirect/.htaccess
>> > > > > >> > >>> > > > > > > > updates
>> > > > > >> > >>> > > > > > > > > > > > > needed next week to assist with
>> any
>> > deep
>> > > > > >> > linking
>> > > > > >> > >>> > > > > > > > > > > > > and
>> > > > > >> > >>> > > 404
>> > > > > >> > >>> > > > > > issues
>> > > > > >> > >>> > > > > > > > that
>> > > > > >> > >>> > > > > > > > > > > > > pop up.
>> > > > > >> > >>> > > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > > Cheers,
>> > > > > >> > >>> > > > > > > > > > > > > Aaron
>> > > > > >> > >>> > > > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > > > > > [1]
>> > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
>> > > > > >> > >>> > > > > > > > > > > > > [2]
>> > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
>> > > > > >> > >>> > > > > > > > > > > > > [3]
>> > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
>> > > > > >> > >>> > > > > > > > > > >
>> > > > > >> > >>> > > > > > > > > >
>> > > > > >> > >>> > > > > > > > >
>> > > > > >> > >>> > > > > > > >
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > --
>> > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
>> > > > > >> > >>> > > > > > > *+1 (973) 953-6299*
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > > > [image:
>> > https://www.linkedin.com//in/chaibapat25]
>> > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
>> > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
>> > > > > >> > >>> > > > > > > ]
>> > > > > >> > >>> > > > > > > <https://www.facebook.com/chaibapchya
>> >[image:
>> > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
>> > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
>> > > > > >> > >>> > > > > > >[image:
>> > > > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
>> > > > > >> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
>> > > > > >> > >>> > > > > > >
>> > > > > >> > >>> > > > > >
>> > > > > >> > >>> > > > >
>> > > > > >> > >>> > > >
>> > > > > >> > >>> > >
>> > > > > >> > >>>
>> > > > > >> > >>
>> > > > > >> >
>> > > > > >>
>> > > > > >
>> > > > >
>> > > >
>> >
>>
>

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

Hi Haibin,

We are currently working with Soji on overhauling the way the python docs
are organized to get better and more consistent docs with full coverage,
the current system is a brittle and hard to browse. We hope to finish our
dev work by tonight, ETA for early next week.
There is no ETA on bringing back the old docs, though that's the next
highest priority feature on the list after improving the coverage of the
python API.

All the best,

Thomas Delteil

On Fri, Oct 4, 2019, 12:34 Haibin Lin <ha...@gmail.com> wrote:

> Yes, that is the correct one.
>
> On a separate note, are we removing documentation versioning from the
> website? How do we switch between the master/nightly version and the stable
> version for the python API doc? Maybe there's a switch somewhere but I
> cannot find it.
>
> Also, I find that the API doc for many methods are missing, for example,
> the Dataset.transform function has detailed documentation on input and
> output types, but the doc only shows the one-line description of the method
>
> https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.gluon.data.Dataset.html?highlight=dataset#
> .
> Same for other methods such as filter, shard, etc.
>
> Thanks.
>
> Best,
> Haibin
>
>
> On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham <aa...@gmail.com>
> wrote:
>
> > Hi Haibin, you mean this one?
> >
> >
> https://github.com/apache/incubator-mxnet/blob/master/docs/static_site/src/pages/api/faq/distributed_training.md
> > If so, it looks like a link update is needed.
> >
> > On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin <ha...@gmail.com>
> > wrote:
> > >
> > > I find that the 'distributed training with KVStore' tutorial is gone.
> Are
> > > we adding it back?
> > >
> >
> https://mxnet.apache.org/api/python/docs/tutorials/performance/index.html?highlight=distributed#distributed-training
> > >
> > >
> > > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu <marco.g.abreu@gmail.com
> >
> > > wrote:
> > >
> > > > Thanks for the update, great job!
> > > >
> > > > Are the lighthouse results accessible somewhere? I'd be curious.
> > > >
> > > > -Marco
> > > >
> > > > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt.
> > 2019,
> > > > 13:49:
> > > >
> > > > > Update on the website:
> > > > >
> > > > > Highlights:
> > > > > - Broken links: a good amount of them have been fixed in this
> #16284
> > > > > <https://github.com/apache/incubator-mxnet/pull/16284>, tutorials
> > have
> > > > > been
> > > > > reorganized (not yet deployed because of CI). A new 404 with quick
> > links
> > > > > has been added and deployed in #16287
> > > > > <https://github.com/apache/incubator-mxnet/pull/16287>
> > > > > - Broken Search: Search has been fixed in #16284
> > > > > <https://github.com/apache/incubator-mxnet/pull/16284> and merged
> > but
> > > > not
> > > > > deployed yet.
> > > > > - Google index issues: new website seems to be indexed now, in this
> > > > google
> > > > > search: "MXNet NDArray" <
> > https://www.google.com/search?q=mxnet+ndarray>
> > > > > new
> > > > > website is the top result. Redirects for old links to new ones have
> > been
> > > > > added to the .htaccess, thanks Soji for the help! #16342
> > > > > <https://github.com/apache/incubator-mxnet/pull/16342> is still
> > waiting
> > > > to
> > > > > be merged but a manual update to the website has been done in the
> > > > > meanwhile.
> > > > > - Automated analysis from google lighthouse scoring, compared to
> the
> > old
> > > > > website: Performance saw a > ~100% improvement, SEO saw a ~25%
> > > > improvement,
> > > > > and best practices improved by ~19%. Thanks Russell D. for running
> > the
> > > > > analysis.
> > > > >
> > > > > Remaining
> > > > > - *[high priority]* API docs are still missing some classes /
> > packages /
> > > > > methods. ETA for fix is EOW, root cause has been identified, we are
> > still
> > > > > deciding what's the best way forward for good discoverability as
> > well as
> > > > > good coverage and maintainability.
> > > > > - Adding quick links to directly access Python API docs on
> homepage.
> > > > >
> > > > > All the best,
> > > > >
> > > > > Thomas Delteil
> > > > >
> > > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
> > thomas.delteil1@gmail.com
> > > > >
> > > > > a
> > > > > écrit :
> > > > >
> > > > > > @Philip Yes we're looking at link redirects for older links that
> > might
> > > > be
> > > > > > hosted externally (using htaccess is my preferred way to handle
> it
> > for
> > > > > now
> > > > > > as you sugested) and we'll use a broken link checker to update
> the
> > > > links
> > > > > > that are hosted internally. We'll update the 404 to add an
> > explanation
> > > > on
> > > > > > the website update. Google indexes will slowly update across the
> > week
> > > > so
> > > > > > the google search issues will be less of a problem.
> > > > > >
> > > > > > If you find any such links yourself, or missing tutorials, please
> > > > > consider
> > > > > > stepping up and helping fixing them. The more people get familiar
> > with
> > > > > the
> > > > > > new website architecture, the least likely it is to fall in a
> > state of
> > > > > > stalled updates like the previous one.
> > > > > >
> > > > > > For the sphinx issues in the python mini-website, missing API
> > classes,
> > > > if
> > > > > > anybody is familiar with it, I'd love for us to bring back the
> > > > automatic
> > > > > > doc generation for each package so at least we have a list of all
> > > > > available
> > > > > > classes in each sub package rather than relying on manual
> > insertion of
> > > > > each
> > > > > > class, which is brittle and not future proof. @Lin, Haibin
> > > > > > <ha...@amazon.com> if you have experience with it, could we
> > sync up
> > > > > > offline on how you suggest to do that based on your gluon-nlp
> > > > experience?
> > > > > >
> > > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is
> > on
> > > > PTO
> > > > > > in Europe, I'll try make time today to help with the fixes since
> > it is
> > > > > > impacting a lot of users.
> > > > > >
> > > > > > In the meanwhile, any help is appreciated, and more than the
> value
> > of
> > > > the
> > > > > > fixes, let me repeat that there is tremendous value in having
> more
> > > > people
> > > > > > familiar with the website build pipelines. Aaron is the main
> owner
> > for
> > > > > the
> > > > > > docs but he is already super busy with all his other
> > responsibilities.
> > > > > I'm
> > > > > > available to help if anybody is stuck. I believe Aaron has
> updated
> > the
> > > > > > READMEs on how to test the websites locally, if they're not
> clear,
> > feel
> > > > > > free to contribute your own explanations or ask for help directly
> > to me
> > > > > by
> > > > > > email or on the discuss forum.
> > > > > >
> > > > > > Good hunting!
> > > > > >
> > > > > > Thomas
> > > > > >
> > > > > >
> > > > > >
> > > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
> > marco.g.abreu@gmail.com
> > > > >
> > > > > a
> > > > > > écrit :
> > > > > >
> > > > > >> Good catch, Mu! Also good idea, Philip!
> > > > > >>
> > > > > >> Aaron and Thomas, are you going to work on this?
> > > > > >>
> > > > > >> -Marco
> > > > > >>
> > > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com>
> wrote:
> > > > > >>
> > > > > >> > The questions I found are:
> > > > > >> >
> > > > > >> > 1. Not ever page contains, especially the homepage
> > > > > >> >
> > > > > >> >
> > > > > >>
> > > > >
> > > >
> >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > > > >> > 2. The correct tracking id is UA-96378503-1 instead of
> > > > UA-96378503-11
> > > > > in
> > > > > >> >
> > > > > >> >
> > > > > >>
> > > > >
> > > >
> >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > > > >> >
> > > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com>
> > wrote:
> > > > > >> >
> > > > > >> > > I think the reason is that the google tracker is not
> included
> > in
> > > > the
> > > > > >> new
> > > > > >> > > website.
> > > > > >> > >
> > > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > > > > >> marco.g.abreu@gmail.com>
> > > > > >> > > wrote:
> > > > > >> > >
> > > > > >> > >> Hello,
> > > > > >> > >>
> > > > > >> > >> I checked the Google Analytics statistics and the launch of
> > the
> > > > new
> > > > > >> > >> website reduced the traffic by over 80%:
> > > > > >> > >>
> > > > > >> > >> [image: image.png]
> > > > > >> > >>
> > > > > >> > >> (Please let me know if the image is not visible)
> > > > > >> > >>
> > > > > >> > >> How shall we handle this?
> > > > > >> > >>
> > > > > >> > >> Best regards,
> > > > > >> > >> Marco
> > > > > >> > >>
> > > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> > > > > patric.zhao@intel.com>
> > > > > >> > >> wrote:
> > > > > >> > >>
> > > > > >> > >>> For the install page [1], I suggest to add the selection
> of
> > > > > backend
> > > > > >> > >>> DeepNumpy [2] which will be more clean.
> > > > > >> > >>>
> > > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > > > >> > >>> [2] https://numpy.mxnet.io/#installation
> > > > > >> > >>>
> > > > > >> > >>>
> > > > > >> > >>>
> > > > > >> > >>> > -----Original Message-----
> > > > > >> > >>> > From: kellen sunderland <ke...@gmail.com>
> > > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > > > >> > >>> > To: dev@mxnet.incubator.apache.org
> > > > > >> > >>> > Subject: Re: new website, docs code freeze
> > > > > >> > >>> >
> > > > > >> > >>> > New site looks good.  I do notice that a few tutorials
> > from
> > > > the
> > > > > >> old
> > > > > >> > >>> site are
> > > > > >> > >>> > missing (for example the TensorRT tutorial).  Any plans
> to
> > > > bring
> > > > > >> them
> > > > > >> > >>> back?
> > > > > >> > >>> >
> > > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > > > >> > haibin.lin.aws@gmail.com>
> > > > > >> > >>> > wrote:
> > > > > >> > >>> >
> > > > > >> > >>> > > Another issue I found with the current website: the
> > Sphinx
> > > > > >> object
> > > > > >> > >>> > > inventory
> > > > > >> > >>> > > <https://www.sphinx-
> > > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is
> > missing.
> > > > > >> GluonNLP
> > > > > >> > >>> > > relies on this file to link document across projects.
> > Shall
> > > > we
> > > > > >> add
> > > > > >> > it
> > > > > >> > >>> > > back?
> > > > > >> > >>> > >
> > > > > >> > >>> > > Best,
> > > > > >> > >>> > > Haibin
> > > > > >> > >>> > >
> > > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> > > > > lgo@mobsol.be>
> > > > > >> > >>> wrote:
> > > > > >> > >>> > >
> > > > > >> > >>> > > > Hi,
> > > > > >> > >>> > > >
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > > > >> > >>> > > > <th...@gmail.com>
> > > > > >> > >>> > > > wrote:
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > > Thanks all for the feedback,
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > We'll send an email next week with the list of
> > missing
> > > > > >> > features,
> > > > > >> > >>> > > content
> > > > > >> > >>> > > > > and bugs that we plan to fix.
> > > > > >> > >>> > > > > We took the option of releasing early, with some
> > > > features
> > > > > >> > >>> missing,
> > > > > >> > >>> > > rather
> > > > > >> > >>> > > > > than trying to be at feature parity with the old
> > website
> > > > > >> before
> > > > > >> > >>> > > launching
> > > > > >> > >>> > > > > the website.
> > > > > >> > >>> > > > > The reason why we decided to do that is two-fold:
> > > > > >> > >>> > > > > - playing catch-up with docs in master introduce
> > daily
> > > > > >> > conflicts
> > > > > >> > >>> > > > > that
> > > > > >> > >>> > > > need
> > > > > >> > >>> > > > > to be resolved and introduce opportunity for
> errors
> > > > > >> > >>> > > > > - by releasing early, we can take advantage of the
> > > > > community
> > > > > >> > >>> > > > contributions
> > > > > >> > >>> > > > > in modifying whatever the community feels like a
> > better
> > > > > way
> > > > > >> of
> > > > > >> > >>> > > > > doing things.
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > One of the goals of the new website was to
> > disentangle
> > > > the
> > > > > >> main
> > > > > >> > >>> > > website,
> > > > > >> > >>> > > > > now called "static_site" to the auto-generated
> > docs. Now
> > > > > the
> > > > > >> > >>> > > > > overall
> > > > > >> > >>> > > site
> > > > > >> > >>> > > > > is made of a main static site, with easy to modify
> > > > content
> > > > > >> and
> > > > > >> > >>> > > > > easy to understand architecture for anybody
> familiar
> > > > with
> > > > > >> basic
> > > > > >> > >>> > > > > html, and a collection of mini-websites for each
> > > > language
> > > > > >> > >>> bindings
> > > > > >> > >>> > > > > that can be
> > > > > >> > >>> > > built
> > > > > >> > >>> > > > in
> > > > > >> > >>> > > > > isolation and that are self-contained. Actually
> the
> > new
> > > > CI
> > > > > >> jobs
> > > > > >> > >>> > > > > builds
> > > > > >> > >>> > > > all
> > > > > >> > >>> > > > > of them in parallel independently.
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > There is PLENTY of room for improvement, it would
> be
> > > > great
> > > > > >> if
> > > > > >> > the
> > > > > >> > >>> > > > community
> > > > > >> > >>> > > > > can help contribute to bring the new website at
> the
> > same
> > > > > >> level
> > > > > >> > of
> > > > > >> > >>> > > content
> > > > > >> > >>> > > > > richness as the old one, and then even further.
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > Missing features:
> > > > > >> > >>> > > > > - As pointed by Haibin, the API docs do not have
> the
> > > > full
> > > > > >> list
> > > > > >> > of
> > > > > >> > >>> > > > operators
> > > > > >> > >>> > > > > and classes. There is a mix of auto-generated docs
> > based
> > > > > on
> > > > > >> > >>> > > > > packages,
> > > > > >> > >>> > > and
> > > > > >> > >>> > > > > some docs that are spelled out manually to improve
> > the
> > > > > >> logical
> > > > > >> > >>> > > > organization
> > > > > >> > >>> > > > > of the package where there is a need. The drawback
> > with
> > > > > >> > manually
> > > > > >> > >>> > > > > listed classes in a package is that it's very easy
> > to
> > > > miss
> > > > > >> > some.
> > > > > >> > >>> > > > > If someone
> > > > > >> > >>> > > > wanted
> > > > > >> > >>> > > > > to build a sanity check that would automatically
> > detect
> > > > > >> which
> > > > > >> > >>> > > > > classes
> > > > > >> > >>> > > are
> > > > > >> > >>> > > > > not in the documentation, or if someone knew how
> to
> > > > enable
> > > > > >> that
> > > > > >> > >>> > > > > with sphinx, that would be a great addition to the
> > > > python
> > > > > >> docs
> > > > > >> > >>> > > > > - There is missing content in the python
> tutorials,
> > and
> > > > > the
> > > > > >> > >>> > > > discoverability
> > > > > >> > >>> > > > > could be improved. Some old tutorials have not
> been
> > > > > migrated
> > > > > >> > >>> just yet.
> > > > > >> > >>> > > > > - The nightly tests on tutorials have been
> disabled
> > for
> > > > > now
> > > > > >> > >>> > > > > - There is no "Download jupyter notebook" for
> > tutorials
> > > > > just
> > > > > >> > yet.
> > > > > >> > >>> > > > > - Non-python tutorials might benefit from a blurb
> > > > > >> description
> > > > > >> > and
> > > > > >> > >>> > > > > a
> > > > > >> > >>> > > > better
> > > > > >> > >>> > > > > content organization.
> > > > > >> > >>> > > > > - Python tutorials could be better organized,
> have a
> > > > > picture
> > > > > >> > >>> > > accompanying
> > > > > >> > >>> > > > > their description
> > > > > >> > >>> > > > > - There is no site-wide search, this is not an
> easy
> > > > > problem
> > > > > >> to
> > > > > >> > >>> > > > > solve to
> > > > > >> > >>> > > > be
> > > > > >> > >>> > > > > fair given the static nature of the website, but
> > maybe
> > > > an
> > > > > >> > >>> external
> > > > > >> > >>> > > plugin
> > > > > >> > >>> > > > > might be able to give a half-way solution
> > > > > >> > >>> > > > > - There is no version selector for the docs
> > > > > >> > >>> > > > > - There is bug in search box of the python docs,
> but
> > > > this
> > > > > is
> > > > > >> > just
> > > > > >> > >>> > > > > a
> > > > > >> > >>> > > small
> > > > > >> > >>> > > > > JS bug that can be fixed easily (on my list for
> next
> > > > week)
> > > > > >> > >>> > > > > - Most old links have not had a redirect put in
> > place.
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > I noticed on the Ubuntu home page in the Developer
> > > > dropdown
> > > > > >> that
> > > > > >> > >>> the
> > > > > >> > >>> > > > link MXNet on Ubuntu
> > > > > >> > >>> > > > <
> > https://mxnet.incubator.apache.org/install/index.html
> > > > > >> > >>> > > > >with
> > > > > >> > >>> > > > Nvidia
> > > > > >> > >>> > > > <
> > > > > >> > >>> > > >
> > > > > >> > >>> > >
> > > > > >> > >>>
> > > > > >>
> > > >
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > > > >> > >>> > > mxnet/
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > doesn't work anymore, it points to:
> > > > > >> > >>> > > >
> https://mxnet.incubator.apache.org/install/index.html
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > Also, on the MXNet 'getting started' page
> > > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_started ,
> the
> > link
> > > > > >> > "Ubuntu
> > > > > >> > >>> > > > Installation Guide" at the bottom doesn't work
> > either, it
> > > > > >> points
> > > > > >> > >>> to:
> > > > > >> > >>> > > >
> https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > > > >> > >>> > > >
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > I suggest you do a scan of the new website to find
> > these
> > > > > >> dangling
> > > > > >> > >>> links.
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > regards,
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > Lieven
> > > > > >> > >>> > > >
> > > > > >> > >>> > > >
> > > > > >> > >>> > > >
> > > > > >> > >>> > > > > We'll formalize this in github issues next week,
> but
> > > > they
> > > > > >> are
> > > > > >> > all
> > > > > >> > >>> > > fairly
> > > > > >> > >>> > > > > small and helping out on these would be a great
> way
> > of
> > > > > >> > >>> > > > > familiarizing yourself with the new website build
> > system
> > > > > and
> > > > > >> > >>> website
> > > > > >> > >>> > architecture.
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > >  Thanks all for the feedback, please keep it
> coming!
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > Thomas Delteil
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > > > > It looks like my previous email did not go
> > through.
> > > > > >> > Re-sending:
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > > Hi Aaron,
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > > The website looks cool. Thanks for pushing this
> to
> > > > > >> > production.
> > > > > >> > >>> A
> > > > > >> > >>> > > > > > few
> > > > > >> > >>> > > > > > questions:
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > > - I was looking for the API doc for mx.sym.dot,
> > but I
> > > > > find
> > > > > >> > that
> > > > > >> > >>> > > > > > most operators under mx.sym.* are missing. Is
> this
> > > > > >> expected?
> > > > > >> > >>> > > > > > - I was also checking the search functionality,
> > > > > searching
> > > > > >> the
> > > > > >> > >>> > > > > > keyword "ndarray" only returns one result
> > > > > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > > > >> > >>> > > > doesn't
> > > > > >> > >>> > > > > > seem right. There animation keeps going
> > (Searching. ->
> > > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives me an
> > > > impression
> > > > > >> that
> > > > > >> > >>> > > > > > the search is never completely done(?).
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > > Best,
> > > > > >> > >>> > > > > > Haibin
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat
> <
> > > > > >> > >>> > > chai.bapat@gmail.com>
> > > > > >> > >>> > > > > > wrote:
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > > > > Thanks Aaron and the team for launching new
> > website!
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > 1. There's no search button anywhere on the
> > landing
> > > > > >> page.
> > > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without
> search
> > > > > button
> > > > > >> I
> > > > > >> > >>> dont
> > > > > >> > >>> > > > > > > have
> > > > > >> > >>> > > > > > option
> > > > > >> > >>> > > > > > > but to go manually on each menu). Only when I
> > go to
> > > > > >> > >>> > > > > > > Docs&Tutorials
> > > > > >> > >>> > > ->
> > > > > >> > >>> > > > > FAQ
> > > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got what I
> > wanted).
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > Suggestions
> > > > > >> > >>> > > > > > > Might want to make this searchable and pop FAQ
> > on
> > > > the
> > > > > >> main
> > > > > >> > >>> > > > > > > page (or somewhere prominent)
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > Thanks,
> > > > > >> > >>> > > > > > > Chai
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław
> Trędak
> > <
> > > > > >> > >>> > > ptrendx@apache.org>
> > > > > >> > >>> > > > > > > wrote:
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > > There seems to be a problem with (at least
> > Python,
> > > > > did
> > > > > >> > not
> > > > > >> > >>> > > > > > > > check
> > > > > >> > >>> > > > > > others)
> > > > > >> > >>> > > > > > > > APIs. For example this page:
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > >
> > > > > >> > >>> > >
> > > > > >> > >>> >
> > > > > >> >
> > > > >
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > > > says that it is a convenience method for
> > argmax
> > > > > (with
> > > > > >> a
> > > > > >> > >>> > > > > > > > link),
> > > > > >> > >>> > > but
> > > > > >> > >>> > > > > > > > clicking that link just points to the same
> > website
> > > > > >> (and
> > > > > >> > so
> > > > > >> > >>> > > > > > > > user
> > > > > >> > >>> > > has
> > > > > >> > >>> > > > > no
> > > > > >> > >>> > > > > > > way
> > > > > >> > >>> > > > > > > > of getting to the docs of the actual
> > operator).
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > > > When I tried to manually remove Symbol from
> > the
> > > > URL
> > > > > to
> > > > > >> > get
> > > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not
> > found"
> > > > > >> webpage
> > > > > >> > >>> > > > > > > > which I
> > > > > >> > >>> > > guess
> > > > > >> > >>> > > > > > also
> > > > > >> > >>> > > > > > > > should not happen (ignoring the fact that
> this
> > > > > should
> > > > > >> > >>> exist,
> > > > > >> > >>> > > going
> > > > > >> > >>> > > > to
> > > > > >> > >>> > > > > > > > random URL under the website should redirect
> > to
> > > > the
> > > > > >> main
> > > > > >> > >>> > > > > > > > page I
> > > > > >> > >>> > > > > think).
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > > > Przemek
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> > > > > apeforest@gmail.com
> > > > > >> >
> > > > > >> > >>> wrote:
> > > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many
> > others
> > > > > for
> > > > > >> > >>> > > > > > > > > launching
> > > > > >> > >>> > > > > this!
> > > > > >> > >>> > > > > > > > >
> > > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin
> Meier
> > <
> > > > > >> > >>> > > > carinmeier@gmail.com>
> > > > > >> > >>> > > > > > > > wrote:
> > > > > >> > >>> > > > > > > > >
> > > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > > > >> > >>> > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron
> > > > Markham <
> > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > > > >> > >>> > > > > > > > > > wrote:
> > > > > >> > >>> > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > Alrighty! The new site is launched.
> You
> > > > might
> > > > > >> need
> > > > > >> > to
> > > > > >> > >>> > > > > > > > > > > clear
> > > > > >> > >>> > > > > your
> > > > > >> > >>> > > > > > > > cache.
> > > > > >> > >>> > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > Cheers,
> > > > > >> > >>> > > > > > > > > > > Aaron
> > > > > >> > >>> > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron
> > > > Markham
> > > > > <
> > > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> > > > > >> > >>> > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > wrote:
> > > > > >> > >>> > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI,
> > but
> > > > > please
> > > > > >> > >>> > > > > > > > > > > > continue
> > > > > >> > >>> > > > > holding
> > > > > >> > >>> > > > > > > > off on
> > > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there are
> > any
> > > > > >> > objections,
> > > > > >> > >>> > > > > > > > > > > > I'd
> > > > > >> > >>> > > > like
> > > > > >> > >>> > > > > to
> > > > > >> > >>> > > > > > > > launch
> > > > > >> > >>> > > > > > > > > > > > the new website today.
> > > > > >> > >>> > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM
> Aaron
> > > > > Markham
> > > > > >> <
> > > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > > > >> > >>> > > > > > > > > > > wrote:
> > > > > >> > >>> > > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > > Hi everyone,
> > > > > >> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the
> new
> > > > > website
> > > > > >> and
> > > > > >> > >>> > > > > > > > > > > > > docs
> > > > > >> > >>> > > have
> > > > > >> > >>> > > > > > > passed
> > > > > >> > >>> > > > > > > > CI
> > > > > >> > >>> > > > > > > > > > > > > (finally). Please do not make
> > changes to
> > > > > >> /docs
> > > > > >> > or
> > > > > >> > >>> > > > > > > > > > > > > /ci
> > > > > >> > >>> > > > until
> > > > > >> > >>> > > > > > we
> > > > > >> > >>> > > > > > > > get
> > > > > >> > >>> > > > > > > > > > > > > these approved and merged. Every
> > time
> > > > > >> there's a
> > > > > >> > >>> > > > > > > > > > > > > merge
> > > > > >> > >>> > > > > > conflict
> > > > > >> > >>> > > > > > > > it has
> > > > > >> > >>> > > > > > > > > > > > > set us back a day or two while
> > > > shepherding
> > > > > >> the
> > > > > >> > >>> PRs
> > > > > >> > >>> > > > through
> > > > > >> > >>> > > > > CI
> > > > > >> > >>> > > > > > > > again.
> > > > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic
> issues
> > > > > >> discovered
> > > > > >> > >>> in
> > > > > >> > >>> > > > > > > > > > > > > a
> > > > > >> > >>> > > > > review,
> > > > > >> > >>> > > > > > I
> > > > > >> > >>> > > > > > > > > > > > > recommend that we hold any patches
> > or
> > > > > >> updates
> > > > > >> > to
> > > > > >> > >>> > > > > > > > > > > > > the
> > > > > >> > >>> > > PRs
> > > > > >> > >>> > > > to
> > > > > >> > >>> > > > > > > > follow-up
> > > > > >> > >>> > > > > > > > > > > > > PRs.
> > > > > >> > >>> > > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > > There are four steps to launch:
> > > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the
> > plan
> > > > is
> > > > > to
> > > > > >> > >>> merge
> > > > > >> > >>> > > 15885
> > > > > >> > >>> > > > to
> > > > > >> > >>> > > > > > > > delete
> > > > > >> > >>> > > > > > > > > > the
> > > > > >> > >>> > > > > > > > > > > > > old content first.
> > > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to
> > add
> > > > in
> > > > > >> the
> > > > > >> > new
> > > > > >> > >>> > > > > > > > > > > > > CI
> > > > > >> > >>> > > > flows
> > > > > >> > >>> > > > > > and
> > > > > >> > >>> > > > > > > > > > updates
> > > > > >> > >>> > > > > > > > > > > > > to the content Thomas and I have
> > already
> > > > > had
> > > > > >> > >>> > > > > > > > > > > > > merged in
> > > > > >> > >>> > > > > 15884
> > > > > >> > >>> > > > > > > [3].
> > > > > >> > >>> > > > > > > > > > > > > 3. I will change the website
> > validation
> > > > > >> Jenkins
> > > > > >> > >>> > > pipeline
> > > > > >> > >>> > > > to
> > > > > >> > >>> > > > > > > > point to
> > > > > >> > >>> > > > > > > > > > > > > the new pipeline.
> > > > > >> > >>> > > > > > > > > > > > > 4. I will change the website
> > publishing
> > > > > >> Jenkins
> > > > > >> > >>> > > pipeline
> > > > > >> > >>> > > > to
> > > > > >> > >>> > > > > > > > point to
> > > > > >> > >>> > > > > > > > > > > > > its new pipeline as well. Once
> > > > triggered,
> > > > > >> the
> > > > > >> > old
> > > > > >> > >>> > > > > > > > > > > > > site
> > > > > >> > >>> > > > will
> > > > > >> > >>> > > > > > be
> > > > > >> > >>> > > > > > > > > > > > > replaced with the new one.
> > > > > >> > >>> > > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to update
> > the DNS
> > > > > for
> > > > > >> > >>> > > > beta.mxnet.io
> > > > > >> > >>> > > > > > to
> > > > > >> > >>> > > > > > > > point
> > > > > >> > >>> > > > > > > > > > to
> > > > > >> > >>> > > > > > > > > > > > > production, and there will likely
> be
> > > > some
> > > > > >> > >>> > > > > redirect/.htaccess
> > > > > >> > >>> > > > > > > > updates
> > > > > >> > >>> > > > > > > > > > > > > needed next week to assist with
> any
> > deep
> > > > > >> > linking
> > > > > >> > >>> > > > > > > > > > > > > and
> > > > > >> > >>> > > 404
> > > > > >> > >>> > > > > > issues
> > > > > >> > >>> > > > > > > > that
> > > > > >> > >>> > > > > > > > > > > > > pop up.
> > > > > >> > >>> > > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > > Cheers,
> > > > > >> > >>> > > > > > > > > > > > > Aaron
> > > > > >> > >>> > > > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > > > > > [1]
> > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > > > > >> > >>> > > > > > > > > > > > > [2]
> > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > > > > >> > >>> > > > > > > > > > > > > [3]
> > > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > > > > >> > >>> > > > > > > > > > >
> > > > > >> > >>> > > > > > > > > >
> > > > > >> > >>> > > > > > > > >
> > > > > >> > >>> > > > > > > >
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > --
> > > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > > > >> > >>> > > > > > > *+1 (973) 953-6299*
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > > > [image:
> > https://www.linkedin.com//in/chaibapat25]
> > > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
> > > > > >> > >>> > > > > > > ]
> > > > > >> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > > > >> > >>> > > > > > >[image:
> > > > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > > >> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > > > >> > >>> > > > > > >
> > > > > >> > >>> > > > > >
> > > > > >> > >>> > > > >
> > > > > >> > >>> > > >
> > > > > >> > >>> > >
> > > > > >> > >>>
> > > > > >> > >>
> > > > > >> >
> > > > > >>
> > > > > >
> > > > >
> > > >
> >
>

Re: new website, docs code freeze

[Haibin Lin <ha...@gmail.com>]

Yes, that is the correct one.

On a separate note, are we removing documentation versioning from the
website? How do we switch between the master/nightly version and the stable
version for the python API doc? Maybe there's a switch somewhere but I
cannot find it.

Also, I find that the API doc for many methods are missing, for example,
the Dataset.transform function has detailed documentation on input and
output types, but the doc only shows the one-line description of the method
https://mxnet.apache.org/api/python/docs/api/gluon/_autogen/mxnet.gluon.data.Dataset.html?highlight=dataset#.
Same for other methods such as filter, shard, etc.

Thanks.

Best,
Haibin


On Thu, Oct 3, 2019 at 7:59 AM Aaron Markham <aa...@gmail.com>
wrote:

> Hi Haibin, you mean this one?
>
> https://github.com/apache/incubator-mxnet/blob/master/docs/static_site/src/pages/api/faq/distributed_training.md
> If so, it looks like a link update is needed.
>
> On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin <ha...@gmail.com>
> wrote:
> >
> > I find that the 'distributed training with KVStore' tutorial is gone. Are
> > we adding it back?
> >
> https://mxnet.apache.org/api/python/docs/tutorials/performance/index.html?highlight=distributed#distributed-training
> >
> >
> > On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu <ma...@gmail.com>
> > wrote:
> >
> > > Thanks for the update, great job!
> > >
> > > Are the lighthouse results accessible somewhere? I'd be curious.
> > >
> > > -Marco
> > >
> > > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt.
> 2019,
> > > 13:49:
> > >
> > > > Update on the website:
> > > >
> > > > Highlights:
> > > > - Broken links: a good amount of them have been fixed in this #16284
> > > > <https://github.com/apache/incubator-mxnet/pull/16284>, tutorials
> have
> > > > been
> > > > reorganized (not yet deployed because of CI). A new 404 with quick
> links
> > > > has been added and deployed in #16287
> > > > <https://github.com/apache/incubator-mxnet/pull/16287>
> > > > - Broken Search: Search has been fixed in #16284
> > > > <https://github.com/apache/incubator-mxnet/pull/16284> and merged
> but
> > > not
> > > > deployed yet.
> > > > - Google index issues: new website seems to be indexed now, in this
> > > google
> > > > search: "MXNet NDArray" <
> https://www.google.com/search?q=mxnet+ndarray>
> > > > new
> > > > website is the top result. Redirects for old links to new ones have
> been
> > > > added to the .htaccess, thanks Soji for the help! #16342
> > > > <https://github.com/apache/incubator-mxnet/pull/16342> is still
> waiting
> > > to
> > > > be merged but a manual update to the website has been done in the
> > > > meanwhile.
> > > > - Automated analysis from google lighthouse scoring, compared to the
> old
> > > > website: Performance saw a > ~100% improvement, SEO saw a ~25%
> > > improvement,
> > > > and best practices improved by ~19%. Thanks Russell D. for running
> the
> > > > analysis.
> > > >
> > > > Remaining
> > > > - *[high priority]* API docs are still missing some classes /
> packages /
> > > > methods. ETA for fix is EOW, root cause has been identified, we are
> still
> > > > deciding what's the best way forward for good discoverability as
> well as
> > > > good coverage and maintainability.
> > > > - Adding quick links to directly access Python API docs on homepage.
> > > >
> > > > All the best,
> > > >
> > > > Thomas Delteil
> > > >
> > > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <
> thomas.delteil1@gmail.com
> > > >
> > > > a
> > > > écrit :
> > > >
> > > > > @Philip Yes we're looking at link redirects for older links that
> might
> > > be
> > > > > hosted externally (using htaccess is my preferred way to handle it
> for
> > > > now
> > > > > as you sugested) and we'll use a broken link checker to update the
> > > links
> > > > > that are hosted internally. We'll update the 404 to add an
> explanation
> > > on
> > > > > the website update. Google indexes will slowly update across the
> week
> > > so
> > > > > the google search issues will be less of a problem.
> > > > >
> > > > > If you find any such links yourself, or missing tutorials, please
> > > > consider
> > > > > stepping up and helping fixing them. The more people get familiar
> with
> > > > the
> > > > > new website architecture, the least likely it is to fall in a
> state of
> > > > > stalled updates like the previous one.
> > > > >
> > > > > For the sphinx issues in the python mini-website, missing API
> classes,
> > > if
> > > > > anybody is familiar with it, I'd love for us to bring back the
> > > automatic
> > > > > doc generation for each package so at least we have a list of all
> > > > available
> > > > > classes in each sub package rather than relying on manual
> insertion of
> > > > each
> > > > > class, which is brittle and not future proof. @Lin, Haibin
> > > > > <ha...@amazon.com> if you have experience with it, could we
> sync up
> > > > > offline on how you suggest to do that based on your gluon-nlp
> > > experience?
> > > > >
> > > > > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is
> on
> > > PTO
> > > > > in Europe, I'll try make time today to help with the fixes since
> it is
> > > > > impacting a lot of users.
> > > > >
> > > > > In the meanwhile, any help is appreciated, and more than the value
> of
> > > the
> > > > > fixes, let me repeat that there is tremendous value in having more
> > > people
> > > > > familiar with the website build pipelines. Aaron is the main owner
> for
> > > > the
> > > > > docs but he is already super busy with all his other
> responsibilities.
> > > > I'm
> > > > > available to help if anybody is stuck. I believe Aaron has updated
> the
> > > > > READMEs on how to test the websites locally, if they're not clear,
> feel
> > > > > free to contribute your own explanations or ask for help directly
> to me
> > > > by
> > > > > email or on the discuss forum.
> > > > >
> > > > > Good hunting!
> > > > >
> > > > > Thomas
> > > > >
> > > > >
> > > > >
> > > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <
> marco.g.abreu@gmail.com
> > > >
> > > > a
> > > > > écrit :
> > > > >
> > > > >> Good catch, Mu! Also good idea, Philip!
> > > > >>
> > > > >> Aaron and Thomas, are you going to work on this?
> > > > >>
> > > > >> -Marco
> > > > >>
> > > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> > > > >>
> > > > >> > The questions I found are:
> > > > >> >
> > > > >> > 1. Not ever page contains, especially the homepage
> > > > >> >
> > > > >> >
> > > > >>
> > > >
> > >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > > >> > 2. The correct tracking id is UA-96378503-1 instead of
> > > UA-96378503-11
> > > > in
> > > > >> >
> > > > >> >
> > > > >>
> > > >
> > >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > > >> >
> > > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com>
> wrote:
> > > > >> >
> > > > >> > > I think the reason is that the google tracker is not included
> in
> > > the
> > > > >> new
> > > > >> > > website.
> > > > >> > >
> > > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > > > >> marco.g.abreu@gmail.com>
> > > > >> > > wrote:
> > > > >> > >
> > > > >> > >> Hello,
> > > > >> > >>
> > > > >> > >> I checked the Google Analytics statistics and the launch of
> the
> > > new
> > > > >> > >> website reduced the traffic by over 80%:
> > > > >> > >>
> > > > >> > >> [image: image.png]
> > > > >> > >>
> > > > >> > >> (Please let me know if the image is not visible)
> > > > >> > >>
> > > > >> > >> How shall we handle this?
> > > > >> > >>
> > > > >> > >> Best regards,
> > > > >> > >> Marco
> > > > >> > >>
> > > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> > > > patric.zhao@intel.com>
> > > > >> > >> wrote:
> > > > >> > >>
> > > > >> > >>> For the install page [1], I suggest to add the selection of
> > > > backend
> > > > >> > >>> DeepNumpy [2] which will be more clean.
> > > > >> > >>>
> > > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > > >> > >>> [2] https://numpy.mxnet.io/#installation
> > > > >> > >>>
> > > > >> > >>>
> > > > >> > >>>
> > > > >> > >>> > -----Original Message-----
> > > > >> > >>> > From: kellen sunderland <ke...@gmail.com>
> > > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > > >> > >>> > To: dev@mxnet.incubator.apache.org
> > > > >> > >>> > Subject: Re: new website, docs code freeze
> > > > >> > >>> >
> > > > >> > >>> > New site looks good.  I do notice that a few tutorials
> from
> > > the
> > > > >> old
> > > > >> > >>> site are
> > > > >> > >>> > missing (for example the TensorRT tutorial).  Any plans to
> > > bring
> > > > >> them
> > > > >> > >>> back?
> > > > >> > >>> >
> > > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > > >> > haibin.lin.aws@gmail.com>
> > > > >> > >>> > wrote:
> > > > >> > >>> >
> > > > >> > >>> > > Another issue I found with the current website: the
> Sphinx
> > > > >> object
> > > > >> > >>> > > inventory
> > > > >> > >>> > > <https://www.sphinx-
> > > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is
> missing.
> > > > >> GluonNLP
> > > > >> > >>> > > relies on this file to link document across projects.
> Shall
> > > we
> > > > >> add
> > > > >> > it
> > > > >> > >>> > > back?
> > > > >> > >>> > >
> > > > >> > >>> > > Best,
> > > > >> > >>> > > Haibin
> > > > >> > >>> > >
> > > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> > > > lgo@mobsol.be>
> > > > >> > >>> wrote:
> > > > >> > >>> > >
> > > > >> > >>> > > > Hi,
> > > > >> > >>> > > >
> > > > >> > >>> > > >
> > > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > > >> > >>> > > > <th...@gmail.com>
> > > > >> > >>> > > > wrote:
> > > > >> > >>> > > >
> > > > >> > >>> > > > > Thanks all for the feedback,
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > We'll send an email next week with the list of
> missing
> > > > >> > features,
> > > > >> > >>> > > content
> > > > >> > >>> > > > > and bugs that we plan to fix.
> > > > >> > >>> > > > > We took the option of releasing early, with some
> > > features
> > > > >> > >>> missing,
> > > > >> > >>> > > rather
> > > > >> > >>> > > > > than trying to be at feature parity with the old
> website
> > > > >> before
> > > > >> > >>> > > launching
> > > > >> > >>> > > > > the website.
> > > > >> > >>> > > > > The reason why we decided to do that is two-fold:
> > > > >> > >>> > > > > - playing catch-up with docs in master introduce
> daily
> > > > >> > conflicts
> > > > >> > >>> > > > > that
> > > > >> > >>> > > > need
> > > > >> > >>> > > > > to be resolved and introduce opportunity for errors
> > > > >> > >>> > > > > - by releasing early, we can take advantage of the
> > > > community
> > > > >> > >>> > > > contributions
> > > > >> > >>> > > > > in modifying whatever the community feels like a
> better
> > > > way
> > > > >> of
> > > > >> > >>> > > > > doing things.
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > One of the goals of the new website was to
> disentangle
> > > the
> > > > >> main
> > > > >> > >>> > > website,
> > > > >> > >>> > > > > now called "static_site" to the auto-generated
> docs. Now
> > > > the
> > > > >> > >>> > > > > overall
> > > > >> > >>> > > site
> > > > >> > >>> > > > > is made of a main static site, with easy to modify
> > > content
> > > > >> and
> > > > >> > >>> > > > > easy to understand architecture for anybody familiar
> > > with
> > > > >> basic
> > > > >> > >>> > > > > html, and a collection of mini-websites for each
> > > language
> > > > >> > >>> bindings
> > > > >> > >>> > > > > that can be
> > > > >> > >>> > > built
> > > > >> > >>> > > > in
> > > > >> > >>> > > > > isolation and that are self-contained. Actually the
> new
> > > CI
> > > > >> jobs
> > > > >> > >>> > > > > builds
> > > > >> > >>> > > > all
> > > > >> > >>> > > > > of them in parallel independently.
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > There is PLENTY of room for improvement, it would be
> > > great
> > > > >> if
> > > > >> > the
> > > > >> > >>> > > > community
> > > > >> > >>> > > > > can help contribute to bring the new website at the
> same
> > > > >> level
> > > > >> > of
> > > > >> > >>> > > content
> > > > >> > >>> > > > > richness as the old one, and then even further.
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > Missing features:
> > > > >> > >>> > > > > - As pointed by Haibin, the API docs do not have the
> > > full
> > > > >> list
> > > > >> > of
> > > > >> > >>> > > > operators
> > > > >> > >>> > > > > and classes. There is a mix of auto-generated docs
> based
> > > > on
> > > > >> > >>> > > > > packages,
> > > > >> > >>> > > and
> > > > >> > >>> > > > > some docs that are spelled out manually to improve
> the
> > > > >> logical
> > > > >> > >>> > > > organization
> > > > >> > >>> > > > > of the package where there is a need. The drawback
> with
> > > > >> > manually
> > > > >> > >>> > > > > listed classes in a package is that it's very easy
> to
> > > miss
> > > > >> > some.
> > > > >> > >>> > > > > If someone
> > > > >> > >>> > > > wanted
> > > > >> > >>> > > > > to build a sanity check that would automatically
> detect
> > > > >> which
> > > > >> > >>> > > > > classes
> > > > >> > >>> > > are
> > > > >> > >>> > > > > not in the documentation, or if someone knew how to
> > > enable
> > > > >> that
> > > > >> > >>> > > > > with sphinx, that would be a great addition to the
> > > python
> > > > >> docs
> > > > >> > >>> > > > > - There is missing content in the python tutorials,
> and
> > > > the
> > > > >> > >>> > > > discoverability
> > > > >> > >>> > > > > could be improved. Some old tutorials have not been
> > > > migrated
> > > > >> > >>> just yet.
> > > > >> > >>> > > > > - The nightly tests on tutorials have been disabled
> for
> > > > now
> > > > >> > >>> > > > > - There is no "Download jupyter notebook" for
> tutorials
> > > > just
> > > > >> > yet.
> > > > >> > >>> > > > > - Non-python tutorials might benefit from a blurb
> > > > >> description
> > > > >> > and
> > > > >> > >>> > > > > a
> > > > >> > >>> > > > better
> > > > >> > >>> > > > > content organization.
> > > > >> > >>> > > > > - Python tutorials could be better organized, have a
> > > > picture
> > > > >> > >>> > > accompanying
> > > > >> > >>> > > > > their description
> > > > >> > >>> > > > > - There is no site-wide search, this is not an easy
> > > > problem
> > > > >> to
> > > > >> > >>> > > > > solve to
> > > > >> > >>> > > > be
> > > > >> > >>> > > > > fair given the static nature of the website, but
> maybe
> > > an
> > > > >> > >>> external
> > > > >> > >>> > > plugin
> > > > >> > >>> > > > > might be able to give a half-way solution
> > > > >> > >>> > > > > - There is no version selector for the docs
> > > > >> > >>> > > > > - There is bug in search box of the python docs, but
> > > this
> > > > is
> > > > >> > just
> > > > >> > >>> > > > > a
> > > > >> > >>> > > small
> > > > >> > >>> > > > > JS bug that can be fixed easily (on my list for next
> > > week)
> > > > >> > >>> > > > > - Most old links have not had a redirect put in
> place.
> > > > >> > >>> > > > >
> > > > >> > >>> > > > >
> > > > >> > >>> > > > I noticed on the Ubuntu home page in the Developer
> > > dropdown
> > > > >> that
> > > > >> > >>> the
> > > > >> > >>> > > > link MXNet on Ubuntu
> > > > >> > >>> > > > <
> https://mxnet.incubator.apache.org/install/index.html
> > > > >> > >>> > > > >with
> > > > >> > >>> > > > Nvidia
> > > > >> > >>> > > > <
> > > > >> > >>> > > >
> > > > >> > >>> > >
> > > > >> > >>>
> > > > >>
> > > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > > >> > >>> > > mxnet/
> > > > >> > >>> > > > >
> > > > >> > >>> > > > doesn't work anymore, it points to:
> > > > >> > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> > > > >> > >>> > > >
> > > > >> > >>> > > > Also, on the MXNet 'getting started' page
> > > > >> > >>> > > > https://mxnet.incubator.apache.org/get_started , the
> link
> > > > >> > "Ubuntu
> > > > >> > >>> > > > Installation Guide" at the bottom doesn't work
> either, it
> > > > >> points
> > > > >> > >>> to:
> > > > >> > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > > >> > >>> > > >
> > > > >> > >>> > > >
> > > > >> > >>> > > > I suggest you do a scan of the new website to find
> these
> > > > >> dangling
> > > > >> > >>> links.
> > > > >> > >>> > > >
> > > > >> > >>> > > > regards,
> > > > >> > >>> > > >
> > > > >> > >>> > > > Lieven
> > > > >> > >>> > > >
> > > > >> > >>> > > >
> > > > >> > >>> > > >
> > > > >> > >>> > > > > We'll formalize this in github issues next week, but
> > > they
> > > > >> are
> > > > >> > all
> > > > >> > >>> > > fairly
> > > > >> > >>> > > > > small and helping out on these would be a great way
> of
> > > > >> > >>> > > > > familiarizing yourself with the new website build
> system
> > > > and
> > > > >> > >>> website
> > > > >> > >>> > architecture.
> > > > >> > >>> > > > >
> > > > >> > >>> > > > >  Thanks all for the feedback, please keep it coming!
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > Thomas Delteil
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > >> > >>> > > > > <ha...@gmail.com> a écrit :
> > > > >> > >>> > > > >
> > > > >> > >>> > > > > > It looks like my previous email did not go
> through.
> > > > >> > Re-sending:
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > > Hi Aaron,
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > > The website looks cool. Thanks for pushing this to
> > > > >> > production.
> > > > >> > >>> A
> > > > >> > >>> > > > > > few
> > > > >> > >>> > > > > > questions:
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > > - I was looking for the API doc for mx.sym.dot,
> but I
> > > > find
> > > > >> > that
> > > > >> > >>> > > > > > most operators under mx.sym.* are missing. Is this
> > > > >> expected?
> > > > >> > >>> > > > > > - I was also checking the search functionality,
> > > > searching
> > > > >> the
> > > > >> > >>> > > > > > keyword "ndarray" only returns one result
> > > > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > > >> > >>> > > > doesn't
> > > > >> > >>> > > > > > seem right. There animation keeps going
> (Searching. ->
> > > > >> > >>> > > > > > Searching.. -> Searching ...) and gives me an
> > > impression
> > > > >> that
> > > > >> > >>> > > > > > the search is never completely done(?).
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > > Best,
> > > > >> > >>> > > > > > Haibin
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > > > >> > >>> > > chai.bapat@gmail.com>
> > > > >> > >>> > > > > > wrote:
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > > > > Thanks Aaron and the team for launching new
> website!
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > 1. There's no search button anywhere on the
> landing
> > > > >> page.
> > > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without search
> > > > button
> > > > >> I
> > > > >> > >>> dont
> > > > >> > >>> > > > > > > have
> > > > >> > >>> > > > > > option
> > > > >> > >>> > > > > > > but to go manually on each menu). Only when I
> go to
> > > > >> > >>> > > > > > > Docs&Tutorials
> > > > >> > >>> > > ->
> > > > >> > >>> > > > > FAQ
> > > > >> > >>> > > > > > > -> Extend and Cotribute (that I got what I
> wanted).
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > Suggestions
> > > > >> > >>> > > > > > > Might want to make this searchable and pop FAQ
> on
> > > the
> > > > >> main
> > > > >> > >>> > > > > > > page (or somewhere prominent)
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > Thanks,
> > > > >> > >>> > > > > > > Chai
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak
> <
> > > > >> > >>> > > ptrendx@apache.org>
> > > > >> > >>> > > > > > > wrote:
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > > There seems to be a problem with (at least
> Python,
> > > > did
> > > > >> > not
> > > > >> > >>> > > > > > > > check
> > > > >> > >>> > > > > > others)
> > > > >> > >>> > > > > > > > APIs. For example this page:
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > >
> > > > >> > >>> > > >
> > > > >> > >>> > >
> > > > >> > >>> >
> > > > >> >
> > > >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > > > says that it is a convenience method for
> argmax
> > > > (with
> > > > >> a
> > > > >> > >>> > > > > > > > link),
> > > > >> > >>> > > but
> > > > >> > >>> > > > > > > > clicking that link just points to the same
> website
> > > > >> (and
> > > > >> > so
> > > > >> > >>> > > > > > > > user
> > > > >> > >>> > > has
> > > > >> > >>> > > > > no
> > > > >> > >>> > > > > > > way
> > > > >> > >>> > > > > > > > of getting to the docs of the actual
> operator).
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > > > When I tried to manually remove Symbol from
> the
> > > URL
> > > > to
> > > > >> > get
> > > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not
> found"
> > > > >> webpage
> > > > >> > >>> > > > > > > > which I
> > > > >> > >>> > > guess
> > > > >> > >>> > > > > > also
> > > > >> > >>> > > > > > > > should not happen (ignoring the fact that this
> > > > should
> > > > >> > >>> exist,
> > > > >> > >>> > > going
> > > > >> > >>> > > > to
> > > > >> > >>> > > > > > > > random URL under the website should redirect
> to
> > > the
> > > > >> main
> > > > >> > >>> > > > > > > > page I
> > > > >> > >>> > > > > think).
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > > > Przemek
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> > > > apeforest@gmail.com
> > > > >> >
> > > > >> > >>> wrote:
> > > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many
> others
> > > > for
> > > > >> > >>> > > > > > > > > launching
> > > > >> > >>> > > > > this!
> > > > >> > >>> > > > > > > > >
> > > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier
> <
> > > > >> > >>> > > > carinmeier@gmail.com>
> > > > >> > >>> > > > > > > > wrote:
> > > > >> > >>> > > > > > > > >
> > > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > > >> > >>> > > > > > > > > >
> > > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron
> > > Markham <
> > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > > >> > >>> > > > > > > > > > wrote:
> > > > >> > >>> > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > Alrighty! The new site is launched. You
> > > might
> > > > >> need
> > > > >> > to
> > > > >> > >>> > > > > > > > > > > clear
> > > > >> > >>> > > > > your
> > > > >> > >>> > > > > > > > cache.
> > > > >> > >>> > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > Cheers,
> > > > >> > >>> > > > > > > > > > > Aaron
> > > > >> > >>> > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron
> > > Markham
> > > > <
> > > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> > > > >> > >>> > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > wrote:
> > > > >> > >>> > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI,
> but
> > > > please
> > > > >> > >>> > > > > > > > > > > > continue
> > > > >> > >>> > > > > holding
> > > > >> > >>> > > > > > > > off on
> > > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there are
> any
> > > > >> > objections,
> > > > >> > >>> > > > > > > > > > > > I'd
> > > > >> > >>> > > > like
> > > > >> > >>> > > > > to
> > > > >> > >>> > > > > > > > launch
> > > > >> > >>> > > > > > > > > > > > the new website today.
> > > > >> > >>> > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron
> > > > Markham
> > > > >> <
> > > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > > >> > >>> > > > > > > > > > > wrote:
> > > > >> > >>> > > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > > Hi everyone,
> > > > >> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new
> > > > website
> > > > >> and
> > > > >> > >>> > > > > > > > > > > > > docs
> > > > >> > >>> > > have
> > > > >> > >>> > > > > > > passed
> > > > >> > >>> > > > > > > > CI
> > > > >> > >>> > > > > > > > > > > > > (finally). Please do not make
> changes to
> > > > >> /docs
> > > > >> > or
> > > > >> > >>> > > > > > > > > > > > > /ci
> > > > >> > >>> > > > until
> > > > >> > >>> > > > > > we
> > > > >> > >>> > > > > > > > get
> > > > >> > >>> > > > > > > > > > > > > these approved and merged. Every
> time
> > > > >> there's a
> > > > >> > >>> > > > > > > > > > > > > merge
> > > > >> > >>> > > > > > conflict
> > > > >> > >>> > > > > > > > it has
> > > > >> > >>> > > > > > > > > > > > > set us back a day or two while
> > > shepherding
> > > > >> the
> > > > >> > >>> PRs
> > > > >> > >>> > > > through
> > > > >> > >>> > > > > CI
> > > > >> > >>> > > > > > > > again.
> > > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> > > > >> discovered
> > > > >> > >>> in
> > > > >> > >>> > > > > > > > > > > > > a
> > > > >> > >>> > > > > review,
> > > > >> > >>> > > > > > I
> > > > >> > >>> > > > > > > > > > > > > recommend that we hold any patches
> or
> > > > >> updates
> > > > >> > to
> > > > >> > >>> > > > > > > > > > > > > the
> > > > >> > >>> > > PRs
> > > > >> > >>> > > > to
> > > > >> > >>> > > > > > > > follow-up
> > > > >> > >>> > > > > > > > > > > > > PRs.
> > > > >> > >>> > > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > > There are four steps to launch:
> > > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the
> plan
> > > is
> > > > to
> > > > >> > >>> merge
> > > > >> > >>> > > 15885
> > > > >> > >>> > > > to
> > > > >> > >>> > > > > > > > delete
> > > > >> > >>> > > > > > > > > > the
> > > > >> > >>> > > > > > > > > > > > > old content first.
> > > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to
> add
> > > in
> > > > >> the
> > > > >> > new
> > > > >> > >>> > > > > > > > > > > > > CI
> > > > >> > >>> > > > flows
> > > > >> > >>> > > > > > and
> > > > >> > >>> > > > > > > > > > updates
> > > > >> > >>> > > > > > > > > > > > > to the content Thomas and I have
> already
> > > > had
> > > > >> > >>> > > > > > > > > > > > > merged in
> > > > >> > >>> > > > > 15884
> > > > >> > >>> > > > > > > [3].
> > > > >> > >>> > > > > > > > > > > > > 3. I will change the website
> validation
> > > > >> Jenkins
> > > > >> > >>> > > pipeline
> > > > >> > >>> > > > to
> > > > >> > >>> > > > > > > > point to
> > > > >> > >>> > > > > > > > > > > > > the new pipeline.
> > > > >> > >>> > > > > > > > > > > > > 4. I will change the website
> publishing
> > > > >> Jenkins
> > > > >> > >>> > > pipeline
> > > > >> > >>> > > > to
> > > > >> > >>> > > > > > > > point to
> > > > >> > >>> > > > > > > > > > > > > its new pipeline as well. Once
> > > triggered,
> > > > >> the
> > > > >> > old
> > > > >> > >>> > > > > > > > > > > > > site
> > > > >> > >>> > > > will
> > > > >> > >>> > > > > > be
> > > > >> > >>> > > > > > > > > > > > > replaced with the new one.
> > > > >> > >>> > > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > > Post launch we'll need to update
> the DNS
> > > > for
> > > > >> > >>> > > > beta.mxnet.io
> > > > >> > >>> > > > > > to
> > > > >> > >>> > > > > > > > point
> > > > >> > >>> > > > > > > > > > to
> > > > >> > >>> > > > > > > > > > > > > production, and there will likely be
> > > some
> > > > >> > >>> > > > > redirect/.htaccess
> > > > >> > >>> > > > > > > > updates
> > > > >> > >>> > > > > > > > > > > > > needed next week to assist with any
> deep
> > > > >> > linking
> > > > >> > >>> > > > > > > > > > > > > and
> > > > >> > >>> > > 404
> > > > >> > >>> > > > > > issues
> > > > >> > >>> > > > > > > > that
> > > > >> > >>> > > > > > > > > > > > > pop up.
> > > > >> > >>> > > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > > Cheers,
> > > > >> > >>> > > > > > > > > > > > > Aaron
> > > > >> > >>> > > > > > > > > > > > >
> > > > >> > >>> > > > > > > > > > > > > [1]
> > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > > > >> > >>> > > > > > > > > > > > > [2]
> > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > > > >> > >>> > > > > > > > > > > > > [3]
> > > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > > > >> > >>> > > > > > > > > > >
> > > > >> > >>> > > > > > > > > >
> > > > >> > >>> > > > > > > > >
> > > > >> > >>> > > > > > > >
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > --
> > > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > > >> > >>> > > > > > > *+1 (973) 953-6299*
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > > > [image:
> https://www.linkedin.com//in/chaibapat25]
> > > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > > >> > >>> > > > > > https://www.facebook.com/chaibapat
> > > > >> > >>> > > > > > > ]
> > > > >> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > > >> > >>> > > > > > >[image:
> > > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > >> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > > >> > >>> > > > > > >
> > > > >> > >>> > > > > >
> > > > >> > >>> > > > >
> > > > >> > >>> > > >
> > > > >> > >>> > >
> > > > >> > >>>
> > > > >> > >>
> > > > >> >
> > > > >>
> > > > >
> > > >
> > >
>

Re: new website, docs code freeze

[Aaron Markham <aa...@gmail.com>]

Hi Haibin, you mean this one?
https://github.com/apache/incubator-mxnet/blob/master/docs/static_site/src/pages/api/faq/distributed_training.md
If so, it looks like a link update is needed.

On Wed, Oct 2, 2019 at 9:42 PM Haibin Lin <ha...@gmail.com> wrote:
>
> I find that the 'distributed training with KVStore' tutorial is gone. Are
> we adding it back?
> https://mxnet.apache.org/api/python/docs/tutorials/performance/index.html?highlight=distributed#distributed-training
>
>
> On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu <ma...@gmail.com>
> wrote:
>
> > Thanks for the update, great job!
> >
> > Are the lighthouse results accessible somewhere? I'd be curious.
> >
> > -Marco
> >
> > Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt. 2019,
> > 13:49:
> >
> > > Update on the website:
> > >
> > > Highlights:
> > > - Broken links: a good amount of them have been fixed in this #16284
> > > <https://github.com/apache/incubator-mxnet/pull/16284>, tutorials have
> > > been
> > > reorganized (not yet deployed because of CI). A new 404 with quick links
> > > has been added and deployed in #16287
> > > <https://github.com/apache/incubator-mxnet/pull/16287>
> > > - Broken Search: Search has been fixed in #16284
> > > <https://github.com/apache/incubator-mxnet/pull/16284> and merged but
> > not
> > > deployed yet.
> > > - Google index issues: new website seems to be indexed now, in this
> > google
> > > search: "MXNet NDArray" <https://www.google.com/search?q=mxnet+ndarray>
> > > new
> > > website is the top result. Redirects for old links to new ones have been
> > > added to the .htaccess, thanks Soji for the help! #16342
> > > <https://github.com/apache/incubator-mxnet/pull/16342> is still waiting
> > to
> > > be merged but a manual update to the website has been done in the
> > > meanwhile.
> > > - Automated analysis from google lighthouse scoring, compared to the old
> > > website: Performance saw a > ~100% improvement, SEO saw a ~25%
> > improvement,
> > > and best practices improved by ~19%. Thanks Russell D. for running the
> > > analysis.
> > >
> > > Remaining
> > > - *[high priority]* API docs are still missing some classes / packages /
> > > methods. ETA for fix is EOW, root cause has been identified, we are still
> > > deciding what's the best way forward for good discoverability as well as
> > > good coverage and maintainability.
> > > - Adding quick links to directly access Python API docs on homepage.
> > >
> > > All the best,
> > >
> > > Thomas Delteil
> > >
> > > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <thomas.delteil1@gmail.com
> > >
> > > a
> > > écrit :
> > >
> > > > @Philip Yes we're looking at link redirects for older links that might
> > be
> > > > hosted externally (using htaccess is my preferred way to handle it for
> > > now
> > > > as you sugested) and we'll use a broken link checker to update the
> > links
> > > > that are hosted internally. We'll update the 404 to add an explanation
> > on
> > > > the website update. Google indexes will slowly update across the week
> > so
> > > > the google search issues will be less of a problem.
> > > >
> > > > If you find any such links yourself, or missing tutorials, please
> > > consider
> > > > stepping up and helping fixing them. The more people get familiar with
> > > the
> > > > new website architecture, the least likely it is to fall in a state of
> > > > stalled updates like the previous one.
> > > >
> > > > For the sphinx issues in the python mini-website, missing API classes,
> > if
> > > > anybody is familiar with it, I'd love for us to bring back the
> > automatic
> > > > doc generation for each package so at least we have a list of all
> > > available
> > > > classes in each sub package rather than relying on manual insertion of
> > > each
> > > > class, which is brittle and not future proof. @Lin, Haibin
> > > > <ha...@amazon.com> if you have experience with it, could we sync up
> > > > offline on how you suggest to do that based on your gluon-nlp
> > experience?
> > > >
> > > > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on
> > PTO
> > > > in Europe, I'll try make time today to help with the fixes since it is
> > > > impacting a lot of users.
> > > >
> > > > In the meanwhile, any help is appreciated, and more than the value of
> > the
> > > > fixes, let me repeat that there is tremendous value in having more
> > people
> > > > familiar with the website build pipelines. Aaron is the main owner for
> > > the
> > > > docs but he is already super busy with all his other responsibilities.
> > > I'm
> > > > available to help if anybody is stuck. I believe Aaron has updated the
> > > > READMEs on how to test the websites locally, if they're not clear, feel
> > > > free to contribute your own explanations or ask for help directly to me
> > > by
> > > > email or on the discuss forum.
> > > >
> > > > Good hunting!
> > > >
> > > > Thomas
> > > >
> > > >
> > > >
> > > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <marco.g.abreu@gmail.com
> > >
> > > a
> > > > écrit :
> > > >
> > > >> Good catch, Mu! Also good idea, Philip!
> > > >>
> > > >> Aaron and Thomas, are you going to work on this?
> > > >>
> > > >> -Marco
> > > >>
> > > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> > > >>
> > > >> > The questions I found are:
> > > >> >
> > > >> > 1. Not ever page contains, especially the homepage
> > > >> >
> > > >> >
> > > >>
> > >
> > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > >> > 2. The correct tracking id is UA-96378503-1 instead of
> > UA-96378503-11
> > > in
> > > >> >
> > > >> >
> > > >>
> > >
> > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > >> >
> > > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> > > >> >
> > > >> > > I think the reason is that the google tracker is not included in
> > the
> > > >> new
> > > >> > > website.
> > > >> > >
> > > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > > >> marco.g.abreu@gmail.com>
> > > >> > > wrote:
> > > >> > >
> > > >> > >> Hello,
> > > >> > >>
> > > >> > >> I checked the Google Analytics statistics and the launch of the
> > new
> > > >> > >> website reduced the traffic by over 80%:
> > > >> > >>
> > > >> > >> [image: image.png]
> > > >> > >>
> > > >> > >> (Please let me know if the image is not visible)
> > > >> > >>
> > > >> > >> How shall we handle this?
> > > >> > >>
> > > >> > >> Best regards,
> > > >> > >> Marco
> > > >> > >>
> > > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> > > patric.zhao@intel.com>
> > > >> > >> wrote:
> > > >> > >>
> > > >> > >>> For the install page [1], I suggest to add the selection of
> > > backend
> > > >> > >>> DeepNumpy [2] which will be more clean.
> > > >> > >>>
> > > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > >> > >>> [2] https://numpy.mxnet.io/#installation
> > > >> > >>>
> > > >> > >>>
> > > >> > >>>
> > > >> > >>> > -----Original Message-----
> > > >> > >>> > From: kellen sunderland <ke...@gmail.com>
> > > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > >> > >>> > To: dev@mxnet.incubator.apache.org
> > > >> > >>> > Subject: Re: new website, docs code freeze
> > > >> > >>> >
> > > >> > >>> > New site looks good.  I do notice that a few tutorials from
> > the
> > > >> old
> > > >> > >>> site are
> > > >> > >>> > missing (for example the TensorRT tutorial).  Any plans to
> > bring
> > > >> them
> > > >> > >>> back?
> > > >> > >>> >
> > > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > >> > haibin.lin.aws@gmail.com>
> > > >> > >>> > wrote:
> > > >> > >>> >
> > > >> > >>> > > Another issue I found with the current website: the Sphinx
> > > >> object
> > > >> > >>> > > inventory
> > > >> > >>> > > <https://www.sphinx-
> > > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
> > > >> GluonNLP
> > > >> > >>> > > relies on this file to link document across projects. Shall
> > we
> > > >> add
> > > >> > it
> > > >> > >>> > > back?
> > > >> > >>> > >
> > > >> > >>> > > Best,
> > > >> > >>> > > Haibin
> > > >> > >>> > >
> > > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> > > lgo@mobsol.be>
> > > >> > >>> wrote:
> > > >> > >>> > >
> > > >> > >>> > > > Hi,
> > > >> > >>> > > >
> > > >> > >>> > > >
> > > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > >> > >>> > > > <th...@gmail.com>
> > > >> > >>> > > > wrote:
> > > >> > >>> > > >
> > > >> > >>> > > > > Thanks all for the feedback,
> > > >> > >>> > > > >
> > > >> > >>> > > > > We'll send an email next week with the list of missing
> > > >> > features,
> > > >> > >>> > > content
> > > >> > >>> > > > > and bugs that we plan to fix.
> > > >> > >>> > > > > We took the option of releasing early, with some
> > features
> > > >> > >>> missing,
> > > >> > >>> > > rather
> > > >> > >>> > > > > than trying to be at feature parity with the old website
> > > >> before
> > > >> > >>> > > launching
> > > >> > >>> > > > > the website.
> > > >> > >>> > > > > The reason why we decided to do that is two-fold:
> > > >> > >>> > > > > - playing catch-up with docs in master introduce daily
> > > >> > conflicts
> > > >> > >>> > > > > that
> > > >> > >>> > > > need
> > > >> > >>> > > > > to be resolved and introduce opportunity for errors
> > > >> > >>> > > > > - by releasing early, we can take advantage of the
> > > community
> > > >> > >>> > > > contributions
> > > >> > >>> > > > > in modifying whatever the community feels like a better
> > > way
> > > >> of
> > > >> > >>> > > > > doing things.
> > > >> > >>> > > > >
> > > >> > >>> > > > > One of the goals of the new website was to disentangle
> > the
> > > >> main
> > > >> > >>> > > website,
> > > >> > >>> > > > > now called "static_site" to the auto-generated docs. Now
> > > the
> > > >> > >>> > > > > overall
> > > >> > >>> > > site
> > > >> > >>> > > > > is made of a main static site, with easy to modify
> > content
> > > >> and
> > > >> > >>> > > > > easy to understand architecture for anybody familiar
> > with
> > > >> basic
> > > >> > >>> > > > > html, and a collection of mini-websites for each
> > language
> > > >> > >>> bindings
> > > >> > >>> > > > > that can be
> > > >> > >>> > > built
> > > >> > >>> > > > in
> > > >> > >>> > > > > isolation and that are self-contained. Actually the new
> > CI
> > > >> jobs
> > > >> > >>> > > > > builds
> > > >> > >>> > > > all
> > > >> > >>> > > > > of them in parallel independently.
> > > >> > >>> > > > >
> > > >> > >>> > > > > There is PLENTY of room for improvement, it would be
> > great
> > > >> if
> > > >> > the
> > > >> > >>> > > > community
> > > >> > >>> > > > > can help contribute to bring the new website at the same
> > > >> level
> > > >> > of
> > > >> > >>> > > content
> > > >> > >>> > > > > richness as the old one, and then even further.
> > > >> > >>> > > > >
> > > >> > >>> > > > > Missing features:
> > > >> > >>> > > > > - As pointed by Haibin, the API docs do not have the
> > full
> > > >> list
> > > >> > of
> > > >> > >>> > > > operators
> > > >> > >>> > > > > and classes. There is a mix of auto-generated docs based
> > > on
> > > >> > >>> > > > > packages,
> > > >> > >>> > > and
> > > >> > >>> > > > > some docs that are spelled out manually to improve the
> > > >> logical
> > > >> > >>> > > > organization
> > > >> > >>> > > > > of the package where there is a need. The drawback with
> > > >> > manually
> > > >> > >>> > > > > listed classes in a package is that it's very easy to
> > miss
> > > >> > some.
> > > >> > >>> > > > > If someone
> > > >> > >>> > > > wanted
> > > >> > >>> > > > > to build a sanity check that would automatically detect
> > > >> which
> > > >> > >>> > > > > classes
> > > >> > >>> > > are
> > > >> > >>> > > > > not in the documentation, or if someone knew how to
> > enable
> > > >> that
> > > >> > >>> > > > > with sphinx, that would be a great addition to the
> > python
> > > >> docs
> > > >> > >>> > > > > - There is missing content in the python tutorials, and
> > > the
> > > >> > >>> > > > discoverability
> > > >> > >>> > > > > could be improved. Some old tutorials have not been
> > > migrated
> > > >> > >>> just yet.
> > > >> > >>> > > > > - The nightly tests on tutorials have been disabled for
> > > now
> > > >> > >>> > > > > - There is no "Download jupyter notebook" for tutorials
> > > just
> > > >> > yet.
> > > >> > >>> > > > > - Non-python tutorials might benefit from a blurb
> > > >> description
> > > >> > and
> > > >> > >>> > > > > a
> > > >> > >>> > > > better
> > > >> > >>> > > > > content organization.
> > > >> > >>> > > > > - Python tutorials could be better organized, have a
> > > picture
> > > >> > >>> > > accompanying
> > > >> > >>> > > > > their description
> > > >> > >>> > > > > - There is no site-wide search, this is not an easy
> > > problem
> > > >> to
> > > >> > >>> > > > > solve to
> > > >> > >>> > > > be
> > > >> > >>> > > > > fair given the static nature of the website, but maybe
> > an
> > > >> > >>> external
> > > >> > >>> > > plugin
> > > >> > >>> > > > > might be able to give a half-way solution
> > > >> > >>> > > > > - There is no version selector for the docs
> > > >> > >>> > > > > - There is bug in search box of the python docs, but
> > this
> > > is
> > > >> > just
> > > >> > >>> > > > > a
> > > >> > >>> > > small
> > > >> > >>> > > > > JS bug that can be fixed easily (on my list for next
> > week)
> > > >> > >>> > > > > - Most old links have not had a redirect put in place.
> > > >> > >>> > > > >
> > > >> > >>> > > > >
> > > >> > >>> > > > I noticed on the Ubuntu home page in the Developer
> > dropdown
> > > >> that
> > > >> > >>> the
> > > >> > >>> > > > link MXNet on Ubuntu
> > > >> > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> > > >> > >>> > > > >with
> > > >> > >>> > > > Nvidia
> > > >> > >>> > > > <
> > > >> > >>> > > >
> > > >> > >>> > >
> > > >> > >>>
> > > >>
> > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > >> > >>> > > mxnet/
> > > >> > >>> > > > >
> > > >> > >>> > > > doesn't work anymore, it points to:
> > > >> > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> > > >> > >>> > > >
> > > >> > >>> > > > Also, on the MXNet 'getting started' page
> > > >> > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> > > >> > "Ubuntu
> > > >> > >>> > > > Installation Guide" at the bottom doesn't work either, it
> > > >> points
> > > >> > >>> to:
> > > >> > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > >> > >>> > > >
> > > >> > >>> > > >
> > > >> > >>> > > > I suggest you do a scan of the new website to find these
> > > >> dangling
> > > >> > >>> links.
> > > >> > >>> > > >
> > > >> > >>> > > > regards,
> > > >> > >>> > > >
> > > >> > >>> > > > Lieven
> > > >> > >>> > > >
> > > >> > >>> > > >
> > > >> > >>> > > >
> > > >> > >>> > > > > We'll formalize this in github issues next week, but
> > they
> > > >> are
> > > >> > all
> > > >> > >>> > > fairly
> > > >> > >>> > > > > small and helping out on these would be a great way of
> > > >> > >>> > > > > familiarizing yourself with the new website build system
> > > and
> > > >> > >>> website
> > > >> > >>> > architecture.
> > > >> > >>> > > > >
> > > >> > >>> > > > >  Thanks all for the feedback, please keep it coming!
> > > >> > >>> > > > >
> > > >> > >>> > > > > Thomas Delteil
> > > >> > >>> > > > >
> > > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > >> > >>> > > > > <ha...@gmail.com> a écrit :
> > > >> > >>> > > > >
> > > >> > >>> > > > > > It looks like my previous email did not go through.
> > > >> > Re-sending:
> > > >> > >>> > > > > >
> > > >> > >>> > > > > > Hi Aaron,
> > > >> > >>> > > > > >
> > > >> > >>> > > > > > The website looks cool. Thanks for pushing this to
> > > >> > production.
> > > >> > >>> A
> > > >> > >>> > > > > > few
> > > >> > >>> > > > > > questions:
> > > >> > >>> > > > > >
> > > >> > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I
> > > find
> > > >> > that
> > > >> > >>> > > > > > most operators under mx.sym.* are missing. Is this
> > > >> expected?
> > > >> > >>> > > > > > - I was also checking the search functionality,
> > > searching
> > > >> the
> > > >> > >>> > > > > > keyword "ndarray" only returns one result
> > > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > >> > >>> > > > doesn't
> > > >> > >>> > > > > > seem right. There animation keeps going (Searching. ->
> > > >> > >>> > > > > > Searching.. -> Searching ...) and gives me an
> > impression
> > > >> that
> > > >> > >>> > > > > > the search is never completely done(?).
> > > >> > >>> > > > > >
> > > >> > >>> > > > > > Best,
> > > >> > >>> > > > > > Haibin
> > > >> > >>> > > > > >
> > > >> > >>> > > > > >
> > > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > > >> > >>> > > chai.bapat@gmail.com>
> > > >> > >>> > > > > > wrote:
> > > >> > >>> > > > > >
> > > >> > >>> > > > > > > Thanks Aaron and the team for launching new website!
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > 1. There's no search button anywhere on the landing
> > > >> page.
> > > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without search
> > > button
> > > >> I
> > > >> > >>> dont
> > > >> > >>> > > > > > > have
> > > >> > >>> > > > > > option
> > > >> > >>> > > > > > > but to go manually on each menu). Only when I go to
> > > >> > >>> > > > > > > Docs&Tutorials
> > > >> > >>> > > ->
> > > >> > >>> > > > > FAQ
> > > >> > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > Suggestions
> > > >> > >>> > > > > > > Might want to make this searchable and pop FAQ on
> > the
> > > >> main
> > > >> > >>> > > > > > > page (or somewhere prominent)
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > Thanks,
> > > >> > >>> > > > > > > Chai
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > > >> > >>> > > ptrendx@apache.org>
> > > >> > >>> > > > > > > wrote:
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > > There seems to be a problem with (at least Python,
> > > did
> > > >> > not
> > > >> > >>> > > > > > > > check
> > > >> > >>> > > > > > others)
> > > >> > >>> > > > > > > > APIs. For example this page:
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > >
> > > >> > >>> > > > >
> > > >> > >>> > > >
> > > >> > >>> > >
> > > >> > >>> >
> > > >> >
> > > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > > > says that it is a convenience method for argmax
> > > (with
> > > >> a
> > > >> > >>> > > > > > > > link),
> > > >> > >>> > > but
> > > >> > >>> > > > > > > > clicking that link just points to the same website
> > > >> (and
> > > >> > so
> > > >> > >>> > > > > > > > user
> > > >> > >>> > > has
> > > >> > >>> > > > > no
> > > >> > >>> > > > > > > way
> > > >> > >>> > > > > > > > of getting to the docs of the actual operator).
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > > > When I tried to manually remove Symbol from the
> > URL
> > > to
> > > >> > get
> > > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
> > > >> webpage
> > > >> > >>> > > > > > > > which I
> > > >> > >>> > > guess
> > > >> > >>> > > > > > also
> > > >> > >>> > > > > > > > should not happen (ignoring the fact that this
> > > should
> > > >> > >>> exist,
> > > >> > >>> > > going
> > > >> > >>> > > > to
> > > >> > >>> > > > > > > > random URL under the website should redirect to
> > the
> > > >> main
> > > >> > >>> > > > > > > > page I
> > > >> > >>> > > > > think).
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > > > Przemek
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> > > apeforest@gmail.com
> > > >> >
> > > >> > >>> wrote:
> > > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others
> > > for
> > > >> > >>> > > > > > > > > launching
> > > >> > >>> > > > > this!
> > > >> > >>> > > > > > > > >
> > > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > > >> > >>> > > > carinmeier@gmail.com>
> > > >> > >>> > > > > > > > wrote:
> > > >> > >>> > > > > > > > >
> > > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > >> > >>> > > > > > > > > >
> > > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron
> > Markham <
> > > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > >> > >>> > > > > > > > > > wrote:
> > > >> > >>> > > > > > > > > >
> > > >> > >>> > > > > > > > > > > Alrighty! The new site is launched. You
> > might
> > > >> need
> > > >> > to
> > > >> > >>> > > > > > > > > > > clear
> > > >> > >>> > > > > your
> > > >> > >>> > > > > > > > cache.
> > > >> > >>> > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > Cheers,
> > > >> > >>> > > > > > > > > > > Aaron
> > > >> > >>> > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron
> > Markham
> > > <
> > > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> > > >> > >>> > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > wrote:
> > > >> > >>> > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but
> > > please
> > > >> > >>> > > > > > > > > > > > continue
> > > >> > >>> > > > > holding
> > > >> > >>> > > > > > > > off on
> > > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> > > >> > objections,
> > > >> > >>> > > > > > > > > > > > I'd
> > > >> > >>> > > > like
> > > >> > >>> > > > > to
> > > >> > >>> > > > > > > > launch
> > > >> > >>> > > > > > > > > > > > the new website today.
> > > >> > >>> > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron
> > > Markham
> > > >> <
> > > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > >> > >>> > > > > > > > > > > wrote:
> > > >> > >>> > > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > > Hi everyone,
> > > >> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new
> > > website
> > > >> and
> > > >> > >>> > > > > > > > > > > > > docs
> > > >> > >>> > > have
> > > >> > >>> > > > > > > passed
> > > >> > >>> > > > > > > > CI
> > > >> > >>> > > > > > > > > > > > > (finally). Please do not make changes to
> > > >> /docs
> > > >> > or
> > > >> > >>> > > > > > > > > > > > > /ci
> > > >> > >>> > > > until
> > > >> > >>> > > > > > we
> > > >> > >>> > > > > > > > get
> > > >> > >>> > > > > > > > > > > > > these approved and merged. Every time
> > > >> there's a
> > > >> > >>> > > > > > > > > > > > > merge
> > > >> > >>> > > > > > conflict
> > > >> > >>> > > > > > > > it has
> > > >> > >>> > > > > > > > > > > > > set us back a day or two while
> > shepherding
> > > >> the
> > > >> > >>> PRs
> > > >> > >>> > > > through
> > > >> > >>> > > > > CI
> > > >> > >>> > > > > > > > again.
> > > >> > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> > > >> discovered
> > > >> > >>> in
> > > >> > >>> > > > > > > > > > > > > a
> > > >> > >>> > > > > review,
> > > >> > >>> > > > > > I
> > > >> > >>> > > > > > > > > > > > > recommend that we hold any patches or
> > > >> updates
> > > >> > to
> > > >> > >>> > > > > > > > > > > > > the
> > > >> > >>> > > PRs
> > > >> > >>> > > > to
> > > >> > >>> > > > > > > > follow-up
> > > >> > >>> > > > > > > > > > > > > PRs.
> > > >> > >>> > > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > > There are four steps to launch:
> > > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan
> > is
> > > to
> > > >> > >>> merge
> > > >> > >>> > > 15885
> > > >> > >>> > > > to
> > > >> > >>> > > > > > > > delete
> > > >> > >>> > > > > > > > > > the
> > > >> > >>> > > > > > > > > > > > > old content first.
> > > >> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add
> > in
> > > >> the
> > > >> > new
> > > >> > >>> > > > > > > > > > > > > CI
> > > >> > >>> > > > flows
> > > >> > >>> > > > > > and
> > > >> > >>> > > > > > > > > > updates
> > > >> > >>> > > > > > > > > > > > > to the content Thomas and I have already
> > > had
> > > >> > >>> > > > > > > > > > > > > merged in
> > > >> > >>> > > > > 15884
> > > >> > >>> > > > > > > [3].
> > > >> > >>> > > > > > > > > > > > > 3. I will change the website validation
> > > >> Jenkins
> > > >> > >>> > > pipeline
> > > >> > >>> > > > to
> > > >> > >>> > > > > > > > point to
> > > >> > >>> > > > > > > > > > > > > the new pipeline.
> > > >> > >>> > > > > > > > > > > > > 4. I will change the website publishing
> > > >> Jenkins
> > > >> > >>> > > pipeline
> > > >> > >>> > > > to
> > > >> > >>> > > > > > > > point to
> > > >> > >>> > > > > > > > > > > > > its new pipeline as well. Once
> > triggered,
> > > >> the
> > > >> > old
> > > >> > >>> > > > > > > > > > > > > site
> > > >> > >>> > > > will
> > > >> > >>> > > > > > be
> > > >> > >>> > > > > > > > > > > > > replaced with the new one.
> > > >> > >>> > > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS
> > > for
> > > >> > >>> > > > beta.mxnet.io
> > > >> > >>> > > > > > to
> > > >> > >>> > > > > > > > point
> > > >> > >>> > > > > > > > > > to
> > > >> > >>> > > > > > > > > > > > > production, and there will likely be
> > some
> > > >> > >>> > > > > redirect/.htaccess
> > > >> > >>> > > > > > > > updates
> > > >> > >>> > > > > > > > > > > > > needed next week to assist with any deep
> > > >> > linking
> > > >> > >>> > > > > > > > > > > > > and
> > > >> > >>> > > 404
> > > >> > >>> > > > > > issues
> > > >> > >>> > > > > > > > that
> > > >> > >>> > > > > > > > > > > > > pop up.
> > > >> > >>> > > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > > Cheers,
> > > >> > >>> > > > > > > > > > > > > Aaron
> > > >> > >>> > > > > > > > > > > > >
> > > >> > >>> > > > > > > > > > > > > [1]
> > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > > >> > >>> > > > > > > > > > > > > [2]
> > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > > >> > >>> > > > > > > > > > > > > [3]
> > > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > > >> > >>> > > > > > > > > > >
> > > >> > >>> > > > > > > > > >
> > > >> > >>> > > > > > > > >
> > > >> > >>> > > > > > > >
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > --
> > > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > >> > >>> > > > > > > *+1 (973) 953-6299*
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > >> > >>> > > > > > https://www.facebook.com/chaibapat
> > > >> > >>> > > > > > > ]
> > > >> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > >> > >>> > > > > > >[image:
> > > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > >> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > >> > >>> > > > > > >
> > > >> > >>> > > > > >
> > > >> > >>> > > > >
> > > >> > >>> > > >
> > > >> > >>> > >
> > > >> > >>>
> > > >> > >>
> > > >> >
> > > >>
> > > >
> > >
> >

Re: new website, docs code freeze

[Haibin Lin <ha...@gmail.com>]

I find that the 'distributed training with KVStore' tutorial is gone. Are
we adding it back?
https://mxnet.apache.org/api/python/docs/tutorials/performance/index.html?highlight=distributed#distributed-training


On Tue, Oct 1, 2019 at 4:54 AM Marco de Abreu <ma...@gmail.com>
wrote:

> Thanks for the update, great job!
>
> Are the lighthouse results accessible somewhere? I'd be curious.
>
> -Marco
>
> Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt. 2019,
> 13:49:
>
> > Update on the website:
> >
> > Highlights:
> > - Broken links: a good amount of them have been fixed in this #16284
> > <https://github.com/apache/incubator-mxnet/pull/16284>, tutorials have
> > been
> > reorganized (not yet deployed because of CI). A new 404 with quick links
> > has been added and deployed in #16287
> > <https://github.com/apache/incubator-mxnet/pull/16287>
> > - Broken Search: Search has been fixed in #16284
> > <https://github.com/apache/incubator-mxnet/pull/16284> and merged but
> not
> > deployed yet.
> > - Google index issues: new website seems to be indexed now, in this
> google
> > search: "MXNet NDArray" <https://www.google.com/search?q=mxnet+ndarray>
> > new
> > website is the top result. Redirects for old links to new ones have been
> > added to the .htaccess, thanks Soji for the help! #16342
> > <https://github.com/apache/incubator-mxnet/pull/16342> is still waiting
> to
> > be merged but a manual update to the website has been done in the
> > meanwhile.
> > - Automated analysis from google lighthouse scoring, compared to the old
> > website: Performance saw a > ~100% improvement, SEO saw a ~25%
> improvement,
> > and best practices improved by ~19%. Thanks Russell D. for running the
> > analysis.
> >
> > Remaining
> > - *[high priority]* API docs are still missing some classes / packages /
> > methods. ETA for fix is EOW, root cause has been identified, we are still
> > deciding what's the best way forward for good discoverability as well as
> > good coverage and maintainability.
> > - Adding quick links to directly access Python API docs on homepage.
> >
> > All the best,
> >
> > Thomas Delteil
> >
> > Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <thomas.delteil1@gmail.com
> >
> > a
> > écrit :
> >
> > > @Philip Yes we're looking at link redirects for older links that might
> be
> > > hosted externally (using htaccess is my preferred way to handle it for
> > now
> > > as you sugested) and we'll use a broken link checker to update the
> links
> > > that are hosted internally. We'll update the 404 to add an explanation
> on
> > > the website update. Google indexes will slowly update across the week
> so
> > > the google search issues will be less of a problem.
> > >
> > > If you find any such links yourself, or missing tutorials, please
> > consider
> > > stepping up and helping fixing them. The more people get familiar with
> > the
> > > new website architecture, the least likely it is to fall in a state of
> > > stalled updates like the previous one.
> > >
> > > For the sphinx issues in the python mini-website, missing API classes,
> if
> > > anybody is familiar with it, I'd love for us to bring back the
> automatic
> > > doc generation for each package so at least we have a list of all
> > available
> > > classes in each sub package rather than relying on manual insertion of
> > each
> > > class, which is brittle and not future proof. @Lin, Haibin
> > > <ha...@amazon.com> if you have experience with it, could we sync up
> > > offline on how you suggest to do that based on your gluon-nlp
> experience?
> > >
> > > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on
> PTO
> > > in Europe, I'll try make time today to help with the fixes since it is
> > > impacting a lot of users.
> > >
> > > In the meanwhile, any help is appreciated, and more than the value of
> the
> > > fixes, let me repeat that there is tremendous value in having more
> people
> > > familiar with the website build pipelines. Aaron is the main owner for
> > the
> > > docs but he is already super busy with all his other responsibilities.
> > I'm
> > > available to help if anybody is stuck. I believe Aaron has updated the
> > > READMEs on how to test the websites locally, if they're not clear, feel
> > > free to contribute your own explanations or ask for help directly to me
> > by
> > > email or on the discuss forum.
> > >
> > > Good hunting!
> > >
> > > Thomas
> > >
> > >
> > >
> > > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <marco.g.abreu@gmail.com
> >
> > a
> > > écrit :
> > >
> > >> Good catch, Mu! Also good idea, Philip!
> > >>
> > >> Aaron and Thomas, are you going to work on this?
> > >>
> > >> -Marco
> > >>
> > >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> > >>
> > >> > The questions I found are:
> > >> >
> > >> > 1. Not ever page contains, especially the homepage
> > >> >
> > >> >
> > >>
> >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > >> > 2. The correct tracking id is UA-96378503-1 instead of
> UA-96378503-11
> > in
> > >> >
> > >> >
> > >>
> >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > >> >
> > >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> > >> >
> > >> > > I think the reason is that the google tracker is not included in
> the
> > >> new
> > >> > > website.
> > >> > >
> > >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > >> marco.g.abreu@gmail.com>
> > >> > > wrote:
> > >> > >
> > >> > >> Hello,
> > >> > >>
> > >> > >> I checked the Google Analytics statistics and the launch of the
> new
> > >> > >> website reduced the traffic by over 80%:
> > >> > >>
> > >> > >> [image: image.png]
> > >> > >>
> > >> > >> (Please let me know if the image is not visible)
> > >> > >>
> > >> > >> How shall we handle this?
> > >> > >>
> > >> > >> Best regards,
> > >> > >> Marco
> > >> > >>
> > >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> > patric.zhao@intel.com>
> > >> > >> wrote:
> > >> > >>
> > >> > >>> For the install page [1], I suggest to add the selection of
> > backend
> > >> > >>> DeepNumpy [2] which will be more clean.
> > >> > >>>
> > >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > >> > >>> [2] https://numpy.mxnet.io/#installation
> > >> > >>>
> > >> > >>>
> > >> > >>>
> > >> > >>> > -----Original Message-----
> > >> > >>> > From: kellen sunderland <ke...@gmail.com>
> > >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > >> > >>> > To: dev@mxnet.incubator.apache.org
> > >> > >>> > Subject: Re: new website, docs code freeze
> > >> > >>> >
> > >> > >>> > New site looks good.  I do notice that a few tutorials from
> the
> > >> old
> > >> > >>> site are
> > >> > >>> > missing (for example the TensorRT tutorial).  Any plans to
> bring
> > >> them
> > >> > >>> back?
> > >> > >>> >
> > >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > >> > haibin.lin.aws@gmail.com>
> > >> > >>> > wrote:
> > >> > >>> >
> > >> > >>> > > Another issue I found with the current website: the Sphinx
> > >> object
> > >> > >>> > > inventory
> > >> > >>> > > <https://www.sphinx-
> > >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > >> > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
> > >> GluonNLP
> > >> > >>> > > relies on this file to link document across projects. Shall
> we
> > >> add
> > >> > it
> > >> > >>> > > back?
> > >> > >>> > >
> > >> > >>> > > Best,
> > >> > >>> > > Haibin
> > >> > >>> > >
> > >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> > lgo@mobsol.be>
> > >> > >>> wrote:
> > >> > >>> > >
> > >> > >>> > > > Hi,
> > >> > >>> > > >
> > >> > >>> > > >
> > >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > >> > >>> > > > <th...@gmail.com>
> > >> > >>> > > > wrote:
> > >> > >>> > > >
> > >> > >>> > > > > Thanks all for the feedback,
> > >> > >>> > > > >
> > >> > >>> > > > > We'll send an email next week with the list of missing
> > >> > features,
> > >> > >>> > > content
> > >> > >>> > > > > and bugs that we plan to fix.
> > >> > >>> > > > > We took the option of releasing early, with some
> features
> > >> > >>> missing,
> > >> > >>> > > rather
> > >> > >>> > > > > than trying to be at feature parity with the old website
> > >> before
> > >> > >>> > > launching
> > >> > >>> > > > > the website.
> > >> > >>> > > > > The reason why we decided to do that is two-fold:
> > >> > >>> > > > > - playing catch-up with docs in master introduce daily
> > >> > conflicts
> > >> > >>> > > > > that
> > >> > >>> > > > need
> > >> > >>> > > > > to be resolved and introduce opportunity for errors
> > >> > >>> > > > > - by releasing early, we can take advantage of the
> > community
> > >> > >>> > > > contributions
> > >> > >>> > > > > in modifying whatever the community feels like a better
> > way
> > >> of
> > >> > >>> > > > > doing things.
> > >> > >>> > > > >
> > >> > >>> > > > > One of the goals of the new website was to disentangle
> the
> > >> main
> > >> > >>> > > website,
> > >> > >>> > > > > now called "static_site" to the auto-generated docs. Now
> > the
> > >> > >>> > > > > overall
> > >> > >>> > > site
> > >> > >>> > > > > is made of a main static site, with easy to modify
> content
> > >> and
> > >> > >>> > > > > easy to understand architecture for anybody familiar
> with
> > >> basic
> > >> > >>> > > > > html, and a collection of mini-websites for each
> language
> > >> > >>> bindings
> > >> > >>> > > > > that can be
> > >> > >>> > > built
> > >> > >>> > > > in
> > >> > >>> > > > > isolation and that are self-contained. Actually the new
> CI
> > >> jobs
> > >> > >>> > > > > builds
> > >> > >>> > > > all
> > >> > >>> > > > > of them in parallel independently.
> > >> > >>> > > > >
> > >> > >>> > > > > There is PLENTY of room for improvement, it would be
> great
> > >> if
> > >> > the
> > >> > >>> > > > community
> > >> > >>> > > > > can help contribute to bring the new website at the same
> > >> level
> > >> > of
> > >> > >>> > > content
> > >> > >>> > > > > richness as the old one, and then even further.
> > >> > >>> > > > >
> > >> > >>> > > > > Missing features:
> > >> > >>> > > > > - As pointed by Haibin, the API docs do not have the
> full
> > >> list
> > >> > of
> > >> > >>> > > > operators
> > >> > >>> > > > > and classes. There is a mix of auto-generated docs based
> > on
> > >> > >>> > > > > packages,
> > >> > >>> > > and
> > >> > >>> > > > > some docs that are spelled out manually to improve the
> > >> logical
> > >> > >>> > > > organization
> > >> > >>> > > > > of the package where there is a need. The drawback with
> > >> > manually
> > >> > >>> > > > > listed classes in a package is that it's very easy to
> miss
> > >> > some.
> > >> > >>> > > > > If someone
> > >> > >>> > > > wanted
> > >> > >>> > > > > to build a sanity check that would automatically detect
> > >> which
> > >> > >>> > > > > classes
> > >> > >>> > > are
> > >> > >>> > > > > not in the documentation, or if someone knew how to
> enable
> > >> that
> > >> > >>> > > > > with sphinx, that would be a great addition to the
> python
> > >> docs
> > >> > >>> > > > > - There is missing content in the python tutorials, and
> > the
> > >> > >>> > > > discoverability
> > >> > >>> > > > > could be improved. Some old tutorials have not been
> > migrated
> > >> > >>> just yet.
> > >> > >>> > > > > - The nightly tests on tutorials have been disabled for
> > now
> > >> > >>> > > > > - There is no "Download jupyter notebook" for tutorials
> > just
> > >> > yet.
> > >> > >>> > > > > - Non-python tutorials might benefit from a blurb
> > >> description
> > >> > and
> > >> > >>> > > > > a
> > >> > >>> > > > better
> > >> > >>> > > > > content organization.
> > >> > >>> > > > > - Python tutorials could be better organized, have a
> > picture
> > >> > >>> > > accompanying
> > >> > >>> > > > > their description
> > >> > >>> > > > > - There is no site-wide search, this is not an easy
> > problem
> > >> to
> > >> > >>> > > > > solve to
> > >> > >>> > > > be
> > >> > >>> > > > > fair given the static nature of the website, but maybe
> an
> > >> > >>> external
> > >> > >>> > > plugin
> > >> > >>> > > > > might be able to give a half-way solution
> > >> > >>> > > > > - There is no version selector for the docs
> > >> > >>> > > > > - There is bug in search box of the python docs, but
> this
> > is
> > >> > just
> > >> > >>> > > > > a
> > >> > >>> > > small
> > >> > >>> > > > > JS bug that can be fixed easily (on my list for next
> week)
> > >> > >>> > > > > - Most old links have not had a redirect put in place.
> > >> > >>> > > > >
> > >> > >>> > > > >
> > >> > >>> > > > I noticed on the Ubuntu home page in the Developer
> dropdown
> > >> that
> > >> > >>> the
> > >> > >>> > > > link MXNet on Ubuntu
> > >> > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> > >> > >>> > > > >with
> > >> > >>> > > > Nvidia
> > >> > >>> > > > <
> > >> > >>> > > >
> > >> > >>> > >
> > >> > >>>
> > >>
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > >> > >>> > > mxnet/
> > >> > >>> > > > >
> > >> > >>> > > > doesn't work anymore, it points to:
> > >> > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> > >> > >>> > > >
> > >> > >>> > > > Also, on the MXNet 'getting started' page
> > >> > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> > >> > "Ubuntu
> > >> > >>> > > > Installation Guide" at the bottom doesn't work either, it
> > >> points
> > >> > >>> to:
> > >> > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > >> > >>> > > >
> > >> > >>> > > >
> > >> > >>> > > > I suggest you do a scan of the new website to find these
> > >> dangling
> > >> > >>> links.
> > >> > >>> > > >
> > >> > >>> > > > regards,
> > >> > >>> > > >
> > >> > >>> > > > Lieven
> > >> > >>> > > >
> > >> > >>> > > >
> > >> > >>> > > >
> > >> > >>> > > > > We'll formalize this in github issues next week, but
> they
> > >> are
> > >> > all
> > >> > >>> > > fairly
> > >> > >>> > > > > small and helping out on these would be a great way of
> > >> > >>> > > > > familiarizing yourself with the new website build system
> > and
> > >> > >>> website
> > >> > >>> > architecture.
> > >> > >>> > > > >
> > >> > >>> > > > >  Thanks all for the feedback, please keep it coming!
> > >> > >>> > > > >
> > >> > >>> > > > > Thomas Delteil
> > >> > >>> > > > >
> > >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > >> > >>> > > > > <ha...@gmail.com> a écrit :
> > >> > >>> > > > >
> > >> > >>> > > > > > It looks like my previous email did not go through.
> > >> > Re-sending:
> > >> > >>> > > > > >
> > >> > >>> > > > > > Hi Aaron,
> > >> > >>> > > > > >
> > >> > >>> > > > > > The website looks cool. Thanks for pushing this to
> > >> > production.
> > >> > >>> A
> > >> > >>> > > > > > few
> > >> > >>> > > > > > questions:
> > >> > >>> > > > > >
> > >> > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I
> > find
> > >> > that
> > >> > >>> > > > > > most operators under mx.sym.* are missing. Is this
> > >> expected?
> > >> > >>> > > > > > - I was also checking the search functionality,
> > searching
> > >> the
> > >> > >>> > > > > > keyword "ndarray" only returns one result
> > >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > >> > >>> > > > doesn't
> > >> > >>> > > > > > seem right. There animation keeps going (Searching. ->
> > >> > >>> > > > > > Searching.. -> Searching ...) and gives me an
> impression
> > >> that
> > >> > >>> > > > > > the search is never completely done(?).
> > >> > >>> > > > > >
> > >> > >>> > > > > > Best,
> > >> > >>> > > > > > Haibin
> > >> > >>> > > > > >
> > >> > >>> > > > > >
> > >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > >> > >>> > > chai.bapat@gmail.com>
> > >> > >>> > > > > > wrote:
> > >> > >>> > > > > >
> > >> > >>> > > > > > > Thanks Aaron and the team for launching new website!
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > 1. There's no search button anywhere on the landing
> > >> page.
> > >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without search
> > button
> > >> I
> > >> > >>> dont
> > >> > >>> > > > > > > have
> > >> > >>> > > > > > option
> > >> > >>> > > > > > > but to go manually on each menu). Only when I go to
> > >> > >>> > > > > > > Docs&Tutorials
> > >> > >>> > > ->
> > >> > >>> > > > > FAQ
> > >> > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > Suggestions
> > >> > >>> > > > > > > Might want to make this searchable and pop FAQ on
> the
> > >> main
> > >> > >>> > > > > > > page (or somewhere prominent)
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > Thanks,
> > >> > >>> > > > > > > Chai
> > >> > >>> > > > > > >
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > >> > >>> > > ptrendx@apache.org>
> > >> > >>> > > > > > > wrote:
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > > There seems to be a problem with (at least Python,
> > did
> > >> > not
> > >> > >>> > > > > > > > check
> > >> > >>> > > > > > others)
> > >> > >>> > > > > > > > APIs. For example this page:
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > >
> > >> > >>> > > > > >
> > >> > >>> > > > >
> > >> > >>> > > >
> > >> > >>> > >
> > >> > >>> >
> > >> >
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > > > says that it is a convenience method for argmax
> > (with
> > >> a
> > >> > >>> > > > > > > > link),
> > >> > >>> > > but
> > >> > >>> > > > > > > > clicking that link just points to the same website
> > >> (and
> > >> > so
> > >> > >>> > > > > > > > user
> > >> > >>> > > has
> > >> > >>> > > > > no
> > >> > >>> > > > > > > way
> > >> > >>> > > > > > > > of getting to the docs of the actual operator).
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > > > When I tried to manually remove Symbol from the
> URL
> > to
> > >> > get
> > >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
> > >> webpage
> > >> > >>> > > > > > > > which I
> > >> > >>> > > guess
> > >> > >>> > > > > > also
> > >> > >>> > > > > > > > should not happen (ignoring the fact that this
> > should
> > >> > >>> exist,
> > >> > >>> > > going
> > >> > >>> > > > to
> > >> > >>> > > > > > > > random URL under the website should redirect to
> the
> > >> main
> > >> > >>> > > > > > > > page I
> > >> > >>> > > > > think).
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > > > Przemek
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> > apeforest@gmail.com
> > >> >
> > >> > >>> wrote:
> > >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others
> > for
> > >> > >>> > > > > > > > > launching
> > >> > >>> > > > > this!
> > >> > >>> > > > > > > > >
> > >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > >> > >>> > > > carinmeier@gmail.com>
> > >> > >>> > > > > > > > wrote:
> > >> > >>> > > > > > > > >
> > >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > >> > >>> > > > > > > > > >
> > >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron
> Markham <
> > >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > >> > >>> > > > > > > > > > wrote:
> > >> > >>> > > > > > > > > >
> > >> > >>> > > > > > > > > > > Alrighty! The new site is launched. You
> might
> > >> need
> > >> > to
> > >> > >>> > > > > > > > > > > clear
> > >> > >>> > > > > your
> > >> > >>> > > > > > > > cache.
> > >> > >>> > > > > > > > > > >
> > >> > >>> > > > > > > > > > > Cheers,
> > >> > >>> > > > > > > > > > > Aaron
> > >> > >>> > > > > > > > > > >
> > >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron
> Markham
> > <
> > >> > >>> > > > > > > > aaron.s.markham@gmail.com
> > >> > >>> > > > > > > > > > >
> > >> > >>> > > > > > > > > > > wrote:
> > >> > >>> > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but
> > please
> > >> > >>> > > > > > > > > > > > continue
> > >> > >>> > > > > holding
> > >> > >>> > > > > > > > off on
> > >> > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> > >> > objections,
> > >> > >>> > > > > > > > > > > > I'd
> > >> > >>> > > > like
> > >> > >>> > > > > to
> > >> > >>> > > > > > > > launch
> > >> > >>> > > > > > > > > > > > the new website today.
> > >> > >>> > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron
> > Markham
> > >> <
> > >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > >> > >>> > > > > > > > > > > wrote:
> > >> > >>> > > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > > Hi everyone,
> > >> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new
> > website
> > >> and
> > >> > >>> > > > > > > > > > > > > docs
> > >> > >>> > > have
> > >> > >>> > > > > > > passed
> > >> > >>> > > > > > > > CI
> > >> > >>> > > > > > > > > > > > > (finally). Please do not make changes to
> > >> /docs
> > >> > or
> > >> > >>> > > > > > > > > > > > > /ci
> > >> > >>> > > > until
> > >> > >>> > > > > > we
> > >> > >>> > > > > > > > get
> > >> > >>> > > > > > > > > > > > > these approved and merged. Every time
> > >> there's a
> > >> > >>> > > > > > > > > > > > > merge
> > >> > >>> > > > > > conflict
> > >> > >>> > > > > > > > it has
> > >> > >>> > > > > > > > > > > > > set us back a day or two while
> shepherding
> > >> the
> > >> > >>> PRs
> > >> > >>> > > > through
> > >> > >>> > > > > CI
> > >> > >>> > > > > > > > again.
> > >> > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> > >> discovered
> > >> > >>> in
> > >> > >>> > > > > > > > > > > > > a
> > >> > >>> > > > > review,
> > >> > >>> > > > > > I
> > >> > >>> > > > > > > > > > > > > recommend that we hold any patches or
> > >> updates
> > >> > to
> > >> > >>> > > > > > > > > > > > > the
> > >> > >>> > > PRs
> > >> > >>> > > > to
> > >> > >>> > > > > > > > follow-up
> > >> > >>> > > > > > > > > > > > > PRs.
> > >> > >>> > > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > > There are four steps to launch:
> > >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan
> is
> > to
> > >> > >>> merge
> > >> > >>> > > 15885
> > >> > >>> > > > to
> > >> > >>> > > > > > > > delete
> > >> > >>> > > > > > > > > > the
> > >> > >>> > > > > > > > > > > > > old content first.
> > >> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add
> in
> > >> the
> > >> > new
> > >> > >>> > > > > > > > > > > > > CI
> > >> > >>> > > > flows
> > >> > >>> > > > > > and
> > >> > >>> > > > > > > > > > updates
> > >> > >>> > > > > > > > > > > > > to the content Thomas and I have already
> > had
> > >> > >>> > > > > > > > > > > > > merged in
> > >> > >>> > > > > 15884
> > >> > >>> > > > > > > [3].
> > >> > >>> > > > > > > > > > > > > 3. I will change the website validation
> > >> Jenkins
> > >> > >>> > > pipeline
> > >> > >>> > > > to
> > >> > >>> > > > > > > > point to
> > >> > >>> > > > > > > > > > > > > the new pipeline.
> > >> > >>> > > > > > > > > > > > > 4. I will change the website publishing
> > >> Jenkins
> > >> > >>> > > pipeline
> > >> > >>> > > > to
> > >> > >>> > > > > > > > point to
> > >> > >>> > > > > > > > > > > > > its new pipeline as well. Once
> triggered,
> > >> the
> > >> > old
> > >> > >>> > > > > > > > > > > > > site
> > >> > >>> > > > will
> > >> > >>> > > > > > be
> > >> > >>> > > > > > > > > > > > > replaced with the new one.
> > >> > >>> > > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS
> > for
> > >> > >>> > > > beta.mxnet.io
> > >> > >>> > > > > > to
> > >> > >>> > > > > > > > point
> > >> > >>> > > > > > > > > > to
> > >> > >>> > > > > > > > > > > > > production, and there will likely be
> some
> > >> > >>> > > > > redirect/.htaccess
> > >> > >>> > > > > > > > updates
> > >> > >>> > > > > > > > > > > > > needed next week to assist with any deep
> > >> > linking
> > >> > >>> > > > > > > > > > > > > and
> > >> > >>> > > 404
> > >> > >>> > > > > > issues
> > >> > >>> > > > > > > > that
> > >> > >>> > > > > > > > > > > > > pop up.
> > >> > >>> > > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > > Cheers,
> > >> > >>> > > > > > > > > > > > > Aaron
> > >> > >>> > > > > > > > > > > > >
> > >> > >>> > > > > > > > > > > > > [1]
> > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > >> > >>> > > > > > > > > > > > > [2]
> > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > >> > >>> > > > > > > > > > > > > [3]
> > >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > >> > >>> > > > > > > > > > >
> > >> > >>> > > > > > > > > >
> > >> > >>> > > > > > > > >
> > >> > >>> > > > > > > >
> > >> > >>> > > > > > >
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > --
> > >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > >> > >>> > > > > > > *+1 (973) 953-6299*
> > >> > >>> > > > > > >
> > >> > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > >> > >>> > > > > > https://www.facebook.com/chaibapat
> > >> > >>> > > > > > > ]
> > >> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > >> > >>> > > > > > >[image:
> > >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > >> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > >> > >>> > > > > > >
> > >> > >>> > > > > >
> > >> > >>> > > > >
> > >> > >>> > > >
> > >> > >>> > >
> > >> > >>>
> > >> > >>
> > >> >
> > >>
> > >
> >
>

Re: new website, docs code freeze

[Marco de Abreu <ma...@gmail.com>]

Thanks for the update, great job!

Are the lighthouse results accessible somewhere? I'd be curious.

-Marco

Thomas DELTEIL <th...@gmail.com> schrieb am Di., 1. Okt. 2019,
13:49:

> Update on the website:
>
> Highlights:
> - Broken links: a good amount of them have been fixed in this #16284
> <https://github.com/apache/incubator-mxnet/pull/16284>, tutorials have
> been
> reorganized (not yet deployed because of CI). A new 404 with quick links
> has been added and deployed in #16287
> <https://github.com/apache/incubator-mxnet/pull/16287>
> - Broken Search: Search has been fixed in #16284
> <https://github.com/apache/incubator-mxnet/pull/16284> and merged but not
> deployed yet.
> - Google index issues: new website seems to be indexed now, in this google
> search: "MXNet NDArray" <https://www.google.com/search?q=mxnet+ndarray>
> new
> website is the top result. Redirects for old links to new ones have been
> added to the .htaccess, thanks Soji for the help! #16342
> <https://github.com/apache/incubator-mxnet/pull/16342> is still waiting to
> be merged but a manual update to the website has been done in the
> meanwhile.
> - Automated analysis from google lighthouse scoring, compared to the old
> website: Performance saw a > ~100% improvement, SEO saw a ~25% improvement,
> and best practices improved by ~19%. Thanks Russell D. for running the
> analysis.
>
> Remaining
> - *[high priority]* API docs are still missing some classes / packages /
> methods. ETA for fix is EOW, root cause has been identified, we are still
> deciding what's the best way forward for good discoverability as well as
> good coverage and maintainability.
> - Adding quick links to directly access Python API docs on homepage.
>
> All the best,
>
> Thomas Delteil
>
> Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <th...@gmail.com>
> a
> écrit :
>
> > @Philip Yes we're looking at link redirects for older links that might be
> > hosted externally (using htaccess is my preferred way to handle it for
> now
> > as you sugested) and we'll use a broken link checker to update the links
> > that are hosted internally. We'll update the 404 to add an explanation on
> > the website update. Google indexes will slowly update across the week so
> > the google search issues will be less of a problem.
> >
> > If you find any such links yourself, or missing tutorials, please
> consider
> > stepping up and helping fixing them. The more people get familiar with
> the
> > new website architecture, the least likely it is to fall in a state of
> > stalled updates like the previous one.
> >
> > For the sphinx issues in the python mini-website, missing API classes, if
> > anybody is familiar with it, I'd love for us to bring back the automatic
> > doc generation for each package so at least we have a list of all
> available
> > classes in each sub package rather than relying on manual insertion of
> each
> > class, which is brittle and not future proof. @Lin, Haibin
> > <ha...@amazon.com> if you have experience with it, could we sync up
> > offline on how you suggest to do that based on your gluon-nlp experience?
> >
> > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO
> > in Europe, I'll try make time today to help with the fixes since it is
> > impacting a lot of users.
> >
> > In the meanwhile, any help is appreciated, and more than the value of the
> > fixes, let me repeat that there is tremendous value in having more people
> > familiar with the website build pipelines. Aaron is the main owner for
> the
> > docs but he is already super busy with all his other responsibilities.
> I'm
> > available to help if anybody is stuck. I believe Aaron has updated the
> > READMEs on how to test the websites locally, if they're not clear, feel
> > free to contribute your own explanations or ask for help directly to me
> by
> > email or on the discuss forum.
> >
> > Good hunting!
> >
> > Thomas
> >
> >
> >
> > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com>
> a
> > écrit :
> >
> >> Good catch, Mu! Also good idea, Philip!
> >>
> >> Aaron and Thomas, are you going to work on this?
> >>
> >> -Marco
> >>
> >> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> >>
> >> > The questions I found are:
> >> >
> >> > 1. Not ever page contains, especially the homepage
> >> >
> >> >
> >>
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> >> > 2. The correct tracking id is UA-96378503-1 instead of UA-96378503-11
> in
> >> >
> >> >
> >>
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> >> >
> >> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> >> >
> >> > > I think the reason is that the google tracker is not included in the
> >> new
> >> > > website.
> >> > >
> >> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> >> marco.g.abreu@gmail.com>
> >> > > wrote:
> >> > >
> >> > >> Hello,
> >> > >>
> >> > >> I checked the Google Analytics statistics and the launch of the new
> >> > >> website reduced the traffic by over 80%:
> >> > >>
> >> > >> [image: image.png]
> >> > >>
> >> > >> (Please let me know if the image is not visible)
> >> > >>
> >> > >> How shall we handle this?
> >> > >>
> >> > >> Best regards,
> >> > >> Marco
> >> > >>
> >> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> patric.zhao@intel.com>
> >> > >> wrote:
> >> > >>
> >> > >>> For the install page [1], I suggest to add the selection of
> backend
> >> > >>> DeepNumpy [2] which will be more clean.
> >> > >>>
> >> > >>> [1] http://mxnet.incubator.apache.org/index.html
> >> > >>> [2] https://numpy.mxnet.io/#installation
> >> > >>>
> >> > >>>
> >> > >>>
> >> > >>> > -----Original Message-----
> >> > >>> > From: kellen sunderland <ke...@gmail.com>
> >> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> >> > >>> > To: dev@mxnet.incubator.apache.org
> >> > >>> > Subject: Re: new website, docs code freeze
> >> > >>> >
> >> > >>> > New site looks good.  I do notice that a few tutorials from the
> >> old
> >> > >>> site are
> >> > >>> > missing (for example the TensorRT tutorial).  Any plans to bring
> >> them
> >> > >>> back?
> >> > >>> >
> >> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> >> > haibin.lin.aws@gmail.com>
> >> > >>> > wrote:
> >> > >>> >
> >> > >>> > > Another issue I found with the current website: the Sphinx
> >> object
> >> > >>> > > inventory
> >> > >>> > > <https://www.sphinx-
> >> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> >> > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
> >> GluonNLP
> >> > >>> > > relies on this file to link document across projects. Shall we
> >> add
> >> > it
> >> > >>> > > back?
> >> > >>> > >
> >> > >>> > > Best,
> >> > >>> > > Haibin
> >> > >>> > >
> >> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> lgo@mobsol.be>
> >> > >>> wrote:
> >> > >>> > >
> >> > >>> > > > Hi,
> >> > >>> > > >
> >> > >>> > > >
> >> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> >> > >>> > > > <th...@gmail.com>
> >> > >>> > > > wrote:
> >> > >>> > > >
> >> > >>> > > > > Thanks all for the feedback,
> >> > >>> > > > >
> >> > >>> > > > > We'll send an email next week with the list of missing
> >> > features,
> >> > >>> > > content
> >> > >>> > > > > and bugs that we plan to fix.
> >> > >>> > > > > We took the option of releasing early, with some features
> >> > >>> missing,
> >> > >>> > > rather
> >> > >>> > > > > than trying to be at feature parity with the old website
> >> before
> >> > >>> > > launching
> >> > >>> > > > > the website.
> >> > >>> > > > > The reason why we decided to do that is two-fold:
> >> > >>> > > > > - playing catch-up with docs in master introduce daily
> >> > conflicts
> >> > >>> > > > > that
> >> > >>> > > > need
> >> > >>> > > > > to be resolved and introduce opportunity for errors
> >> > >>> > > > > - by releasing early, we can take advantage of the
> community
> >> > >>> > > > contributions
> >> > >>> > > > > in modifying whatever the community feels like a better
> way
> >> of
> >> > >>> > > > > doing things.
> >> > >>> > > > >
> >> > >>> > > > > One of the goals of the new website was to disentangle the
> >> main
> >> > >>> > > website,
> >> > >>> > > > > now called "static_site" to the auto-generated docs. Now
> the
> >> > >>> > > > > overall
> >> > >>> > > site
> >> > >>> > > > > is made of a main static site, with easy to modify content
> >> and
> >> > >>> > > > > easy to understand architecture for anybody familiar with
> >> basic
> >> > >>> > > > > html, and a collection of mini-websites for each language
> >> > >>> bindings
> >> > >>> > > > > that can be
> >> > >>> > > built
> >> > >>> > > > in
> >> > >>> > > > > isolation and that are self-contained. Actually the new CI
> >> jobs
> >> > >>> > > > > builds
> >> > >>> > > > all
> >> > >>> > > > > of them in parallel independently.
> >> > >>> > > > >
> >> > >>> > > > > There is PLENTY of room for improvement, it would be great
> >> if
> >> > the
> >> > >>> > > > community
> >> > >>> > > > > can help contribute to bring the new website at the same
> >> level
> >> > of
> >> > >>> > > content
> >> > >>> > > > > richness as the old one, and then even further.
> >> > >>> > > > >
> >> > >>> > > > > Missing features:
> >> > >>> > > > > - As pointed by Haibin, the API docs do not have the full
> >> list
> >> > of
> >> > >>> > > > operators
> >> > >>> > > > > and classes. There is a mix of auto-generated docs based
> on
> >> > >>> > > > > packages,
> >> > >>> > > and
> >> > >>> > > > > some docs that are spelled out manually to improve the
> >> logical
> >> > >>> > > > organization
> >> > >>> > > > > of the package where there is a need. The drawback with
> >> > manually
> >> > >>> > > > > listed classes in a package is that it's very easy to miss
> >> > some.
> >> > >>> > > > > If someone
> >> > >>> > > > wanted
> >> > >>> > > > > to build a sanity check that would automatically detect
> >> which
> >> > >>> > > > > classes
> >> > >>> > > are
> >> > >>> > > > > not in the documentation, or if someone knew how to enable
> >> that
> >> > >>> > > > > with sphinx, that would be a great addition to the python
> >> docs
> >> > >>> > > > > - There is missing content in the python tutorials, and
> the
> >> > >>> > > > discoverability
> >> > >>> > > > > could be improved. Some old tutorials have not been
> migrated
> >> > >>> just yet.
> >> > >>> > > > > - The nightly tests on tutorials have been disabled for
> now
> >> > >>> > > > > - There is no "Download jupyter notebook" for tutorials
> just
> >> > yet.
> >> > >>> > > > > - Non-python tutorials might benefit from a blurb
> >> description
> >> > and
> >> > >>> > > > > a
> >> > >>> > > > better
> >> > >>> > > > > content organization.
> >> > >>> > > > > - Python tutorials could be better organized, have a
> picture
> >> > >>> > > accompanying
> >> > >>> > > > > their description
> >> > >>> > > > > - There is no site-wide search, this is not an easy
> problem
> >> to
> >> > >>> > > > > solve to
> >> > >>> > > > be
> >> > >>> > > > > fair given the static nature of the website, but maybe an
> >> > >>> external
> >> > >>> > > plugin
> >> > >>> > > > > might be able to give a half-way solution
> >> > >>> > > > > - There is no version selector for the docs
> >> > >>> > > > > - There is bug in search box of the python docs, but this
> is
> >> > just
> >> > >>> > > > > a
> >> > >>> > > small
> >> > >>> > > > > JS bug that can be fixed easily (on my list for next week)
> >> > >>> > > > > - Most old links have not had a redirect put in place.
> >> > >>> > > > >
> >> > >>> > > > >
> >> > >>> > > > I noticed on the Ubuntu home page in the Developer dropdown
> >> that
> >> > >>> the
> >> > >>> > > > link MXNet on Ubuntu
> >> > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> >> > >>> > > > >with
> >> > >>> > > > Nvidia
> >> > >>> > > > <
> >> > >>> > > >
> >> > >>> > >
> >> > >>>
> >> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> >> > >>> > > mxnet/
> >> > >>> > > > >
> >> > >>> > > > doesn't work anymore, it points to:
> >> > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> >> > >>> > > >
> >> > >>> > > > Also, on the MXNet 'getting started' page
> >> > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> >> > "Ubuntu
> >> > >>> > > > Installation Guide" at the bottom doesn't work either, it
> >> points
> >> > >>> to:
> >> > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> >> > >>> > > >
> >> > >>> > > >
> >> > >>> > > > I suggest you do a scan of the new website to find these
> >> dangling
> >> > >>> links.
> >> > >>> > > >
> >> > >>> > > > regards,
> >> > >>> > > >
> >> > >>> > > > Lieven
> >> > >>> > > >
> >> > >>> > > >
> >> > >>> > > >
> >> > >>> > > > > We'll formalize this in github issues next week, but they
> >> are
> >> > all
> >> > >>> > > fairly
> >> > >>> > > > > small and helping out on these would be a great way of
> >> > >>> > > > > familiarizing yourself with the new website build system
> and
> >> > >>> website
> >> > >>> > architecture.
> >> > >>> > > > >
> >> > >>> > > > >  Thanks all for the feedback, please keep it coming!
> >> > >>> > > > >
> >> > >>> > > > > Thomas Delteil
> >> > >>> > > > >
> >> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> >> > >>> > > > > <ha...@gmail.com> a écrit :
> >> > >>> > > > >
> >> > >>> > > > > > It looks like my previous email did not go through.
> >> > Re-sending:
> >> > >>> > > > > >
> >> > >>> > > > > > Hi Aaron,
> >> > >>> > > > > >
> >> > >>> > > > > > The website looks cool. Thanks for pushing this to
> >> > production.
> >> > >>> A
> >> > >>> > > > > > few
> >> > >>> > > > > > questions:
> >> > >>> > > > > >
> >> > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I
> find
> >> > that
> >> > >>> > > > > > most operators under mx.sym.* are missing. Is this
> >> expected?
> >> > >>> > > > > > - I was also checking the search functionality,
> searching
> >> the
> >> > >>> > > > > > keyword "ndarray" only returns one result
> >> > >>> > > > > > "mxnet.ndarray.NDArray", which
> >> > >>> > > > doesn't
> >> > >>> > > > > > seem right. There animation keeps going (Searching. ->
> >> > >>> > > > > > Searching.. -> Searching ...) and gives me an impression
> >> that
> >> > >>> > > > > > the search is never completely done(?).
> >> > >>> > > > > >
> >> > >>> > > > > > Best,
> >> > >>> > > > > > Haibin
> >> > >>> > > > > >
> >> > >>> > > > > >
> >> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> >> > >>> > > chai.bapat@gmail.com>
> >> > >>> > > > > > wrote:
> >> > >>> > > > > >
> >> > >>> > > > > > > Thanks Aaron and the team for launching new website!
> >> > >>> > > > > > >
> >> > >>> > > > > > > 1. There's no search button anywhere on the landing
> >> page.
> >> > >>> > > > > > > 2. I wasn't able to find FAQ (and without search
> button
> >> I
> >> > >>> dont
> >> > >>> > > > > > > have
> >> > >>> > > > > > option
> >> > >>> > > > > > > but to go manually on each menu). Only when I go to
> >> > >>> > > > > > > Docs&Tutorials
> >> > >>> > > ->
> >> > >>> > > > > FAQ
> >> > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> >> > >>> > > > > > >
> >> > >>> > > > > > > Suggestions
> >> > >>> > > > > > > Might want to make this searchable and pop FAQ on the
> >> main
> >> > >>> > > > > > > page (or somewhere prominent)
> >> > >>> > > > > > >
> >> > >>> > > > > > > Thanks,
> >> > >>> > > > > > > Chai
> >> > >>> > > > > > >
> >> > >>> > > > > > >
> >> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> >> > >>> > > ptrendx@apache.org>
> >> > >>> > > > > > > wrote:
> >> > >>> > > > > > >
> >> > >>> > > > > > > > There seems to be a problem with (at least Python,
> did
> >> > not
> >> > >>> > > > > > > > check
> >> > >>> > > > > > others)
> >> > >>> > > > > > > > APIs. For example this page:
> >> > >>> > > > > > > >
> >> > >>> > > > > > > >
> >> > >>> > > > > > >
> >> > >>> > > > > >
> >> > >>> > > > >
> >> > >>> > > >
> >> > >>> > >
> >> > >>> >
> >> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> >> > >>> > > /mxnet.symbol.Symbol.argmax.html
> >> > >>> > > > > > > >
> >> > >>> > > > > > > > says that it is a convenience method for argmax
> (with
> >> a
> >> > >>> > > > > > > > link),
> >> > >>> > > but
> >> > >>> > > > > > > > clicking that link just points to the same website
> >> (and
> >> > so
> >> > >>> > > > > > > > user
> >> > >>> > > has
> >> > >>> > > > > no
> >> > >>> > > > > > > way
> >> > >>> > > > > > > > of getting to the docs of the actual operator).
> >> > >>> > > > > > > >
> >> > >>> > > > > > > > When I tried to manually remove Symbol from the URL
> to
> >> > get
> >> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
> >> webpage
> >> > >>> > > > > > > > which I
> >> > >>> > > guess
> >> > >>> > > > > > also
> >> > >>> > > > > > > > should not happen (ignoring the fact that this
> should
> >> > >>> exist,
> >> > >>> > > going
> >> > >>> > > > to
> >> > >>> > > > > > > > random URL under the website should redirect to the
> >> main
> >> > >>> > > > > > > > page I
> >> > >>> > > > > think).
> >> > >>> > > > > > > >
> >> > >>> > > > > > > > Przemek
> >> > >>> > > > > > > >
> >> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> apeforest@gmail.com
> >> >
> >> > >>> wrote:
> >> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others
> for
> >> > >>> > > > > > > > > launching
> >> > >>> > > > > this!
> >> > >>> > > > > > > > >
> >> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> >> > >>> > > > carinmeier@gmail.com>
> >> > >>> > > > > > > > wrote:
> >> > >>> > > > > > > > >
> >> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> >> > >>> > > > > > > > > >
> >> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> >> > >>> > > > > > > > aaron.s.markham@gmail.com>
> >> > >>> > > > > > > > > > wrote:
> >> > >>> > > > > > > > > >
> >> > >>> > > > > > > > > > > Alrighty! The new site is launched. You might
> >> need
> >> > to
> >> > >>> > > > > > > > > > > clear
> >> > >>> > > > > your
> >> > >>> > > > > > > > cache.
> >> > >>> > > > > > > > > > >
> >> > >>> > > > > > > > > > > Cheers,
> >> > >>> > > > > > > > > > > Aaron
> >> > >>> > > > > > > > > > >
> >> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham
> <
> >> > >>> > > > > > > > aaron.s.markham@gmail.com
> >> > >>> > > > > > > > > > >
> >> > >>> > > > > > > > > > > wrote:
> >> > >>> > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but
> please
> >> > >>> > > > > > > > > > > > continue
> >> > >>> > > > > holding
> >> > >>> > > > > > > > off on
> >> > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> >> > objections,
> >> > >>> > > > > > > > > > > > I'd
> >> > >>> > > > like
> >> > >>> > > > > to
> >> > >>> > > > > > > > launch
> >> > >>> > > > > > > > > > > > the new website today.
> >> > >>> > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron
> Markham
> >> <
> >> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> >> > >>> > > > > > > > > > > wrote:
> >> > >>> > > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > > Hi everyone,
> >> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new
> website
> >> and
> >> > >>> > > > > > > > > > > > > docs
> >> > >>> > > have
> >> > >>> > > > > > > passed
> >> > >>> > > > > > > > CI
> >> > >>> > > > > > > > > > > > > (finally). Please do not make changes to
> >> /docs
> >> > or
> >> > >>> > > > > > > > > > > > > /ci
> >> > >>> > > > until
> >> > >>> > > > > > we
> >> > >>> > > > > > > > get
> >> > >>> > > > > > > > > > > > > these approved and merged. Every time
> >> there's a
> >> > >>> > > > > > > > > > > > > merge
> >> > >>> > > > > > conflict
> >> > >>> > > > > > > > it has
> >> > >>> > > > > > > > > > > > > set us back a day or two while shepherding
> >> the
> >> > >>> PRs
> >> > >>> > > > through
> >> > >>> > > > > CI
> >> > >>> > > > > > > > again.
> >> > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> >> discovered
> >> > >>> in
> >> > >>> > > > > > > > > > > > > a
> >> > >>> > > > > review,
> >> > >>> > > > > > I
> >> > >>> > > > > > > > > > > > > recommend that we hold any patches or
> >> updates
> >> > to
> >> > >>> > > > > > > > > > > > > the
> >> > >>> > > PRs
> >> > >>> > > > to
> >> > >>> > > > > > > > follow-up
> >> > >>> > > > > > > > > > > > > PRs.
> >> > >>> > > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > > There are four steps to launch:
> >> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is
> to
> >> > >>> merge
> >> > >>> > > 15885
> >> > >>> > > > to
> >> > >>> > > > > > > > delete
> >> > >>> > > > > > > > > > the
> >> > >>> > > > > > > > > > > > > old content first.
> >> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in
> >> the
> >> > new
> >> > >>> > > > > > > > > > > > > CI
> >> > >>> > > > flows
> >> > >>> > > > > > and
> >> > >>> > > > > > > > > > updates
> >> > >>> > > > > > > > > > > > > to the content Thomas and I have already
> had
> >> > >>> > > > > > > > > > > > > merged in
> >> > >>> > > > > 15884
> >> > >>> > > > > > > [3].
> >> > >>> > > > > > > > > > > > > 3. I will change the website validation
> >> Jenkins
> >> > >>> > > pipeline
> >> > >>> > > > to
> >> > >>> > > > > > > > point to
> >> > >>> > > > > > > > > > > > > the new pipeline.
> >> > >>> > > > > > > > > > > > > 4. I will change the website publishing
> >> Jenkins
> >> > >>> > > pipeline
> >> > >>> > > > to
> >> > >>> > > > > > > > point to
> >> > >>> > > > > > > > > > > > > its new pipeline as well. Once triggered,
> >> the
> >> > old
> >> > >>> > > > > > > > > > > > > site
> >> > >>> > > > will
> >> > >>> > > > > > be
> >> > >>> > > > > > > > > > > > > replaced with the new one.
> >> > >>> > > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS
> for
> >> > >>> > > > beta.mxnet.io
> >> > >>> > > > > > to
> >> > >>> > > > > > > > point
> >> > >>> > > > > > > > > > to
> >> > >>> > > > > > > > > > > > > production, and there will likely be some
> >> > >>> > > > > redirect/.htaccess
> >> > >>> > > > > > > > updates
> >> > >>> > > > > > > > > > > > > needed next week to assist with any deep
> >> > linking
> >> > >>> > > > > > > > > > > > > and
> >> > >>> > > 404
> >> > >>> > > > > > issues
> >> > >>> > > > > > > > that
> >> > >>> > > > > > > > > > > > > pop up.
> >> > >>> > > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > > Cheers,
> >> > >>> > > > > > > > > > > > > Aaron
> >> > >>> > > > > > > > > > > > >
> >> > >>> > > > > > > > > > > > > [1]
> >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> >> > >>> > > > > > > > > > > > > [2]
> >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> >> > >>> > > > > > > > > > > > > [3]
> >> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> >> > >>> > > > > > > > > > >
> >> > >>> > > > > > > > > >
> >> > >>> > > > > > > > >
> >> > >>> > > > > > > >
> >> > >>> > > > > > >
> >> > >>> > > > > > >
> >> > >>> > > > > > > --
> >> > >>> > > > > > > *Chaitanya Prakash Bapat*
> >> > >>> > > > > > > *+1 (973) 953-6299*
> >> > >>> > > > > > >
> >> > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> >> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> >> > >>> > > > > > https://www.facebook.com/chaibapat
> >> > >>> > > > > > > ]
> >> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> >> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> >> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> >> > >>> > > > > > >[image:
> >> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> >> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> >> > >>> > > > > > >
> >> > >>> > > > > >
> >> > >>> > > > >
> >> > >>> > > >
> >> > >>> > >
> >> > >>>
> >> > >>
> >> >
> >>
> >
>

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

Update on the website:

Highlights:
- Broken links: a good amount of them have been fixed in this #16284
<https://github.com/apache/incubator-mxnet/pull/16284>, tutorials have been
reorganized (not yet deployed because of CI). A new 404 with quick links
has been added and deployed in #16287
<https://github.com/apache/incubator-mxnet/pull/16287>
- Broken Search: Search has been fixed in #16284
<https://github.com/apache/incubator-mxnet/pull/16284> and merged but not
deployed yet.
- Google index issues: new website seems to be indexed now, in this google
search: "MXNet NDArray" <https://www.google.com/search?q=mxnet+ndarray> new
website is the top result. Redirects for old links to new ones have been
added to the .htaccess, thanks Soji for the help! #16342
<https://github.com/apache/incubator-mxnet/pull/16342> is still waiting to
be merged but a manual update to the website has been done in the meanwhile.
- Automated analysis from google lighthouse scoring, compared to the old
website: Performance saw a > ~100% improvement, SEO saw a ~25% improvement,
and best practices improved by ~19%. Thanks Russell D. for running the
analysis.

Remaining
- *[high priority]* API docs are still missing some classes / packages /
methods. ETA for fix is EOW, root cause has been identified, we are still
deciding what's the best way forward for good discoverability as well as
good coverage and maintainability.
- Adding quick links to directly access Python API docs on homepage.

All the best,

Thomas Delteil

Le mar. 24 sept. 2019 à 19:15, Thomas DELTEIL <th...@gmail.com> a
écrit :

> @Philip Yes we're looking at link redirects for older links that might be
> hosted externally (using htaccess is my preferred way to handle it for now
> as you sugested) and we'll use a broken link checker to update the links
> that are hosted internally. We'll update the 404 to add an explanation on
> the website update. Google indexes will slowly update across the week so
> the google search issues will be less of a problem.
>
> If you find any such links yourself, or missing tutorials, please consider
> stepping up and helping fixing them. The more people get familiar with the
> new website architecture, the least likely it is to fall in a state of
> stalled updates like the previous one.
>
> For the sphinx issues in the python mini-website, missing API classes, if
> anybody is familiar with it, I'd love for us to bring back the automatic
> doc generation for each package so at least we have a list of all available
> classes in each sub package rather than relying on manual insertion of each
> class, which is brittle and not future proof. @Lin, Haibin
> <ha...@amazon.com> if you have experience with it, could we sync up
> offline on how you suggest to do that based on your gluon-nlp experience?
>
> @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO
> in Europe, I'll try make time today to help with the fixes since it is
> impacting a lot of users.
>
> In the meanwhile, any help is appreciated, and more than the value of the
> fixes, let me repeat that there is tremendous value in having more people
> familiar with the website build pipelines. Aaron is the main owner for the
> docs but he is already super busy with all his other responsibilities. I'm
> available to help if anybody is stuck. I believe Aaron has updated the
> READMEs on how to test the websites locally, if they're not clear, feel
> free to contribute your own explanations or ask for help directly to me by
> email or on the discuss forum.
>
> Good hunting!
>
> Thomas
>
>
>
> Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com> a
> écrit :
>
>> Good catch, Mu! Also good idea, Philip!
>>
>> Aaron and Thomas, are you going to work on this?
>>
>> -Marco
>>
>> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
>>
>> > The questions I found are:
>> >
>> > 1. Not ever page contains, especially the homepage
>> >
>> >
>> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>> > 2. The correct tracking id is UA-96378503-1 instead of UA-96378503-11 in
>> >
>> >
>> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>> >
>> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
>> >
>> > > I think the reason is that the google tracker is not included in the
>> new
>> > > website.
>> > >
>> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
>> marco.g.abreu@gmail.com>
>> > > wrote:
>> > >
>> > >> Hello,
>> > >>
>> > >> I checked the Google Analytics statistics and the launch of the new
>> > >> website reduced the traffic by over 80%:
>> > >>
>> > >> [image: image.png]
>> > >>
>> > >> (Please let me know if the image is not visible)
>> > >>
>> > >> How shall we handle this?
>> > >>
>> > >> Best regards,
>> > >> Marco
>> > >>
>> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
>> > >> wrote:
>> > >>
>> > >>> For the install page [1], I suggest to add the selection of backend
>> > >>> DeepNumpy [2] which will be more clean.
>> > >>>
>> > >>> [1] http://mxnet.incubator.apache.org/index.html
>> > >>> [2] https://numpy.mxnet.io/#installation
>> > >>>
>> > >>>
>> > >>>
>> > >>> > -----Original Message-----
>> > >>> > From: kellen sunderland <ke...@gmail.com>
>> > >>> > Sent: Monday, September 23, 2019 12:47 PM
>> > >>> > To: dev@mxnet.incubator.apache.org
>> > >>> > Subject: Re: new website, docs code freeze
>> > >>> >
>> > >>> > New site looks good.  I do notice that a few tutorials from the
>> old
>> > >>> site are
>> > >>> > missing (for example the TensorRT tutorial).  Any plans to bring
>> them
>> > >>> back?
>> > >>> >
>> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
>> > haibin.lin.aws@gmail.com>
>> > >>> > wrote:
>> > >>> >
>> > >>> > > Another issue I found with the current website: the Sphinx
>> object
>> > >>> > > inventory
>> > >>> > > <https://www.sphinx-
>> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
>> > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
>> GluonNLP
>> > >>> > > relies on this file to link document across projects. Shall we
>> add
>> > it
>> > >>> > > back?
>> > >>> > >
>> > >>> > > Best,
>> > >>> > > Haibin
>> > >>> > >
>> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
>> > >>> wrote:
>> > >>> > >
>> > >>> > > > Hi,
>> > >>> > > >
>> > >>> > > >
>> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
>> > >>> > > > <th...@gmail.com>
>> > >>> > > > wrote:
>> > >>> > > >
>> > >>> > > > > Thanks all for the feedback,
>> > >>> > > > >
>> > >>> > > > > We'll send an email next week with the list of missing
>> > features,
>> > >>> > > content
>> > >>> > > > > and bugs that we plan to fix.
>> > >>> > > > > We took the option of releasing early, with some features
>> > >>> missing,
>> > >>> > > rather
>> > >>> > > > > than trying to be at feature parity with the old website
>> before
>> > >>> > > launching
>> > >>> > > > > the website.
>> > >>> > > > > The reason why we decided to do that is two-fold:
>> > >>> > > > > - playing catch-up with docs in master introduce daily
>> > conflicts
>> > >>> > > > > that
>> > >>> > > > need
>> > >>> > > > > to be resolved and introduce opportunity for errors
>> > >>> > > > > - by releasing early, we can take advantage of the community
>> > >>> > > > contributions
>> > >>> > > > > in modifying whatever the community feels like a better way
>> of
>> > >>> > > > > doing things.
>> > >>> > > > >
>> > >>> > > > > One of the goals of the new website was to disentangle the
>> main
>> > >>> > > website,
>> > >>> > > > > now called "static_site" to the auto-generated docs. Now the
>> > >>> > > > > overall
>> > >>> > > site
>> > >>> > > > > is made of a main static site, with easy to modify content
>> and
>> > >>> > > > > easy to understand architecture for anybody familiar with
>> basic
>> > >>> > > > > html, and a collection of mini-websites for each language
>> > >>> bindings
>> > >>> > > > > that can be
>> > >>> > > built
>> > >>> > > > in
>> > >>> > > > > isolation and that are self-contained. Actually the new CI
>> jobs
>> > >>> > > > > builds
>> > >>> > > > all
>> > >>> > > > > of them in parallel independently.
>> > >>> > > > >
>> > >>> > > > > There is PLENTY of room for improvement, it would be great
>> if
>> > the
>> > >>> > > > community
>> > >>> > > > > can help contribute to bring the new website at the same
>> level
>> > of
>> > >>> > > content
>> > >>> > > > > richness as the old one, and then even further.
>> > >>> > > > >
>> > >>> > > > > Missing features:
>> > >>> > > > > - As pointed by Haibin, the API docs do not have the full
>> list
>> > of
>> > >>> > > > operators
>> > >>> > > > > and classes. There is a mix of auto-generated docs based on
>> > >>> > > > > packages,
>> > >>> > > and
>> > >>> > > > > some docs that are spelled out manually to improve the
>> logical
>> > >>> > > > organization
>> > >>> > > > > of the package where there is a need. The drawback with
>> > manually
>> > >>> > > > > listed classes in a package is that it's very easy to miss
>> > some.
>> > >>> > > > > If someone
>> > >>> > > > wanted
>> > >>> > > > > to build a sanity check that would automatically detect
>> which
>> > >>> > > > > classes
>> > >>> > > are
>> > >>> > > > > not in the documentation, or if someone knew how to enable
>> that
>> > >>> > > > > with sphinx, that would be a great addition to the python
>> docs
>> > >>> > > > > - There is missing content in the python tutorials, and the
>> > >>> > > > discoverability
>> > >>> > > > > could be improved. Some old tutorials have not been migrated
>> > >>> just yet.
>> > >>> > > > > - The nightly tests on tutorials have been disabled for now
>> > >>> > > > > - There is no "Download jupyter notebook" for tutorials just
>> > yet.
>> > >>> > > > > - Non-python tutorials might benefit from a blurb
>> description
>> > and
>> > >>> > > > > a
>> > >>> > > > better
>> > >>> > > > > content organization.
>> > >>> > > > > - Python tutorials could be better organized, have a picture
>> > >>> > > accompanying
>> > >>> > > > > their description
>> > >>> > > > > - There is no site-wide search, this is not an easy problem
>> to
>> > >>> > > > > solve to
>> > >>> > > > be
>> > >>> > > > > fair given the static nature of the website, but maybe an
>> > >>> external
>> > >>> > > plugin
>> > >>> > > > > might be able to give a half-way solution
>> > >>> > > > > - There is no version selector for the docs
>> > >>> > > > > - There is bug in search box of the python docs, but this is
>> > just
>> > >>> > > > > a
>> > >>> > > small
>> > >>> > > > > JS bug that can be fixed easily (on my list for next week)
>> > >>> > > > > - Most old links have not had a redirect put in place.
>> > >>> > > > >
>> > >>> > > > >
>> > >>> > > > I noticed on the Ubuntu home page in the Developer dropdown
>> that
>> > >>> the
>> > >>> > > > link MXNet on Ubuntu
>> > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
>> > >>> > > > >with
>> > >>> > > > Nvidia
>> > >>> > > > <
>> > >>> > > >
>> > >>> > >
>> > >>>
>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
>> > >>> > > mxnet/
>> > >>> > > > >
>> > >>> > > > doesn't work anymore, it points to:
>> > >>> > > > https://mxnet.incubator.apache.org/install/index.html
>> > >>> > > >
>> > >>> > > > Also, on the MXNet 'getting started' page
>> > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
>> > "Ubuntu
>> > >>> > > > Installation Guide" at the bottom doesn't work either, it
>> points
>> > >>> to:
>> > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
>> > >>> > > >
>> > >>> > > >
>> > >>> > > > I suggest you do a scan of the new website to find these
>> dangling
>> > >>> links.
>> > >>> > > >
>> > >>> > > > regards,
>> > >>> > > >
>> > >>> > > > Lieven
>> > >>> > > >
>> > >>> > > >
>> > >>> > > >
>> > >>> > > > > We'll formalize this in github issues next week, but they
>> are
>> > all
>> > >>> > > fairly
>> > >>> > > > > small and helping out on these would be a great way of
>> > >>> > > > > familiarizing yourself with the new website build system and
>> > >>> website
>> > >>> > architecture.
>> > >>> > > > >
>> > >>> > > > >  Thanks all for the feedback, please keep it coming!
>> > >>> > > > >
>> > >>> > > > > Thomas Delteil
>> > >>> > > > >
>> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>> > >>> > > > > <ha...@gmail.com> a écrit :
>> > >>> > > > >
>> > >>> > > > > > It looks like my previous email did not go through.
>> > Re-sending:
>> > >>> > > > > >
>> > >>> > > > > > Hi Aaron,
>> > >>> > > > > >
>> > >>> > > > > > The website looks cool. Thanks for pushing this to
>> > production.
>> > >>> A
>> > >>> > > > > > few
>> > >>> > > > > > questions:
>> > >>> > > > > >
>> > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find
>> > that
>> > >>> > > > > > most operators under mx.sym.* are missing. Is this
>> expected?
>> > >>> > > > > > - I was also checking the search functionality, searching
>> the
>> > >>> > > > > > keyword "ndarray" only returns one result
>> > >>> > > > > > "mxnet.ndarray.NDArray", which
>> > >>> > > > doesn't
>> > >>> > > > > > seem right. There animation keeps going (Searching. ->
>> > >>> > > > > > Searching.. -> Searching ...) and gives me an impression
>> that
>> > >>> > > > > > the search is never completely done(?).
>> > >>> > > > > >
>> > >>> > > > > > Best,
>> > >>> > > > > > Haibin
>> > >>> > > > > >
>> > >>> > > > > >
>> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
>> > >>> > > chai.bapat@gmail.com>
>> > >>> > > > > > wrote:
>> > >>> > > > > >
>> > >>> > > > > > > Thanks Aaron and the team for launching new website!
>> > >>> > > > > > >
>> > >>> > > > > > > 1. There's no search button anywhere on the landing
>> page.
>> > >>> > > > > > > 2. I wasn't able to find FAQ (and without search button
>> I
>> > >>> dont
>> > >>> > > > > > > have
>> > >>> > > > > > option
>> > >>> > > > > > > but to go manually on each menu). Only when I go to
>> > >>> > > > > > > Docs&Tutorials
>> > >>> > > ->
>> > >>> > > > > FAQ
>> > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
>> > >>> > > > > > >
>> > >>> > > > > > > Suggestions
>> > >>> > > > > > > Might want to make this searchable and pop FAQ on the
>> main
>> > >>> > > > > > > page (or somewhere prominent)
>> > >>> > > > > > >
>> > >>> > > > > > > Thanks,
>> > >>> > > > > > > Chai
>> > >>> > > > > > >
>> > >>> > > > > > >
>> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
>> > >>> > > ptrendx@apache.org>
>> > >>> > > > > > > wrote:
>> > >>> > > > > > >
>> > >>> > > > > > > > There seems to be a problem with (at least Python, did
>> > not
>> > >>> > > > > > > > check
>> > >>> > > > > > others)
>> > >>> > > > > > > > APIs. For example this page:
>> > >>> > > > > > > >
>> > >>> > > > > > > >
>> > >>> > > > > > >
>> > >>> > > > > >
>> > >>> > > > >
>> > >>> > > >
>> > >>> > >
>> > >>> >
>> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
>> > >>> > > /mxnet.symbol.Symbol.argmax.html
>> > >>> > > > > > > >
>> > >>> > > > > > > > says that it is a convenience method for argmax (with
>> a
>> > >>> > > > > > > > link),
>> > >>> > > but
>> > >>> > > > > > > > clicking that link just points to the same website
>> (and
>> > so
>> > >>> > > > > > > > user
>> > >>> > > has
>> > >>> > > > > no
>> > >>> > > > > > > way
>> > >>> > > > > > > > of getting to the docs of the actual operator).
>> > >>> > > > > > > >
>> > >>> > > > > > > > When I tried to manually remove Symbol from the URL to
>> > get
>> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
>> webpage
>> > >>> > > > > > > > which I
>> > >>> > > guess
>> > >>> > > > > > also
>> > >>> > > > > > > > should not happen (ignoring the fact that this should
>> > >>> exist,
>> > >>> > > going
>> > >>> > > > to
>> > >>> > > > > > > > random URL under the website should redirect to the
>> main
>> > >>> > > > > > > > page I
>> > >>> > > > > think).
>> > >>> > > > > > > >
>> > >>> > > > > > > > Przemek
>> > >>> > > > > > > >
>> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <apeforest@gmail.com
>> >
>> > >>> wrote:
>> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
>> > >>> > > > > > > > > launching
>> > >>> > > > > this!
>> > >>> > > > > > > > >
>> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
>> > >>> > > > carinmeier@gmail.com>
>> > >>> > > > > > > > wrote:
>> > >>> > > > > > > > >
>> > >>> > > > > > > > > > Nice!!! Congrats everyone!
>> > >>> > > > > > > > > >
>> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
>> > >>> > > > > > > > aaron.s.markham@gmail.com>
>> > >>> > > > > > > > > > wrote:
>> > >>> > > > > > > > > >
>> > >>> > > > > > > > > > > Alrighty! The new site is launched. You might
>> need
>> > to
>> > >>> > > > > > > > > > > clear
>> > >>> > > > > your
>> > >>> > > > > > > > cache.
>> > >>> > > > > > > > > > >
>> > >>> > > > > > > > > > > Cheers,
>> > >>> > > > > > > > > > > Aaron
>> > >>> > > > > > > > > > >
>> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
>> > >>> > > > > > > > aaron.s.markham@gmail.com
>> > >>> > > > > > > > > > >
>> > >>> > > > > > > > > > > wrote:
>> > >>> > > > > > > > > > > >
>> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
>> > >>> > > > > > > > > > > > continue
>> > >>> > > > > holding
>> > >>> > > > > > > > off on
>> > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
>> > objections,
>> > >>> > > > > > > > > > > > I'd
>> > >>> > > > like
>> > >>> > > > > to
>> > >>> > > > > > > > launch
>> > >>> > > > > > > > > > > > the new website today.
>> > >>> > > > > > > > > > > >
>> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham
>> <
>> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
>> > >>> > > > > > > > > > > wrote:
>> > >>> > > > > > > > > > > > >
>> > >>> > > > > > > > > > > > > Hi everyone,
>> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new website
>> and
>> > >>> > > > > > > > > > > > > docs
>> > >>> > > have
>> > >>> > > > > > > passed
>> > >>> > > > > > > > CI
>> > >>> > > > > > > > > > > > > (finally). Please do not make changes to
>> /docs
>> > or
>> > >>> > > > > > > > > > > > > /ci
>> > >>> > > > until
>> > >>> > > > > > we
>> > >>> > > > > > > > get
>> > >>> > > > > > > > > > > > > these approved and merged. Every time
>> there's a
>> > >>> > > > > > > > > > > > > merge
>> > >>> > > > > > conflict
>> > >>> > > > > > > > it has
>> > >>> > > > > > > > > > > > > set us back a day or two while shepherding
>> the
>> > >>> PRs
>> > >>> > > > through
>> > >>> > > > > CI
>> > >>> > > > > > > > again.
>> > >>> > > > > > > > > > > > > Unless there are catastrophic issues
>> discovered
>> > >>> in
>> > >>> > > > > > > > > > > > > a
>> > >>> > > > > review,
>> > >>> > > > > > I
>> > >>> > > > > > > > > > > > > recommend that we hold any patches or
>> updates
>> > to
>> > >>> > > > > > > > > > > > > the
>> > >>> > > PRs
>> > >>> > > > to
>> > >>> > > > > > > > follow-up
>> > >>> > > > > > > > > > > > > PRs.
>> > >>> > > > > > > > > > > > >
>> > >>> > > > > > > > > > > > > There are four steps to launch:
>> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
>> > >>> merge
>> > >>> > > 15885
>> > >>> > > > to
>> > >>> > > > > > > > delete
>> > >>> > > > > > > > > > the
>> > >>> > > > > > > > > > > > > old content first.
>> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in
>> the
>> > new
>> > >>> > > > > > > > > > > > > CI
>> > >>> > > > flows
>> > >>> > > > > > and
>> > >>> > > > > > > > > > updates
>> > >>> > > > > > > > > > > > > to the content Thomas and I have already had
>> > >>> > > > > > > > > > > > > merged in
>> > >>> > > > > 15884
>> > >>> > > > > > > [3].
>> > >>> > > > > > > > > > > > > 3. I will change the website validation
>> Jenkins
>> > >>> > > pipeline
>> > >>> > > > to
>> > >>> > > > > > > > point to
>> > >>> > > > > > > > > > > > > the new pipeline.
>> > >>> > > > > > > > > > > > > 4. I will change the website publishing
>> Jenkins
>> > >>> > > pipeline
>> > >>> > > > to
>> > >>> > > > > > > > point to
>> > >>> > > > > > > > > > > > > its new pipeline as well. Once triggered,
>> the
>> > old
>> > >>> > > > > > > > > > > > > site
>> > >>> > > > will
>> > >>> > > > > > be
>> > >>> > > > > > > > > > > > > replaced with the new one.
>> > >>> > > > > > > > > > > > >
>> > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
>> > >>> > > > beta.mxnet.io
>> > >>> > > > > > to
>> > >>> > > > > > > > point
>> > >>> > > > > > > > > > to
>> > >>> > > > > > > > > > > > > production, and there will likely be some
>> > >>> > > > > redirect/.htaccess
>> > >>> > > > > > > > updates
>> > >>> > > > > > > > > > > > > needed next week to assist with any deep
>> > linking
>> > >>> > > > > > > > > > > > > and
>> > >>> > > 404
>> > >>> > > > > > issues
>> > >>> > > > > > > > that
>> > >>> > > > > > > > > > > > > pop up.
>> > >>> > > > > > > > > > > > >
>> > >>> > > > > > > > > > > > > Cheers,
>> > >>> > > > > > > > > > > > > Aaron
>> > >>> > > > > > > > > > > > >
>> > >>> > > > > > > > > > > > > [1]
>> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
>> > >>> > > > > > > > > > > > > [2]
>> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
>> > >>> > > > > > > > > > > > > [3]
>> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
>> > >>> > > > > > > > > > >
>> > >>> > > > > > > > > >
>> > >>> > > > > > > > >
>> > >>> > > > > > > >
>> > >>> > > > > > >
>> > >>> > > > > > >
>> > >>> > > > > > > --
>> > >>> > > > > > > *Chaitanya Prakash Bapat*
>> > >>> > > > > > > *+1 (973) 953-6299*
>> > >>> > > > > > >
>> > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
>> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
>> > >>> > > > > > https://www.facebook.com/chaibapat
>> > >>> > > > > > > ]
>> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
>> > >>> > > > > > > https://twitter.com/ChaiBapchya]
>> > >>> > > > > > ><https://twitter.com/ChaiBapchya
>> > >>> > > > > > >[image:
>> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
>> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
>> > >>> > > > > > >
>> > >>> > > > > >
>> > >>> > > > >
>> > >>> > > >
>> > >>> > >
>> > >>>
>> > >>
>> >
>>
>

Re: new website, docs code freeze

[Aaron Markham <aa...@gmail.com>]

Good observations...
@Zhi - added the feature request:
https://github.com/apache/incubator-mxnet/issues/16323 I really think
the site needs a commercial-grade search indexing service to deal with
all of the microsites and the duplicate content that happens to be API
specific. Too often, I saw Sphinx search results that just listed the
method a hundred times without any context so you'd have to mouseover
the link to see if was going to take you to the right place.
@Anirudh - added the issue:
https://github.com/apache/incubator-mxnet/issues/16322

On Fri, Sep 27, 2019 at 3:49 PM Joshua Z. Zhang <ch...@gmail.com> wrote:
>
> I’ve heard existing users are in general happy with the new site’s modern appearance.
>
> The biggest issue is that the search bar is now hidden way too deep in the python api page, where only experienced users can locate. We might need a search button on the navbar.
>
> Best,
> Zhi
>
> > On Sep 26, 2019, at 9:24 AM, Anirudh Acharya <an...@gmail.com> wrote:
> >
> > Hi,
> >
> > In the operator tutorial(
> > http://mxnet.incubator.apache.org/api/faq/add_op_in_backend), there are
> > sections which do not render properly, for example - forward function,
> > backward function and shape inference.
> >
> >
> > Thanks
> > Anirudh
> >
> >
> >
> >
> > On Wed, Sep 25, 2019 at 7:53 AM Aaron Markham <aa...@gmail.com>
> > wrote:
> >
> >> I'm seeing GA code is -1 not -11 in the analytics admin console. 11
> >> was for beta.mxnet.io.
> >> Either way, the Jekyll prod config file was missing the GA code, so I
> >> added it with this PR:
> >> https://github.com/apache/incubator-mxnet/pull/16271
> >>
> >> Reindexing of the site is being tracked here:
> >> https://issues.apache.org/jira/browse/INFRA-19144
> >>
> >> .htaccess testing was hampered by it not working on staging. This was
> >> tracked here, and it looks like infra just patched staging so we can
> >> resume redirect testing:
> >> https://issues.apache.org/jira/browse/INFRA-19075
> >> I have a CI pipeline for beta testing. If anyone wants to contribute
> >> to working on the redirects, you can use this pipeline to publish to
> >> the beta staging site.
> >> http://jenkins.mxnet-ci.amazon-ml.com/job/restricted-website-publish-beta/
> >> I've distilled this information in this issue:
> >> https://github.com/apache/incubator-mxnet/issues/16273
> >> I'd much rather have another contributor work on this since it will
> >> teach testing changes on the website, testing CI deployments to
> >> staging using your fork, previewing on staging, and finally deploying
> >> it to prod. I'm happy to help & guide along the way.
> >>
> >> (echoing Thomas) Please be sure to raise new issues in the repo, so we
> >> don't lose them in this thread. Also, more people can work on them. It
> >> would great if others can jump in and get familiar with the new site
> >> and start contributing patches.
> >>
> >> Cheers,
> >> Aaron
> >>
> >> On Wed, Sep 25, 2019 at 3:15 AM Thomas DELTEIL
> >> <th...@gmail.com> wrote:
> >>>
> >>> @Philip Yes we're looking at link redirects for older links that might be
> >>> hosted externally (using htaccess is my preferred way to handle it for
> >> now
> >>> as you sugested) and we'll use a broken link checker to update the links
> >>> that are hosted internally. We'll update the 404 to add an explanation on
> >>> the website update. Google indexes will slowly update across the week so
> >>> the google search issues will be less of a problem.
> >>>
> >>> If you find any such links yourself, or missing tutorials, please
> >> consider
> >>> stepping up and helping fixing them. The more people get familiar with
> >> the
> >>> new website architecture, the least likely it is to fall in a state of
> >>> stalled updates like the previous one.
> >>>
> >>> For the sphinx issues in the python mini-website, missing API classes, if
> >>> anybody is familiar with it, I'd love for us to bring back the automatic
> >>> doc generation for each package so at least we have a list of all
> >> available
> >>> classes in each sub package rather than relying on manual insertion of
> >> each
> >>> class, which is brittle and not future proof. @Lin, Haibin
> >>> <ha...@amazon.com> if you have experience with it, could we sync up
> >>> offline on how you suggest to do that based on your gluon-nlp experience?
> >>>
> >>> @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO
> >> in
> >>> Europe, I'll try make time today to help with the fixes since it is
> >>> impacting a lot of users.
> >>>
> >>> In the meanwhile, any help is appreciated, and more than the value of the
> >>> fixes, let me repeat that there is tremendous value in having more people
> >>> familiar with the website build pipelines. Aaron is the main owner for
> >> the
> >>> docs but he is already super busy with all his other responsibilities.
> >> I'm
> >>> available to help if anybody is stuck. I believe Aaron has updated the
> >>> READMEs on how to test the websites locally, if they're not clear, feel
> >>> free to contribute your own explanations or ask for help directly to me
> >> by
> >>> email or on the discuss forum.
> >>>
> >>> Good hunting!
> >>>
> >>> Thomas
> >>>
> >>>
> >>>
> >>> Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com>
> >> a
> >>> écrit :
> >>>
> >>>> Good catch, Mu! Also good idea, Philip!
> >>>>
> >>>> Aaron and Thomas, are you going to work on this?
> >>>>
> >>>> -Marco
> >>>>
> >>>> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> >>>>
> >>>>> The questions I found are:
> >>>>>
> >>>>> 1. Not ever page contains, especially the homepage
> >>>>>
> >>>>>
> >>>>
> >> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> >>>>> 2. The correct tracking id is UA-96378503-1 instead of
> >> UA-96378503-11 in
> >>>>>
> >>>>>
> >>>>
> >> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> >>>>>
> >>>>> On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> >>>>>
> >>>>>> I think the reason is that the google tracker is not included in
> >> the
> >>>> new
> >>>>>> website.
> >>>>>>
> >>>>>> On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> >>>> marco.g.abreu@gmail.com>
> >>>>>> wrote:
> >>>>>>
> >>>>>>> Hello,
> >>>>>>>
> >>>>>>> I checked the Google Analytics statistics and the launch of the
> >> new
> >>>>>>> website reduced the traffic by over 80%:
> >>>>>>>
> >>>>>>> [image: image.png]
> >>>>>>>
> >>>>>>> (Please let me know if the image is not visible)
> >>>>>>>
> >>>>>>> How shall we handle this?
> >>>>>>>
> >>>>>>> Best regards,
> >>>>>>> Marco
> >>>>>>>
> >>>>>>> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> >> patric.zhao@intel.com>
> >>>>>>> wrote:
> >>>>>>>
> >>>>>>>> For the install page [1], I suggest to add the selection of
> >> backend
> >>>>>>>> DeepNumpy [2] which will be more clean.
> >>>>>>>>
> >>>>>>>> [1] http://mxnet.incubator.apache.org/index.html
> >>>>>>>> [2] https://numpy.mxnet.io/#installation
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>
> >>>>>>>>> -----Original Message-----
> >>>>>>>>> From: kellen sunderland <ke...@gmail.com>
> >>>>>>>>> Sent: Monday, September 23, 2019 12:47 PM
> >>>>>>>>> To: dev@mxnet.incubator.apache.org
> >>>>>>>>> Subject: Re: new website, docs code freeze
> >>>>>>>>>
> >>>>>>>>> New site looks good.  I do notice that a few tutorials from
> >> the old
> >>>>>>>> site are
> >>>>>>>>> missing (for example the TensorRT tutorial).  Any plans to
> >> bring
> >>>> them
> >>>>>>>> back?
> >>>>>>>>>
> >>>>>>>>> On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> >>>>> haibin.lin.aws@gmail.com>
> >>>>>>>>> wrote:
> >>>>>>>>>
> >>>>>>>>>> Another issue I found with the current website: the Sphinx
> >> object
> >>>>>>>>>> inventory
> >>>>>>>>>> <https://www.sphinx-
> >>>>>>>>> doc.org/en/master/usage/extensions/intersphinx.htm
> >>>>>>>>>> l> file https://mxnet.apache.org/objects.inv is missing.
> >>>> GluonNLP
> >>>>>>>>>> relies on this file to link document across projects. Shall
> >> we
> >>>> add
> >>>>> it
> >>>>>>>>>> back?
> >>>>>>>>>>
> >>>>>>>>>> Best,
> >>>>>>>>>> Haibin
> >>>>>>>>>>
> >>>>>>>>>> On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> >> lgo@mobsol.be>
> >>>>>>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>>> Hi,
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>> On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> >>>>>>>>>>> <th...@gmail.com>
> >>>>>>>>>>> wrote:
> >>>>>>>>>>>
> >>>>>>>>>>>> Thanks all for the feedback,
> >>>>>>>>>>>>
> >>>>>>>>>>>> We'll send an email next week with the list of missing
> >>>>> features,
> >>>>>>>>>> content
> >>>>>>>>>>>> and bugs that we plan to fix.
> >>>>>>>>>>>> We took the option of releasing early, with some features
> >>>>>>>> missing,
> >>>>>>>>>> rather
> >>>>>>>>>>>> than trying to be at feature parity with the old website
> >>>> before
> >>>>>>>>>> launching
> >>>>>>>>>>>> the website.
> >>>>>>>>>>>> The reason why we decided to do that is two-fold:
> >>>>>>>>>>>> - playing catch-up with docs in master introduce daily
> >>>>> conflicts
> >>>>>>>>>>>> that
> >>>>>>>>>>> need
> >>>>>>>>>>>> to be resolved and introduce opportunity for errors
> >>>>>>>>>>>> - by releasing early, we can take advantage of the
> >> community
> >>>>>>>>>>> contributions
> >>>>>>>>>>>> in modifying whatever the community feels like a better
> >> way
> >>>> of
> >>>>>>>>>>>> doing things.
> >>>>>>>>>>>>
> >>>>>>>>>>>> One of the goals of the new website was to disentangle
> >> the
> >>>> main
> >>>>>>>>>> website,
> >>>>>>>>>>>> now called "static_site" to the auto-generated docs. Now
> >> the
> >>>>>>>>>>>> overall
> >>>>>>>>>> site
> >>>>>>>>>>>> is made of a main static site, with easy to modify
> >> content
> >>>> and
> >>>>>>>>>>>> easy to understand architecture for anybody familiar with
> >>>> basic
> >>>>>>>>>>>> html, and a collection of mini-websites for each language
> >>>>>>>> bindings
> >>>>>>>>>>>> that can be
> >>>>>>>>>> built
> >>>>>>>>>>> in
> >>>>>>>>>>>> isolation and that are self-contained. Actually the new
> >> CI
> >>>> jobs
> >>>>>>>>>>>> builds
> >>>>>>>>>>> all
> >>>>>>>>>>>> of them in parallel independently.
> >>>>>>>>>>>>
> >>>>>>>>>>>> There is PLENTY of room for improvement, it would be
> >> great if
> >>>>> the
> >>>>>>>>>>> community
> >>>>>>>>>>>> can help contribute to bring the new website at the same
> >>>> level
> >>>>> of
> >>>>>>>>>> content
> >>>>>>>>>>>> richness as the old one, and then even further.
> >>>>>>>>>>>>
> >>>>>>>>>>>> Missing features:
> >>>>>>>>>>>> - As pointed by Haibin, the API docs do not have the full
> >>>> list
> >>>>> of
> >>>>>>>>>>> operators
> >>>>>>>>>>>> and classes. There is a mix of auto-generated docs based
> >> on
> >>>>>>>>>>>> packages,
> >>>>>>>>>> and
> >>>>>>>>>>>> some docs that are spelled out manually to improve the
> >>>> logical
> >>>>>>>>>>> organization
> >>>>>>>>>>>> of the package where there is a need. The drawback with
> >>>>> manually
> >>>>>>>>>>>> listed classes in a package is that it's very easy to
> >> miss
> >>>>> some.
> >>>>>>>>>>>> If someone
> >>>>>>>>>>> wanted
> >>>>>>>>>>>> to build a sanity check that would automatically detect
> >> which
> >>>>>>>>>>>> classes
> >>>>>>>>>> are
> >>>>>>>>>>>> not in the documentation, or if someone knew how to
> >> enable
> >>>> that
> >>>>>>>>>>>> with sphinx, that would be a great addition to the python
> >>>> docs
> >>>>>>>>>>>> - There is missing content in the python tutorials, and
> >> the
> >>>>>>>>>>> discoverability
> >>>>>>>>>>>> could be improved. Some old tutorials have not been
> >> migrated
> >>>>>>>> just yet.
> >>>>>>>>>>>> - The nightly tests on tutorials have been disabled for
> >> now
> >>>>>>>>>>>> - There is no "Download jupyter notebook" for tutorials
> >> just
> >>>>> yet.
> >>>>>>>>>>>> - Non-python tutorials might benefit from a blurb
> >> description
> >>>>> and
> >>>>>>>>>>>> a
> >>>>>>>>>>> better
> >>>>>>>>>>>> content organization.
> >>>>>>>>>>>> - Python tutorials could be better organized, have a
> >> picture
> >>>>>>>>>> accompanying
> >>>>>>>>>>>> their description
> >>>>>>>>>>>> - There is no site-wide search, this is not an easy
> >> problem
> >>>> to
> >>>>>>>>>>>> solve to
> >>>>>>>>>>> be
> >>>>>>>>>>>> fair given the static nature of the website, but maybe an
> >>>>>>>> external
> >>>>>>>>>> plugin
> >>>>>>>>>>>> might be able to give a half-way solution
> >>>>>>>>>>>> - There is no version selector for the docs
> >>>>>>>>>>>> - There is bug in search box of the python docs, but
> >> this is
> >>>>> just
> >>>>>>>>>>>> a
> >>>>>>>>>> small
> >>>>>>>>>>>> JS bug that can be fixed easily (on my list for next
> >> week)
> >>>>>>>>>>>> - Most old links have not had a redirect put in place.
> >>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>> I noticed on the Ubuntu home page in the Developer dropdown
> >>>> that
> >>>>>>>> the
> >>>>>>>>>>> link MXNet on Ubuntu
> >>>>>>>>>>> <https://mxnet.incubator.apache.org/install/index.html
> >>>>>>>>>>>> with
> >>>>>>>>>>> Nvidia
> >>>>>>>>>>> <
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>
> >>>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> >>>>>>>>>> mxnet/
> >>>>>>>>>>>>
> >>>>>>>>>>> doesn't work anymore, it points to:
> >>>>>>>>>>> https://mxnet.incubator.apache.org/install/index.html
> >>>>>>>>>>>
> >>>>>>>>>>> Also, on the MXNet 'getting started' page
> >>>>>>>>>>> https://mxnet.incubator.apache.org/get_started , the link
> >>>>> "Ubuntu
> >>>>>>>>>>> Installation Guide" at the bottom doesn't work either, it
> >>>> points
> >>>>>>>> to:
> >>>>>>>>>>> https://mxnet.incubator.apache.org/ubuntu_setup.html
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>> I suggest you do a scan of the new website to find these
> >>>> dangling
> >>>>>>>> links.
> >>>>>>>>>>>
> >>>>>>>>>>> regards,
> >>>>>>>>>>>
> >>>>>>>>>>> Lieven
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>>> We'll formalize this in github issues next week, but
> >> they are
> >>>>> all
> >>>>>>>>>> fairly
> >>>>>>>>>>>> small and helping out on these would be a great way of
> >>>>>>>>>>>> familiarizing yourself with the new website build system
> >> and
> >>>>>>>> website
> >>>>>>>>> architecture.
> >>>>>>>>>>>>
> >>>>>>>>>>>> Thanks all for the feedback, please keep it coming!
> >>>>>>>>>>>>
> >>>>>>>>>>>> Thomas Delteil
> >>>>>>>>>>>>
> >>>>>>>>>>>> Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> >>>>>>>>>>>> <ha...@gmail.com> a écrit :
> >>>>>>>>>>>>
> >>>>>>>>>>>>> It looks like my previous email did not go through.
> >>>>> Re-sending:
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> Hi Aaron,
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> The website looks cool. Thanks for pushing this to
> >>>>> production.
> >>>>>>>> A
> >>>>>>>>>>>>> few
> >>>>>>>>>>>>> questions:
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> - I was looking for the API doc for mx.sym.dot, but I
> >> find
> >>>>> that
> >>>>>>>>>>>>> most operators under mx.sym.* are missing. Is this
> >>>> expected?
> >>>>>>>>>>>>> - I was also checking the search functionality,
> >> searching
> >>>> the
> >>>>>>>>>>>>> keyword "ndarray" only returns one result
> >>>>>>>>>>>>> "mxnet.ndarray.NDArray", which
> >>>>>>>>>>> doesn't
> >>>>>>>>>>>>> seem right. There animation keeps going (Searching. ->
> >>>>>>>>>>>>> Searching.. -> Searching ...) and gives me an
> >> impression
> >>>> that
> >>>>>>>>>>>>> the search is never completely done(?).
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> Best,
> >>>>>>>>>>>>> Haibin
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>> On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> >>>>>>>>>> chai.bapat@gmail.com>
> >>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>
> >>>>>>>>>>>>>> Thanks Aaron and the team for launching new website!
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> 1. There's no search button anywhere on the landing
> >> page.
> >>>>>>>>>>>>>> 2. I wasn't able to find FAQ (and without search
> >> button I
> >>>>>>>> dont
> >>>>>>>>>>>>>> have
> >>>>>>>>>>>>> option
> >>>>>>>>>>>>>> but to go manually on each menu). Only when I go to
> >>>>>>>>>>>>>> Docs&Tutorials
> >>>>>>>>>> ->
> >>>>>>>>>>>> FAQ
> >>>>>>>>>>>>>> -> Extend and Cotribute (that I got what I wanted).
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> Suggestions
> >>>>>>>>>>>>>> Might want to make this searchable and pop FAQ on the
> >>>> main
> >>>>>>>>>>>>>> page (or somewhere prominent)
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> Thanks,
> >>>>>>>>>>>>>> Chai
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> >>>>>>>>>> ptrendx@apache.org>
> >>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> There seems to be a problem with (at least Python,
> >> did
> >>>>> not
> >>>>>>>>>>>>>>> check
> >>>>>>>>>>>>> others)
> >>>>>>>>>>>>>>> APIs. For example this page:
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>
> >> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> >>>>>>>>>> /mxnet.symbol.Symbol.argmax.html
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> says that it is a convenience method for argmax
> >> (with a
> >>>>>>>>>>>>>>> link),
> >>>>>>>>>> but
> >>>>>>>>>>>>>>> clicking that link just points to the same website
> >> (and
> >>>>> so
> >>>>>>>>>>>>>>> user
> >>>>>>>>>> has
> >>>>>>>>>>>> no
> >>>>>>>>>>>>>> way
> >>>>>>>>>>>>>>> of getting to the docs of the actual operator).
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> When I tried to manually remove Symbol from the
> >> URL to
> >>>>> get
> >>>>>>>>>>>>>>> to mxnet.symbol.argmax.html, I got a "Not found"
> >>>> webpage
> >>>>>>>>>>>>>>> which I
> >>>>>>>>>> guess
> >>>>>>>>>>>>> also
> >>>>>>>>>>>>>>> should not happen (ignoring the fact that this
> >> should
> >>>>>>>> exist,
> >>>>>>>>>> going
> >>>>>>>>>>> to
> >>>>>>>>>>>>>>> random URL under the website should redirect to the
> >>>> main
> >>>>>>>>>>>>>>> page I
> >>>>>>>>>>>> think).
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> Przemek
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>> On 2019/09/20 16:41:28, Lin Yuan <
> >> apeforest@gmail.com>
> >>>>>>>> wrote:
> >>>>>>>>>>>>>>>> Looks very neat. Thank you Aaron and many others
> >> for
> >>>>>>>>>>>>>>>> launching
> >>>>>>>>>>>> this!
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>> On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> >>>>>>>>>>> carinmeier@gmail.com>
> >>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> Nice!!! Congrats everyone!
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>> On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham
> >> <
> >>>>>>>>>>>>>>> aaron.s.markham@gmail.com>
> >>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>> Alrighty! The new site is launched. You might
> >>>> need
> >>>>> to
> >>>>>>>>>>>>>>>>>> clear
> >>>>>>>>>>>> your
> >>>>>>>>>>>>>>> cache.
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>> Cheers,
> >>>>>>>>>>>>>>>>>> Aaron
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>> On Thu, Sep 19, 2019 at 3:33 PM Aaron
> >> Markham <
> >>>>>>>>>>>>>>> aaron.s.markham@gmail.com
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> Thanks everyone. The PRs passed CI, but
> >> please
> >>>>>>>>>>>>>>>>>>> continue
> >>>>>>>>>>>> holding
> >>>>>>>>>>>>>>> off on
> >>>>>>>>>>>>>>>>>>> docs and CI edits. Unless there are any
> >>>>> objections,
> >>>>>>>>>>>>>>>>>>> I'd
> >>>>>>>>>>> like
> >>>>>>>>>>>> to
> >>>>>>>>>>>>>>> launch
> >>>>>>>>>>>>>>>>>>> the new website today.
> >>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>> On Wed, Sep 18, 2019 at 7:46 AM Aaron
> >> Markham <
> >>>>>>>>>>>>>>>>> aaron.s.markham@gmail.com>
> >>>>>>>>>>>>>>>>>> wrote:
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Hi everyone,
> >>>>>>>>>>>>>>>>>>>> The last two PRs [1][2] for the new
> >> website
> >>>> and
> >>>>>>>>>>>>>>>>>>>> docs
> >>>>>>>>>> have
> >>>>>>>>>>>>>> passed
> >>>>>>>>>>>>>>> CI
> >>>>>>>>>>>>>>>>>>>> (finally). Please do not make changes to
> >>>> /docs
> >>>>> or
> >>>>>>>>>>>>>>>>>>>> /ci
> >>>>>>>>>>> until
> >>>>>>>>>>>>> we
> >>>>>>>>>>>>>>> get
> >>>>>>>>>>>>>>>>>>>> these approved and merged. Every time
> >>>> there's a
> >>>>>>>>>>>>>>>>>>>> merge
> >>>>>>>>>>>>> conflict
> >>>>>>>>>>>>>>> it has
> >>>>>>>>>>>>>>>>>>>> set us back a day or two while
> >> shepherding
> >>>> the
> >>>>>>>> PRs
> >>>>>>>>>>> through
> >>>>>>>>>>>> CI
> >>>>>>>>>>>>>>> again.
> >>>>>>>>>>>>>>>>>>>> Unless there are catastrophic issues
> >>>> discovered
> >>>>>>>> in
> >>>>>>>>>>>>>>>>>>>> a
> >>>>>>>>>>>> review,
> >>>>>>>>>>>>> I
> >>>>>>>>>>>>>>>>>>>> recommend that we hold any patches or
> >> updates
> >>>>> to
> >>>>>>>>>>>>>>>>>>>> the
> >>>>>>>>>> PRs
> >>>>>>>>>>> to
> >>>>>>>>>>>>>>> follow-up
> >>>>>>>>>>>>>>>>>>>> PRs.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> There are four steps to launch:
> >>>>>>>>>>>>>>>>>>>> 1. Once the PRs are approved, the plan
> >> is to
> >>>>>>>> merge
> >>>>>>>>>> 15885
> >>>>>>>>>>> to
> >>>>>>>>>>>>>>> delete
> >>>>>>>>>>>>>>>>> the
> >>>>>>>>>>>>>>>>>>>> old content first.
> >>>>>>>>>>>>>>>>>>>> 2. Then immediately merge 15883 to add
> >> in the
> >>>>> new
> >>>>>>>>>>>>>>>>>>>> CI
> >>>>>>>>>>> flows
> >>>>>>>>>>>>> and
> >>>>>>>>>>>>>>>>> updates
> >>>>>>>>>>>>>>>>>>>> to the content Thomas and I have already
> >> had
> >>>>>>>>>>>>>>>>>>>> merged in
> >>>>>>>>>>>> 15884
> >>>>>>>>>>>>>> [3].
> >>>>>>>>>>>>>>>>>>>> 3. I will change the website validation
> >>>> Jenkins
> >>>>>>>>>> pipeline
> >>>>>>>>>>> to
> >>>>>>>>>>>>>>> point to
> >>>>>>>>>>>>>>>>>>>> the new pipeline.
> >>>>>>>>>>>>>>>>>>>> 4. I will change the website publishing
> >>>> Jenkins
> >>>>>>>>>> pipeline
> >>>>>>>>>>> to
> >>>>>>>>>>>>>>> point to
> >>>>>>>>>>>>>>>>>>>> its new pipeline as well. Once
> >> triggered, the
> >>>>> old
> >>>>>>>>>>>>>>>>>>>> site
> >>>>>>>>>>> will
> >>>>>>>>>>>>> be
> >>>>>>>>>>>>>>>>>>>> replaced with the new one.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Post launch we'll need to update the DNS
> >> for
> >>>>>>>>>>> beta.mxnet.io
> >>>>>>>>>>>>> to
> >>>>>>>>>>>>>>> point
> >>>>>>>>>>>>>>>>> to
> >>>>>>>>>>>>>>>>>>>> production, and there will likely be some
> >>>>>>>>>>>> redirect/.htaccess
> >>>>>>>>>>>>>>> updates
> >>>>>>>>>>>>>>>>>>>> needed next week to assist with any deep
> >>>>> linking
> >>>>>>>>>>>>>>>>>>>> and
> >>>>>>>>>> 404
> >>>>>>>>>>>>> issues
> >>>>>>>>>>>>>>> that
> >>>>>>>>>>>>>>>>>>>> pop up.
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> Cheers,
> >>>>>>>>>>>>>>>>>>>> Aaron
> >>>>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>>>> [1]
> >>>>>>>>>> https://github.com/apache/incubator-mxnet/pull/15885
> >>>>>>>>>>>>>>>>>>>> [2]
> >>>>>>>>>> https://github.com/apache/incubator-mxnet/pull/15883
> >>>>>>>>>>>>>>>>>>>> [3]
> >>>>>>>>>> https://github.com/apache/incubator-mxnet/pull/15884
> >>>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> --
> >>>>>>>>>>>>>> *Chaitanya Prakash Bapat*
> >>>>>>>>>>>>>> *+1 (973) 953-6299*
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>> [image: https://www.linkedin.com//in/chaibapat25]
> >>>>>>>>>>>>>> <https://github.com/ChaiBapchya>[image:
> >>>>>>>>>>>>> https://www.facebook.com/chaibapat
> >>>>>>>>>>>>>> ]
> >>>>>>>>>>>>>> <https://www.facebook.com/chaibapchya>[image:
> >>>>>>>>>>>>>> https://twitter.com/ChaiBapchya]
> >>>>>>>>>>>>>> <https://twitter.com/ChaiBapchya
> >>>>>>>>>>>>>> [image:
> >>>>>>>>>>>>>> https://www.linkedin.com//in/chaibapat25]
> >>>>>>>>>>>>>> <https://www.linkedin.com//in/chaibapchya/>
> >>>>>>>>>>>>>>
> >>>>>>>>>>>>>
> >>>>>>>>>>>>
> >>>>>>>>>>>
> >>>>>>>>>>
> >>>>>>>>
> >>>>>>>
> >>>>>
> >>>>
> >>
>

Re: new website, docs code freeze

["Joshua Z. Zhang" <ch...@gmail.com>]

I’ve heard existing users are in general happy with the new site’s modern appearance.

The biggest issue is that the search bar is now hidden way too deep in the python api page, where only experienced users can locate. We might need a search button on the navbar.

Best,
Zhi

> On Sep 26, 2019, at 9:24 AM, Anirudh Acharya <an...@gmail.com> wrote:
> 
> Hi,
> 
> In the operator tutorial(
> http://mxnet.incubator.apache.org/api/faq/add_op_in_backend), there are
> sections which do not render properly, for example - forward function,
> backward function and shape inference.
> 
> 
> Thanks
> Anirudh
> 
> 
> 
> 
> On Wed, Sep 25, 2019 at 7:53 AM Aaron Markham <aa...@gmail.com>
> wrote:
> 
>> I'm seeing GA code is -1 not -11 in the analytics admin console. 11
>> was for beta.mxnet.io.
>> Either way, the Jekyll prod config file was missing the GA code, so I
>> added it with this PR:
>> https://github.com/apache/incubator-mxnet/pull/16271
>> 
>> Reindexing of the site is being tracked here:
>> https://issues.apache.org/jira/browse/INFRA-19144
>> 
>> .htaccess testing was hampered by it not working on staging. This was
>> tracked here, and it looks like infra just patched staging so we can
>> resume redirect testing:
>> https://issues.apache.org/jira/browse/INFRA-19075
>> I have a CI pipeline for beta testing. If anyone wants to contribute
>> to working on the redirects, you can use this pipeline to publish to
>> the beta staging site.
>> http://jenkins.mxnet-ci.amazon-ml.com/job/restricted-website-publish-beta/
>> I've distilled this information in this issue:
>> https://github.com/apache/incubator-mxnet/issues/16273
>> I'd much rather have another contributor work on this since it will
>> teach testing changes on the website, testing CI deployments to
>> staging using your fork, previewing on staging, and finally deploying
>> it to prod. I'm happy to help & guide along the way.
>> 
>> (echoing Thomas) Please be sure to raise new issues in the repo, so we
>> don't lose them in this thread. Also, more people can work on them. It
>> would great if others can jump in and get familiar with the new site
>> and start contributing patches.
>> 
>> Cheers,
>> Aaron
>> 
>> On Wed, Sep 25, 2019 at 3:15 AM Thomas DELTEIL
>> <th...@gmail.com> wrote:
>>> 
>>> @Philip Yes we're looking at link redirects for older links that might be
>>> hosted externally (using htaccess is my preferred way to handle it for
>> now
>>> as you sugested) and we'll use a broken link checker to update the links
>>> that are hosted internally. We'll update the 404 to add an explanation on
>>> the website update. Google indexes will slowly update across the week so
>>> the google search issues will be less of a problem.
>>> 
>>> If you find any such links yourself, or missing tutorials, please
>> consider
>>> stepping up and helping fixing them. The more people get familiar with
>> the
>>> new website architecture, the least likely it is to fall in a state of
>>> stalled updates like the previous one.
>>> 
>>> For the sphinx issues in the python mini-website, missing API classes, if
>>> anybody is familiar with it, I'd love for us to bring back the automatic
>>> doc generation for each package so at least we have a list of all
>> available
>>> classes in each sub package rather than relying on manual insertion of
>> each
>>> class, which is brittle and not future proof. @Lin, Haibin
>>> <ha...@amazon.com> if you have experience with it, could we sync up
>>> offline on how you suggest to do that based on your gluon-nlp experience?
>>> 
>>> @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO
>> in
>>> Europe, I'll try make time today to help with the fixes since it is
>>> impacting a lot of users.
>>> 
>>> In the meanwhile, any help is appreciated, and more than the value of the
>>> fixes, let me repeat that there is tremendous value in having more people
>>> familiar with the website build pipelines. Aaron is the main owner for
>> the
>>> docs but he is already super busy with all his other responsibilities.
>> I'm
>>> available to help if anybody is stuck. I believe Aaron has updated the
>>> READMEs on how to test the websites locally, if they're not clear, feel
>>> free to contribute your own explanations or ask for help directly to me
>> by
>>> email or on the discuss forum.
>>> 
>>> Good hunting!
>>> 
>>> Thomas
>>> 
>>> 
>>> 
>>> Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com>
>> a
>>> écrit :
>>> 
>>>> Good catch, Mu! Also good idea, Philip!
>>>> 
>>>> Aaron and Thomas, are you going to work on this?
>>>> 
>>>> -Marco
>>>> 
>>>> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
>>>> 
>>>>> The questions I found are:
>>>>> 
>>>>> 1. Not ever page contains, especially the homepage
>>>>> 
>>>>> 
>>>> 
>> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>>>>> 2. The correct tracking id is UA-96378503-1 instead of
>> UA-96378503-11 in
>>>>> 
>>>>> 
>>>> 
>> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>>>>> 
>>>>> On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
>>>>> 
>>>>>> I think the reason is that the google tracker is not included in
>> the
>>>> new
>>>>>> website.
>>>>>> 
>>>>>> On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
>>>> marco.g.abreu@gmail.com>
>>>>>> wrote:
>>>>>> 
>>>>>>> Hello,
>>>>>>> 
>>>>>>> I checked the Google Analytics statistics and the launch of the
>> new
>>>>>>> website reduced the traffic by over 80%:
>>>>>>> 
>>>>>>> [image: image.png]
>>>>>>> 
>>>>>>> (Please let me know if the image is not visible)
>>>>>>> 
>>>>>>> How shall we handle this?
>>>>>>> 
>>>>>>> Best regards,
>>>>>>> Marco
>>>>>>> 
>>>>>>> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
>> patric.zhao@intel.com>
>>>>>>> wrote:
>>>>>>> 
>>>>>>>> For the install page [1], I suggest to add the selection of
>> backend
>>>>>>>> DeepNumpy [2] which will be more clean.
>>>>>>>> 
>>>>>>>> [1] http://mxnet.incubator.apache.org/index.html
>>>>>>>> [2] https://numpy.mxnet.io/#installation
>>>>>>>> 
>>>>>>>> 
>>>>>>>> 
>>>>>>>>> -----Original Message-----
>>>>>>>>> From: kellen sunderland <ke...@gmail.com>
>>>>>>>>> Sent: Monday, September 23, 2019 12:47 PM
>>>>>>>>> To: dev@mxnet.incubator.apache.org
>>>>>>>>> Subject: Re: new website, docs code freeze
>>>>>>>>> 
>>>>>>>>> New site looks good.  I do notice that a few tutorials from
>> the old
>>>>>>>> site are
>>>>>>>>> missing (for example the TensorRT tutorial).  Any plans to
>> bring
>>>> them
>>>>>>>> back?
>>>>>>>>> 
>>>>>>>>> On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
>>>>> haibin.lin.aws@gmail.com>
>>>>>>>>> wrote:
>>>>>>>>> 
>>>>>>>>>> Another issue I found with the current website: the Sphinx
>> object
>>>>>>>>>> inventory
>>>>>>>>>> <https://www.sphinx-
>>>>>>>>> doc.org/en/master/usage/extensions/intersphinx.htm
>>>>>>>>>> l> file https://mxnet.apache.org/objects.inv is missing.
>>>> GluonNLP
>>>>>>>>>> relies on this file to link document across projects. Shall
>> we
>>>> add
>>>>> it
>>>>>>>>>> back?
>>>>>>>>>> 
>>>>>>>>>> Best,
>>>>>>>>>> Haibin
>>>>>>>>>> 
>>>>>>>>>> On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
>> lgo@mobsol.be>
>>>>>>>> wrote:
>>>>>>>>>> 
>>>>>>>>>>> Hi,
>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>>> On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
>>>>>>>>>>> <th...@gmail.com>
>>>>>>>>>>> wrote:
>>>>>>>>>>> 
>>>>>>>>>>>> Thanks all for the feedback,
>>>>>>>>>>>> 
>>>>>>>>>>>> We'll send an email next week with the list of missing
>>>>> features,
>>>>>>>>>> content
>>>>>>>>>>>> and bugs that we plan to fix.
>>>>>>>>>>>> We took the option of releasing early, with some features
>>>>>>>> missing,
>>>>>>>>>> rather
>>>>>>>>>>>> than trying to be at feature parity with the old website
>>>> before
>>>>>>>>>> launching
>>>>>>>>>>>> the website.
>>>>>>>>>>>> The reason why we decided to do that is two-fold:
>>>>>>>>>>>> - playing catch-up with docs in master introduce daily
>>>>> conflicts
>>>>>>>>>>>> that
>>>>>>>>>>> need
>>>>>>>>>>>> to be resolved and introduce opportunity for errors
>>>>>>>>>>>> - by releasing early, we can take advantage of the
>> community
>>>>>>>>>>> contributions
>>>>>>>>>>>> in modifying whatever the community feels like a better
>> way
>>>> of
>>>>>>>>>>>> doing things.
>>>>>>>>>>>> 
>>>>>>>>>>>> One of the goals of the new website was to disentangle
>> the
>>>> main
>>>>>>>>>> website,
>>>>>>>>>>>> now called "static_site" to the auto-generated docs. Now
>> the
>>>>>>>>>>>> overall
>>>>>>>>>> site
>>>>>>>>>>>> is made of a main static site, with easy to modify
>> content
>>>> and
>>>>>>>>>>>> easy to understand architecture for anybody familiar with
>>>> basic
>>>>>>>>>>>> html, and a collection of mini-websites for each language
>>>>>>>> bindings
>>>>>>>>>>>> that can be
>>>>>>>>>> built
>>>>>>>>>>> in
>>>>>>>>>>>> isolation and that are self-contained. Actually the new
>> CI
>>>> jobs
>>>>>>>>>>>> builds
>>>>>>>>>>> all
>>>>>>>>>>>> of them in parallel independently.
>>>>>>>>>>>> 
>>>>>>>>>>>> There is PLENTY of room for improvement, it would be
>> great if
>>>>> the
>>>>>>>>>>> community
>>>>>>>>>>>> can help contribute to bring the new website at the same
>>>> level
>>>>> of
>>>>>>>>>> content
>>>>>>>>>>>> richness as the old one, and then even further.
>>>>>>>>>>>> 
>>>>>>>>>>>> Missing features:
>>>>>>>>>>>> - As pointed by Haibin, the API docs do not have the full
>>>> list
>>>>> of
>>>>>>>>>>> operators
>>>>>>>>>>>> and classes. There is a mix of auto-generated docs based
>> on
>>>>>>>>>>>> packages,
>>>>>>>>>> and
>>>>>>>>>>>> some docs that are spelled out manually to improve the
>>>> logical
>>>>>>>>>>> organization
>>>>>>>>>>>> of the package where there is a need. The drawback with
>>>>> manually
>>>>>>>>>>>> listed classes in a package is that it's very easy to
>> miss
>>>>> some.
>>>>>>>>>>>> If someone
>>>>>>>>>>> wanted
>>>>>>>>>>>> to build a sanity check that would automatically detect
>> which
>>>>>>>>>>>> classes
>>>>>>>>>> are
>>>>>>>>>>>> not in the documentation, or if someone knew how to
>> enable
>>>> that
>>>>>>>>>>>> with sphinx, that would be a great addition to the python
>>>> docs
>>>>>>>>>>>> - There is missing content in the python tutorials, and
>> the
>>>>>>>>>>> discoverability
>>>>>>>>>>>> could be improved. Some old tutorials have not been
>> migrated
>>>>>>>> just yet.
>>>>>>>>>>>> - The nightly tests on tutorials have been disabled for
>> now
>>>>>>>>>>>> - There is no "Download jupyter notebook" for tutorials
>> just
>>>>> yet.
>>>>>>>>>>>> - Non-python tutorials might benefit from a blurb
>> description
>>>>> and
>>>>>>>>>>>> a
>>>>>>>>>>> better
>>>>>>>>>>>> content organization.
>>>>>>>>>>>> - Python tutorials could be better organized, have a
>> picture
>>>>>>>>>> accompanying
>>>>>>>>>>>> their description
>>>>>>>>>>>> - There is no site-wide search, this is not an easy
>> problem
>>>> to
>>>>>>>>>>>> solve to
>>>>>>>>>>> be
>>>>>>>>>>>> fair given the static nature of the website, but maybe an
>>>>>>>> external
>>>>>>>>>> plugin
>>>>>>>>>>>> might be able to give a half-way solution
>>>>>>>>>>>> - There is no version selector for the docs
>>>>>>>>>>>> - There is bug in search box of the python docs, but
>> this is
>>>>> just
>>>>>>>>>>>> a
>>>>>>>>>> small
>>>>>>>>>>>> JS bug that can be fixed easily (on my list for next
>> week)
>>>>>>>>>>>> - Most old links have not had a redirect put in place.
>>>>>>>>>>>> 
>>>>>>>>>>>> 
>>>>>>>>>>> I noticed on the Ubuntu home page in the Developer dropdown
>>>> that
>>>>>>>> the
>>>>>>>>>>> link MXNet on Ubuntu
>>>>>>>>>>> <https://mxnet.incubator.apache.org/install/index.html
>>>>>>>>>>>> with
>>>>>>>>>>> Nvidia
>>>>>>>>>>> <
>>>>>>>>>>> 
>>>>>>>>>> 
>>>>>>>> 
>>>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
>>>>>>>>>> mxnet/
>>>>>>>>>>>> 
>>>>>>>>>>> doesn't work anymore, it points to:
>>>>>>>>>>> https://mxnet.incubator.apache.org/install/index.html
>>>>>>>>>>> 
>>>>>>>>>>> Also, on the MXNet 'getting started' page
>>>>>>>>>>> https://mxnet.incubator.apache.org/get_started , the link
>>>>> "Ubuntu
>>>>>>>>>>> Installation Guide" at the bottom doesn't work either, it
>>>> points
>>>>>>>> to:
>>>>>>>>>>> https://mxnet.incubator.apache.org/ubuntu_setup.html
>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>>> I suggest you do a scan of the new website to find these
>>>> dangling
>>>>>>>> links.
>>>>>>>>>>> 
>>>>>>>>>>> regards,
>>>>>>>>>>> 
>>>>>>>>>>> Lieven
>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>>>> We'll formalize this in github issues next week, but
>> they are
>>>>> all
>>>>>>>>>> fairly
>>>>>>>>>>>> small and helping out on these would be a great way of
>>>>>>>>>>>> familiarizing yourself with the new website build system
>> and
>>>>>>>> website
>>>>>>>>> architecture.
>>>>>>>>>>>> 
>>>>>>>>>>>> Thanks all for the feedback, please keep it coming!
>>>>>>>>>>>> 
>>>>>>>>>>>> Thomas Delteil
>>>>>>>>>>>> 
>>>>>>>>>>>> Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>>>>>>>>>>>> <ha...@gmail.com> a écrit :
>>>>>>>>>>>> 
>>>>>>>>>>>>> It looks like my previous email did not go through.
>>>>> Re-sending:
>>>>>>>>>>>>> 
>>>>>>>>>>>>> Hi Aaron,
>>>>>>>>>>>>> 
>>>>>>>>>>>>> The website looks cool. Thanks for pushing this to
>>>>> production.
>>>>>>>> A
>>>>>>>>>>>>> few
>>>>>>>>>>>>> questions:
>>>>>>>>>>>>> 
>>>>>>>>>>>>> - I was looking for the API doc for mx.sym.dot, but I
>> find
>>>>> that
>>>>>>>>>>>>> most operators under mx.sym.* are missing. Is this
>>>> expected?
>>>>>>>>>>>>> - I was also checking the search functionality,
>> searching
>>>> the
>>>>>>>>>>>>> keyword "ndarray" only returns one result
>>>>>>>>>>>>> "mxnet.ndarray.NDArray", which
>>>>>>>>>>> doesn't
>>>>>>>>>>>>> seem right. There animation keeps going (Searching. ->
>>>>>>>>>>>>> Searching.. -> Searching ...) and gives me an
>> impression
>>>> that
>>>>>>>>>>>>> the search is never completely done(?).
>>>>>>>>>>>>> 
>>>>>>>>>>>>> Best,
>>>>>>>>>>>>> Haibin
>>>>>>>>>>>>> 
>>>>>>>>>>>>> 
>>>>>>>>>>>>> On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
>>>>>>>>>> chai.bapat@gmail.com>
>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>> 
>>>>>>>>>>>>>> Thanks Aaron and the team for launching new website!
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> 1. There's no search button anywhere on the landing
>> page.
>>>>>>>>>>>>>> 2. I wasn't able to find FAQ (and without search
>> button I
>>>>>>>> dont
>>>>>>>>>>>>>> have
>>>>>>>>>>>>> option
>>>>>>>>>>>>>> but to go manually on each menu). Only when I go to
>>>>>>>>>>>>>> Docs&Tutorials
>>>>>>>>>> ->
>>>>>>>>>>>> FAQ
>>>>>>>>>>>>>> -> Extend and Cotribute (that I got what I wanted).
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> Suggestions
>>>>>>>>>>>>>> Might want to make this searchable and pop FAQ on the
>>>> main
>>>>>>>>>>>>>> page (or somewhere prominent)
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> Thanks,
>>>>>>>>>>>>>> Chai
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
>>>>>>>>>> ptrendx@apache.org>
>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> There seems to be a problem with (at least Python,
>> did
>>>>> not
>>>>>>>>>>>>>>> check
>>>>>>>>>>>>> others)
>>>>>>>>>>>>>>> APIs. For example this page:
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> 
>>>>>>>>>>>>> 
>>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>> 
>>>>>>>>> 
>>>>> 
>> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
>>>>>>>>>> /mxnet.symbol.Symbol.argmax.html
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> says that it is a convenience method for argmax
>> (with a
>>>>>>>>>>>>>>> link),
>>>>>>>>>> but
>>>>>>>>>>>>>>> clicking that link just points to the same website
>> (and
>>>>> so
>>>>>>>>>>>>>>> user
>>>>>>>>>> has
>>>>>>>>>>>> no
>>>>>>>>>>>>>> way
>>>>>>>>>>>>>>> of getting to the docs of the actual operator).
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> When I tried to manually remove Symbol from the
>> URL to
>>>>> get
>>>>>>>>>>>>>>> to mxnet.symbol.argmax.html, I got a "Not found"
>>>> webpage
>>>>>>>>>>>>>>> which I
>>>>>>>>>> guess
>>>>>>>>>>>>> also
>>>>>>>>>>>>>>> should not happen (ignoring the fact that this
>> should
>>>>>>>> exist,
>>>>>>>>>> going
>>>>>>>>>>> to
>>>>>>>>>>>>>>> random URL under the website should redirect to the
>>>> main
>>>>>>>>>>>>>>> page I
>>>>>>>>>>>> think).
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> Przemek
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> On 2019/09/20 16:41:28, Lin Yuan <
>> apeforest@gmail.com>
>>>>>>>> wrote:
>>>>>>>>>>>>>>>> Looks very neat. Thank you Aaron and many others
>> for
>>>>>>>>>>>>>>>> launching
>>>>>>>>>>>> this!
>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>> On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
>>>>>>>>>>> carinmeier@gmail.com>
>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>> Nice!!! Congrats everyone!
>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>> On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham
>> <
>>>>>>>>>>>>>>> aaron.s.markham@gmail.com>
>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>> Alrighty! The new site is launched. You might
>>>> need
>>>>> to
>>>>>>>>>>>>>>>>>> clear
>>>>>>>>>>>> your
>>>>>>>>>>>>>>> cache.
>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>> Cheers,
>>>>>>>>>>>>>>>>>> Aaron
>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>> On Thu, Sep 19, 2019 at 3:33 PM Aaron
>> Markham <
>>>>>>>>>>>>>>> aaron.s.markham@gmail.com
>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>> Thanks everyone. The PRs passed CI, but
>> please
>>>>>>>>>>>>>>>>>>> continue
>>>>>>>>>>>> holding
>>>>>>>>>>>>>>> off on
>>>>>>>>>>>>>>>>>>> docs and CI edits. Unless there are any
>>>>> objections,
>>>>>>>>>>>>>>>>>>> I'd
>>>>>>>>>>> like
>>>>>>>>>>>> to
>>>>>>>>>>>>>>> launch
>>>>>>>>>>>>>>>>>>> the new website today.
>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>> On Wed, Sep 18, 2019 at 7:46 AM Aaron
>> Markham <
>>>>>>>>>>>>>>>>> aaron.s.markham@gmail.com>
>>>>>>>>>>>>>>>>>> wrote:
>>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>>> Hi everyone,
>>>>>>>>>>>>>>>>>>>> The last two PRs [1][2] for the new
>> website
>>>> and
>>>>>>>>>>>>>>>>>>>> docs
>>>>>>>>>> have
>>>>>>>>>>>>>> passed
>>>>>>>>>>>>>>> CI
>>>>>>>>>>>>>>>>>>>> (finally). Please do not make changes to
>>>> /docs
>>>>> or
>>>>>>>>>>>>>>>>>>>> /ci
>>>>>>>>>>> until
>>>>>>>>>>>>> we
>>>>>>>>>>>>>>> get
>>>>>>>>>>>>>>>>>>>> these approved and merged. Every time
>>>> there's a
>>>>>>>>>>>>>>>>>>>> merge
>>>>>>>>>>>>> conflict
>>>>>>>>>>>>>>> it has
>>>>>>>>>>>>>>>>>>>> set us back a day or two while
>> shepherding
>>>> the
>>>>>>>> PRs
>>>>>>>>>>> through
>>>>>>>>>>>> CI
>>>>>>>>>>>>>>> again.
>>>>>>>>>>>>>>>>>>>> Unless there are catastrophic issues
>>>> discovered
>>>>>>>> in
>>>>>>>>>>>>>>>>>>>> a
>>>>>>>>>>>> review,
>>>>>>>>>>>>> I
>>>>>>>>>>>>>>>>>>>> recommend that we hold any patches or
>> updates
>>>>> to
>>>>>>>>>>>>>>>>>>>> the
>>>>>>>>>> PRs
>>>>>>>>>>> to
>>>>>>>>>>>>>>> follow-up
>>>>>>>>>>>>>>>>>>>> PRs.
>>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>>> There are four steps to launch:
>>>>>>>>>>>>>>>>>>>> 1. Once the PRs are approved, the plan
>> is to
>>>>>>>> merge
>>>>>>>>>> 15885
>>>>>>>>>>> to
>>>>>>>>>>>>>>> delete
>>>>>>>>>>>>>>>>> the
>>>>>>>>>>>>>>>>>>>> old content first.
>>>>>>>>>>>>>>>>>>>> 2. Then immediately merge 15883 to add
>> in the
>>>>> new
>>>>>>>>>>>>>>>>>>>> CI
>>>>>>>>>>> flows
>>>>>>>>>>>>> and
>>>>>>>>>>>>>>>>> updates
>>>>>>>>>>>>>>>>>>>> to the content Thomas and I have already
>> had
>>>>>>>>>>>>>>>>>>>> merged in
>>>>>>>>>>>> 15884
>>>>>>>>>>>>>> [3].
>>>>>>>>>>>>>>>>>>>> 3. I will change the website validation
>>>> Jenkins
>>>>>>>>>> pipeline
>>>>>>>>>>> to
>>>>>>>>>>>>>>> point to
>>>>>>>>>>>>>>>>>>>> the new pipeline.
>>>>>>>>>>>>>>>>>>>> 4. I will change the website publishing
>>>> Jenkins
>>>>>>>>>> pipeline
>>>>>>>>>>> to
>>>>>>>>>>>>>>> point to
>>>>>>>>>>>>>>>>>>>> its new pipeline as well. Once
>> triggered, the
>>>>> old
>>>>>>>>>>>>>>>>>>>> site
>>>>>>>>>>> will
>>>>>>>>>>>>> be
>>>>>>>>>>>>>>>>>>>> replaced with the new one.
>>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>>> Post launch we'll need to update the DNS
>> for
>>>>>>>>>>> beta.mxnet.io
>>>>>>>>>>>>> to
>>>>>>>>>>>>>>> point
>>>>>>>>>>>>>>>>> to
>>>>>>>>>>>>>>>>>>>> production, and there will likely be some
>>>>>>>>>>>> redirect/.htaccess
>>>>>>>>>>>>>>> updates
>>>>>>>>>>>>>>>>>>>> needed next week to assist with any deep
>>>>> linking
>>>>>>>>>>>>>>>>>>>> and
>>>>>>>>>> 404
>>>>>>>>>>>>> issues
>>>>>>>>>>>>>>> that
>>>>>>>>>>>>>>>>>>>> pop up.
>>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>>> Cheers,
>>>>>>>>>>>>>>>>>>>> Aaron
>>>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>>>>> [1]
>>>>>>>>>> https://github.com/apache/incubator-mxnet/pull/15885
>>>>>>>>>>>>>>>>>>>> [2]
>>>>>>>>>> https://github.com/apache/incubator-mxnet/pull/15883
>>>>>>>>>>>>>>>>>>>> [3]
>>>>>>>>>> https://github.com/apache/incubator-mxnet/pull/15884
>>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> --
>>>>>>>>>>>>>> *Chaitanya Prakash Bapat*
>>>>>>>>>>>>>> *+1 (973) 953-6299*
>>>>>>>>>>>>>> 
>>>>>>>>>>>>>> [image: https://www.linkedin.com//in/chaibapat25]
>>>>>>>>>>>>>> <https://github.com/ChaiBapchya>[image:
>>>>>>>>>>>>> https://www.facebook.com/chaibapat
>>>>>>>>>>>>>> ]
>>>>>>>>>>>>>> <https://www.facebook.com/chaibapchya>[image:
>>>>>>>>>>>>>> https://twitter.com/ChaiBapchya]
>>>>>>>>>>>>>> <https://twitter.com/ChaiBapchya
>>>>>>>>>>>>>> [image:
>>>>>>>>>>>>>> https://www.linkedin.com//in/chaibapat25]
>>>>>>>>>>>>>> <https://www.linkedin.com//in/chaibapchya/>
>>>>>>>>>>>>>> 
>>>>>>>>>>>>> 
>>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>> 
>>>>>>>> 
>>>>>>> 
>>>>> 
>>>> 
>> 

Re: new website, docs code freeze

[Anirudh Acharya <an...@gmail.com>]

Hi,

In the operator tutorial(
http://mxnet.incubator.apache.org/api/faq/add_op_in_backend), there are
sections which do not render properly, for example - forward function,
backward function and shape inference.


Thanks
Anirudh




On Wed, Sep 25, 2019 at 7:53 AM Aaron Markham <aa...@gmail.com>
wrote:

> I'm seeing GA code is -1 not -11 in the analytics admin console. 11
> was for beta.mxnet.io.
> Either way, the Jekyll prod config file was missing the GA code, so I
> added it with this PR:
> https://github.com/apache/incubator-mxnet/pull/16271
>
> Reindexing of the site is being tracked here:
> https://issues.apache.org/jira/browse/INFRA-19144
>
> .htaccess testing was hampered by it not working on staging. This was
> tracked here, and it looks like infra just patched staging so we can
> resume redirect testing:
> https://issues.apache.org/jira/browse/INFRA-19075
> I have a CI pipeline for beta testing. If anyone wants to contribute
> to working on the redirects, you can use this pipeline to publish to
> the beta staging site.
> http://jenkins.mxnet-ci.amazon-ml.com/job/restricted-website-publish-beta/
> I've distilled this information in this issue:
> https://github.com/apache/incubator-mxnet/issues/16273
> I'd much rather have another contributor work on this since it will
> teach testing changes on the website, testing CI deployments to
> staging using your fork, previewing on staging, and finally deploying
> it to prod. I'm happy to help & guide along the way.
>
> (echoing Thomas) Please be sure to raise new issues in the repo, so we
> don't lose them in this thread. Also, more people can work on them. It
> would great if others can jump in and get familiar with the new site
> and start contributing patches.
>
> Cheers,
> Aaron
>
> On Wed, Sep 25, 2019 at 3:15 AM Thomas DELTEIL
> <th...@gmail.com> wrote:
> >
> > @Philip Yes we're looking at link redirects for older links that might be
> > hosted externally (using htaccess is my preferred way to handle it for
> now
> > as you sugested) and we'll use a broken link checker to update the links
> > that are hosted internally. We'll update the 404 to add an explanation on
> > the website update. Google indexes will slowly update across the week so
> > the google search issues will be less of a problem.
> >
> > If you find any such links yourself, or missing tutorials, please
> consider
> > stepping up and helping fixing them. The more people get familiar with
> the
> > new website architecture, the least likely it is to fall in a state of
> > stalled updates like the previous one.
> >
> > For the sphinx issues in the python mini-website, missing API classes, if
> > anybody is familiar with it, I'd love for us to bring back the automatic
> > doc generation for each package so at least we have a list of all
> available
> > classes in each sub package rather than relying on manual insertion of
> each
> > class, which is brittle and not future proof. @Lin, Haibin
> > <ha...@amazon.com> if you have experience with it, could we sync up
> > offline on how you suggest to do that based on your gluon-nlp experience?
> >
> > @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO
> in
> > Europe, I'll try make time today to help with the fixes since it is
> > impacting a lot of users.
> >
> > In the meanwhile, any help is appreciated, and more than the value of the
> > fixes, let me repeat that there is tremendous value in having more people
> > familiar with the website build pipelines. Aaron is the main owner for
> the
> > docs but he is already super busy with all his other responsibilities.
> I'm
> > available to help if anybody is stuck. I believe Aaron has updated the
> > READMEs on how to test the websites locally, if they're not clear, feel
> > free to contribute your own explanations or ask for help directly to me
> by
> > email or on the discuss forum.
> >
> > Good hunting!
> >
> > Thomas
> >
> >
> >
> > Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com>
> a
> > écrit :
> >
> > > Good catch, Mu! Also good idea, Philip!
> > >
> > > Aaron and Thomas, are you going to work on this?
> > >
> > > -Marco
> > >
> > > On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> > >
> > > > The questions I found are:
> > > >
> > > > 1. Not ever page contains, especially the homepage
> > > >
> > > >
> > >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > > 2. The correct tracking id is UA-96378503-1 instead of
> UA-96378503-11 in
> > > >
> > > >
> > >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > >
> > > > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> > > >
> > > > > I think the reason is that the google tracker is not included in
> the
> > > new
> > > > > website.
> > > > >
> > > > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > > marco.g.abreu@gmail.com>
> > > > > wrote:
> > > > >
> > > > >> Hello,
> > > > >>
> > > > >> I checked the Google Analytics statistics and the launch of the
> new
> > > > >> website reduced the traffic by over 80%:
> > > > >>
> > > > >> [image: image.png]
> > > > >>
> > > > >> (Please let me know if the image is not visible)
> > > > >>
> > > > >> How shall we handle this?
> > > > >>
> > > > >> Best regards,
> > > > >> Marco
> > > > >>
> > > > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <
> patric.zhao@intel.com>
> > > > >> wrote:
> > > > >>
> > > > >>> For the install page [1], I suggest to add the selection of
> backend
> > > > >>> DeepNumpy [2] which will be more clean.
> > > > >>>
> > > > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > > >>> [2] https://numpy.mxnet.io/#installation
> > > > >>>
> > > > >>>
> > > > >>>
> > > > >>> > -----Original Message-----
> > > > >>> > From: kellen sunderland <ke...@gmail.com>
> > > > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > > >>> > To: dev@mxnet.incubator.apache.org
> > > > >>> > Subject: Re: new website, docs code freeze
> > > > >>> >
> > > > >>> > New site looks good.  I do notice that a few tutorials from
> the old
> > > > >>> site are
> > > > >>> > missing (for example the TensorRT tutorial).  Any plans to
> bring
> > > them
> > > > >>> back?
> > > > >>> >
> > > > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > > haibin.lin.aws@gmail.com>
> > > > >>> > wrote:
> > > > >>> >
> > > > >>> > > Another issue I found with the current website: the Sphinx
> object
> > > > >>> > > inventory
> > > > >>> > > <https://www.sphinx-
> > > > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
> > > GluonNLP
> > > > >>> > > relies on this file to link document across projects. Shall
> we
> > > add
> > > > it
> > > > >>> > > back?
> > > > >>> > >
> > > > >>> > > Best,
> > > > >>> > > Haibin
> > > > >>> > >
> > > > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <
> lgo@mobsol.be>
> > > > >>> wrote:
> > > > >>> > >
> > > > >>> > > > Hi,
> > > > >>> > > >
> > > > >>> > > >
> > > > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > > >>> > > > <th...@gmail.com>
> > > > >>> > > > wrote:
> > > > >>> > > >
> > > > >>> > > > > Thanks all for the feedback,
> > > > >>> > > > >
> > > > >>> > > > > We'll send an email next week with the list of missing
> > > > features,
> > > > >>> > > content
> > > > >>> > > > > and bugs that we plan to fix.
> > > > >>> > > > > We took the option of releasing early, with some features
> > > > >>> missing,
> > > > >>> > > rather
> > > > >>> > > > > than trying to be at feature parity with the old website
> > > before
> > > > >>> > > launching
> > > > >>> > > > > the website.
> > > > >>> > > > > The reason why we decided to do that is two-fold:
> > > > >>> > > > > - playing catch-up with docs in master introduce daily
> > > > conflicts
> > > > >>> > > > > that
> > > > >>> > > > need
> > > > >>> > > > > to be resolved and introduce opportunity for errors
> > > > >>> > > > > - by releasing early, we can take advantage of the
> community
> > > > >>> > > > contributions
> > > > >>> > > > > in modifying whatever the community feels like a better
> way
> > > of
> > > > >>> > > > > doing things.
> > > > >>> > > > >
> > > > >>> > > > > One of the goals of the new website was to disentangle
> the
> > > main
> > > > >>> > > website,
> > > > >>> > > > > now called "static_site" to the auto-generated docs. Now
> the
> > > > >>> > > > > overall
> > > > >>> > > site
> > > > >>> > > > > is made of a main static site, with easy to modify
> content
> > > and
> > > > >>> > > > > easy to understand architecture for anybody familiar with
> > > basic
> > > > >>> > > > > html, and a collection of mini-websites for each language
> > > > >>> bindings
> > > > >>> > > > > that can be
> > > > >>> > > built
> > > > >>> > > > in
> > > > >>> > > > > isolation and that are self-contained. Actually the new
> CI
> > > jobs
> > > > >>> > > > > builds
> > > > >>> > > > all
> > > > >>> > > > > of them in parallel independently.
> > > > >>> > > > >
> > > > >>> > > > > There is PLENTY of room for improvement, it would be
> great if
> > > > the
> > > > >>> > > > community
> > > > >>> > > > > can help contribute to bring the new website at the same
> > > level
> > > > of
> > > > >>> > > content
> > > > >>> > > > > richness as the old one, and then even further.
> > > > >>> > > > >
> > > > >>> > > > > Missing features:
> > > > >>> > > > > - As pointed by Haibin, the API docs do not have the full
> > > list
> > > > of
> > > > >>> > > > operators
> > > > >>> > > > > and classes. There is a mix of auto-generated docs based
> on
> > > > >>> > > > > packages,
> > > > >>> > > and
> > > > >>> > > > > some docs that are spelled out manually to improve the
> > > logical
> > > > >>> > > > organization
> > > > >>> > > > > of the package where there is a need. The drawback with
> > > > manually
> > > > >>> > > > > listed classes in a package is that it's very easy to
> miss
> > > > some.
> > > > >>> > > > > If someone
> > > > >>> > > > wanted
> > > > >>> > > > > to build a sanity check that would automatically detect
> which
> > > > >>> > > > > classes
> > > > >>> > > are
> > > > >>> > > > > not in the documentation, or if someone knew how to
> enable
> > > that
> > > > >>> > > > > with sphinx, that would be a great addition to the python
> > > docs
> > > > >>> > > > > - There is missing content in the python tutorials, and
> the
> > > > >>> > > > discoverability
> > > > >>> > > > > could be improved. Some old tutorials have not been
> migrated
> > > > >>> just yet.
> > > > >>> > > > > - The nightly tests on tutorials have been disabled for
> now
> > > > >>> > > > > - There is no "Download jupyter notebook" for tutorials
> just
> > > > yet.
> > > > >>> > > > > - Non-python tutorials might benefit from a blurb
> description
> > > > and
> > > > >>> > > > > a
> > > > >>> > > > better
> > > > >>> > > > > content organization.
> > > > >>> > > > > - Python tutorials could be better organized, have a
> picture
> > > > >>> > > accompanying
> > > > >>> > > > > their description
> > > > >>> > > > > - There is no site-wide search, this is not an easy
> problem
> > > to
> > > > >>> > > > > solve to
> > > > >>> > > > be
> > > > >>> > > > > fair given the static nature of the website, but maybe an
> > > > >>> external
> > > > >>> > > plugin
> > > > >>> > > > > might be able to give a half-way solution
> > > > >>> > > > > - There is no version selector for the docs
> > > > >>> > > > > - There is bug in search box of the python docs, but
> this is
> > > > just
> > > > >>> > > > > a
> > > > >>> > > small
> > > > >>> > > > > JS bug that can be fixed easily (on my list for next
> week)
> > > > >>> > > > > - Most old links have not had a redirect put in place.
> > > > >>> > > > >
> > > > >>> > > > >
> > > > >>> > > > I noticed on the Ubuntu home page in the Developer dropdown
> > > that
> > > > >>> the
> > > > >>> > > > link MXNet on Ubuntu
> > > > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> > > > >>> > > > >with
> > > > >>> > > > Nvidia
> > > > >>> > > > <
> > > > >>> > > >
> > > > >>> > >
> > > > >>>
> > > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > > >>> > > mxnet/
> > > > >>> > > > >
> > > > >>> > > > doesn't work anymore, it points to:
> > > > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> > > > >>> > > >
> > > > >>> > > > Also, on the MXNet 'getting started' page
> > > > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> > > > "Ubuntu
> > > > >>> > > > Installation Guide" at the bottom doesn't work either, it
> > > points
> > > > >>> to:
> > > > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > > >>> > > >
> > > > >>> > > >
> > > > >>> > > > I suggest you do a scan of the new website to find these
> > > dangling
> > > > >>> links.
> > > > >>> > > >
> > > > >>> > > > regards,
> > > > >>> > > >
> > > > >>> > > > Lieven
> > > > >>> > > >
> > > > >>> > > >
> > > > >>> > > >
> > > > >>> > > > > We'll formalize this in github issues next week, but
> they are
> > > > all
> > > > >>> > > fairly
> > > > >>> > > > > small and helping out on these would be a great way of
> > > > >>> > > > > familiarizing yourself with the new website build system
> and
> > > > >>> website
> > > > >>> > architecture.
> > > > >>> > > > >
> > > > >>> > > > >  Thanks all for the feedback, please keep it coming!
> > > > >>> > > > >
> > > > >>> > > > > Thomas Delteil
> > > > >>> > > > >
> > > > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > >>> > > > > <ha...@gmail.com> a écrit :
> > > > >>> > > > >
> > > > >>> > > > > > It looks like my previous email did not go through.
> > > > Re-sending:
> > > > >>> > > > > >
> > > > >>> > > > > > Hi Aaron,
> > > > >>> > > > > >
> > > > >>> > > > > > The website looks cool. Thanks for pushing this to
> > > > production.
> > > > >>> A
> > > > >>> > > > > > few
> > > > >>> > > > > > questions:
> > > > >>> > > > > >
> > > > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I
> find
> > > > that
> > > > >>> > > > > > most operators under mx.sym.* are missing. Is this
> > > expected?
> > > > >>> > > > > > - I was also checking the search functionality,
> searching
> > > the
> > > > >>> > > > > > keyword "ndarray" only returns one result
> > > > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > > >>> > > > doesn't
> > > > >>> > > > > > seem right. There animation keeps going (Searching. ->
> > > > >>> > > > > > Searching.. -> Searching ...) and gives me an
> impression
> > > that
> > > > >>> > > > > > the search is never completely done(?).
> > > > >>> > > > > >
> > > > >>> > > > > > Best,
> > > > >>> > > > > > Haibin
> > > > >>> > > > > >
> > > > >>> > > > > >
> > > > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > > > >>> > > chai.bapat@gmail.com>
> > > > >>> > > > > > wrote:
> > > > >>> > > > > >
> > > > >>> > > > > > > Thanks Aaron and the team for launching new website!
> > > > >>> > > > > > >
> > > > >>> > > > > > > 1. There's no search button anywhere on the landing
> page.
> > > > >>> > > > > > > 2. I wasn't able to find FAQ (and without search
> button I
> > > > >>> dont
> > > > >>> > > > > > > have
> > > > >>> > > > > > option
> > > > >>> > > > > > > but to go manually on each menu). Only when I go to
> > > > >>> > > > > > > Docs&Tutorials
> > > > >>> > > ->
> > > > >>> > > > > FAQ
> > > > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > > > >>> > > > > > >
> > > > >>> > > > > > > Suggestions
> > > > >>> > > > > > > Might want to make this searchable and pop FAQ on the
> > > main
> > > > >>> > > > > > > page (or somewhere prominent)
> > > > >>> > > > > > >
> > > > >>> > > > > > > Thanks,
> > > > >>> > > > > > > Chai
> > > > >>> > > > > > >
> > > > >>> > > > > > >
> > > > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > > > >>> > > ptrendx@apache.org>
> > > > >>> > > > > > > wrote:
> > > > >>> > > > > > >
> > > > >>> > > > > > > > There seems to be a problem with (at least Python,
> did
> > > > not
> > > > >>> > > > > > > > check
> > > > >>> > > > > > others)
> > > > >>> > > > > > > > APIs. For example this page:
> > > > >>> > > > > > > >
> > > > >>> > > > > > > >
> > > > >>> > > > > > >
> > > > >>> > > > > >
> > > > >>> > > > >
> > > > >>> > > >
> > > > >>> > >
> > > > >>> >
> > > >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > > > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > > >>> > > > > > > >
> > > > >>> > > > > > > > says that it is a convenience method for argmax
> (with a
> > > > >>> > > > > > > > link),
> > > > >>> > > but
> > > > >>> > > > > > > > clicking that link just points to the same website
> (and
> > > > so
> > > > >>> > > > > > > > user
> > > > >>> > > has
> > > > >>> > > > > no
> > > > >>> > > > > > > way
> > > > >>> > > > > > > > of getting to the docs of the actual operator).
> > > > >>> > > > > > > >
> > > > >>> > > > > > > > When I tried to manually remove Symbol from the
> URL to
> > > > get
> > > > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
> > > webpage
> > > > >>> > > > > > > > which I
> > > > >>> > > guess
> > > > >>> > > > > > also
> > > > >>> > > > > > > > should not happen (ignoring the fact that this
> should
> > > > >>> exist,
> > > > >>> > > going
> > > > >>> > > > to
> > > > >>> > > > > > > > random URL under the website should redirect to the
> > > main
> > > > >>> > > > > > > > page I
> > > > >>> > > > > think).
> > > > >>> > > > > > > >
> > > > >>> > > > > > > > Przemek
> > > > >>> > > > > > > >
> > > > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <
> apeforest@gmail.com>
> > > > >>> wrote:
> > > > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others
> for
> > > > >>> > > > > > > > > launching
> > > > >>> > > > > this!
> > > > >>> > > > > > > > >
> > > > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > > > >>> > > > carinmeier@gmail.com>
> > > > >>> > > > > > > > wrote:
> > > > >>> > > > > > > > >
> > > > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > > >>> > > > > > > > > >
> > > > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham
> <
> > > > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > > >>> > > > > > > > > > wrote:
> > > > >>> > > > > > > > > >
> > > > >>> > > > > > > > > > > Alrighty! The new site is launched. You might
> > > need
> > > > to
> > > > >>> > > > > > > > > > > clear
> > > > >>> > > > > your
> > > > >>> > > > > > > > cache.
> > > > >>> > > > > > > > > > >
> > > > >>> > > > > > > > > > > Cheers,
> > > > >>> > > > > > > > > > > Aaron
> > > > >>> > > > > > > > > > >
> > > > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron
> Markham <
> > > > >>> > > > > > > > aaron.s.markham@gmail.com
> > > > >>> > > > > > > > > > >
> > > > >>> > > > > > > > > > > wrote:
> > > > >>> > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but
> please
> > > > >>> > > > > > > > > > > > continue
> > > > >>> > > > > holding
> > > > >>> > > > > > > > off on
> > > > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> > > > objections,
> > > > >>> > > > > > > > > > > > I'd
> > > > >>> > > > like
> > > > >>> > > > > to
> > > > >>> > > > > > > > launch
> > > > >>> > > > > > > > > > > > the new website today.
> > > > >>> > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron
> Markham <
> > > > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > > >>> > > > > > > > > > > wrote:
> > > > >>> > > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > > Hi everyone,
> > > > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new
> website
> > > and
> > > > >>> > > > > > > > > > > > > docs
> > > > >>> > > have
> > > > >>> > > > > > > passed
> > > > >>> > > > > > > > CI
> > > > >>> > > > > > > > > > > > > (finally). Please do not make changes to
> > > /docs
> > > > or
> > > > >>> > > > > > > > > > > > > /ci
> > > > >>> > > > until
> > > > >>> > > > > > we
> > > > >>> > > > > > > > get
> > > > >>> > > > > > > > > > > > > these approved and merged. Every time
> > > there's a
> > > > >>> > > > > > > > > > > > > merge
> > > > >>> > > > > > conflict
> > > > >>> > > > > > > > it has
> > > > >>> > > > > > > > > > > > > set us back a day or two while
> shepherding
> > > the
> > > > >>> PRs
> > > > >>> > > > through
> > > > >>> > > > > CI
> > > > >>> > > > > > > > again.
> > > > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> > > discovered
> > > > >>> in
> > > > >>> > > > > > > > > > > > > a
> > > > >>> > > > > review,
> > > > >>> > > > > > I
> > > > >>> > > > > > > > > > > > > recommend that we hold any patches or
> updates
> > > > to
> > > > >>> > > > > > > > > > > > > the
> > > > >>> > > PRs
> > > > >>> > > > to
> > > > >>> > > > > > > > follow-up
> > > > >>> > > > > > > > > > > > > PRs.
> > > > >>> > > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > > There are four steps to launch:
> > > > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan
> is to
> > > > >>> merge
> > > > >>> > > 15885
> > > > >>> > > > to
> > > > >>> > > > > > > > delete
> > > > >>> > > > > > > > > > the
> > > > >>> > > > > > > > > > > > > old content first.
> > > > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add
> in the
> > > > new
> > > > >>> > > > > > > > > > > > > CI
> > > > >>> > > > flows
> > > > >>> > > > > > and
> > > > >>> > > > > > > > > > updates
> > > > >>> > > > > > > > > > > > > to the content Thomas and I have already
> had
> > > > >>> > > > > > > > > > > > > merged in
> > > > >>> > > > > 15884
> > > > >>> > > > > > > [3].
> > > > >>> > > > > > > > > > > > > 3. I will change the website validation
> > > Jenkins
> > > > >>> > > pipeline
> > > > >>> > > > to
> > > > >>> > > > > > > > point to
> > > > >>> > > > > > > > > > > > > the new pipeline.
> > > > >>> > > > > > > > > > > > > 4. I will change the website publishing
> > > Jenkins
> > > > >>> > > pipeline
> > > > >>> > > > to
> > > > >>> > > > > > > > point to
> > > > >>> > > > > > > > > > > > > its new pipeline as well. Once
> triggered, the
> > > > old
> > > > >>> > > > > > > > > > > > > site
> > > > >>> > > > will
> > > > >>> > > > > > be
> > > > >>> > > > > > > > > > > > > replaced with the new one.
> > > > >>> > > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS
> for
> > > > >>> > > > beta.mxnet.io
> > > > >>> > > > > > to
> > > > >>> > > > > > > > point
> > > > >>> > > > > > > > > > to
> > > > >>> > > > > > > > > > > > > production, and there will likely be some
> > > > >>> > > > > redirect/.htaccess
> > > > >>> > > > > > > > updates
> > > > >>> > > > > > > > > > > > > needed next week to assist with any deep
> > > > linking
> > > > >>> > > > > > > > > > > > > and
> > > > >>> > > 404
> > > > >>> > > > > > issues
> > > > >>> > > > > > > > that
> > > > >>> > > > > > > > > > > > > pop up.
> > > > >>> > > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > > Cheers,
> > > > >>> > > > > > > > > > > > > Aaron
> > > > >>> > > > > > > > > > > > >
> > > > >>> > > > > > > > > > > > > [1]
> > > > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > > > >>> > > > > > > > > > > > > [2]
> > > > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > > > >>> > > > > > > > > > > > > [3]
> > > > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > > > >>> > > > > > > > > > >
> > > > >>> > > > > > > > > >
> > > > >>> > > > > > > > >
> > > > >>> > > > > > > >
> > > > >>> > > > > > >
> > > > >>> > > > > > >
> > > > >>> > > > > > > --
> > > > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > > >>> > > > > > > *+1 (973) 953-6299*
> > > > >>> > > > > > >
> > > > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > > >>> > > > > > https://www.facebook.com/chaibapat
> > > > >>> > > > > > > ]
> > > > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > > >>> > > > > > >[image:
> > > > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > > >>> > > > > > >
> > > > >>> > > > > >
> > > > >>> > > > >
> > > > >>> > > >
> > > > >>> > >
> > > > >>>
> > > > >>
> > > >
> > >
>

Re: new website, docs code freeze

[Aaron Markham <aa...@gmail.com>]

I'm seeing GA code is -1 not -11 in the analytics admin console. 11
was for beta.mxnet.io.
Either way, the Jekyll prod config file was missing the GA code, so I
added it with this PR:
https://github.com/apache/incubator-mxnet/pull/16271

Reindexing of the site is being tracked here:
https://issues.apache.org/jira/browse/INFRA-19144

.htaccess testing was hampered by it not working on staging. This was
tracked here, and it looks like infra just patched staging so we can
resume redirect testing:
https://issues.apache.org/jira/browse/INFRA-19075
I have a CI pipeline for beta testing. If anyone wants to contribute
to working on the redirects, you can use this pipeline to publish to
the beta staging site.
http://jenkins.mxnet-ci.amazon-ml.com/job/restricted-website-publish-beta/
I've distilled this information in this issue:
https://github.com/apache/incubator-mxnet/issues/16273
I'd much rather have another contributor work on this since it will
teach testing changes on the website, testing CI deployments to
staging using your fork, previewing on staging, and finally deploying
it to prod. I'm happy to help & guide along the way.

(echoing Thomas) Please be sure to raise new issues in the repo, so we
don't lose them in this thread. Also, more people can work on them. It
would great if others can jump in and get familiar with the new site
and start contributing patches.

Cheers,
Aaron

On Wed, Sep 25, 2019 at 3:15 AM Thomas DELTEIL
<th...@gmail.com> wrote:
>
> @Philip Yes we're looking at link redirects for older links that might be
> hosted externally (using htaccess is my preferred way to handle it for now
> as you sugested) and we'll use a broken link checker to update the links
> that are hosted internally. We'll update the 404 to add an explanation on
> the website update. Google indexes will slowly update across the week so
> the google search issues will be less of a problem.
>
> If you find any such links yourself, or missing tutorials, please consider
> stepping up and helping fixing them. The more people get familiar with the
> new website architecture, the least likely it is to fall in a state of
> stalled updates like the previous one.
>
> For the sphinx issues in the python mini-website, missing API classes, if
> anybody is familiar with it, I'd love for us to bring back the automatic
> doc generation for each package so at least we have a list of all available
> classes in each sub package rather than relying on manual insertion of each
> class, which is brittle and not future proof. @Lin, Haibin
> <ha...@amazon.com> if you have experience with it, could we sync up
> offline on how you suggest to do that based on your gluon-nlp experience?
>
> @Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO in
> Europe, I'll try make time today to help with the fixes since it is
> impacting a lot of users.
>
> In the meanwhile, any help is appreciated, and more than the value of the
> fixes, let me repeat that there is tremendous value in having more people
> familiar with the website build pipelines. Aaron is the main owner for the
> docs but he is already super busy with all his other responsibilities. I'm
> available to help if anybody is stuck. I believe Aaron has updated the
> READMEs on how to test the websites locally, if they're not clear, feel
> free to contribute your own explanations or ask for help directly to me by
> email or on the discuss forum.
>
> Good hunting!
>
> Thomas
>
>
>
> Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com> a
> écrit :
>
> > Good catch, Mu! Also good idea, Philip!
> >
> > Aaron and Thomas, are you going to work on this?
> >
> > -Marco
> >
> > On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
> >
> > > The questions I found are:
> > >
> > > 1. Not ever page contains, especially the homepage
> > >
> > >
> > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > > 2. The correct tracking id is UA-96378503-1 instead of UA-96378503-11 in
> > >
> > >
> > http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > >
> > > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> > >
> > > > I think the reason is that the google tracker is not included in the
> > new
> > > > website.
> > > >
> > > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> > marco.g.abreu@gmail.com>
> > > > wrote:
> > > >
> > > >> Hello,
> > > >>
> > > >> I checked the Google Analytics statistics and the launch of the new
> > > >> website reduced the traffic by over 80%:
> > > >>
> > > >> [image: image.png]
> > > >>
> > > >> (Please let me know if the image is not visible)
> > > >>
> > > >> How shall we handle this?
> > > >>
> > > >> Best regards,
> > > >> Marco
> > > >>
> > > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> > > >> wrote:
> > > >>
> > > >>> For the install page [1], I suggest to add the selection of backend
> > > >>> DeepNumpy [2] which will be more clean.
> > > >>>
> > > >>> [1] http://mxnet.incubator.apache.org/index.html
> > > >>> [2] https://numpy.mxnet.io/#installation
> > > >>>
> > > >>>
> > > >>>
> > > >>> > -----Original Message-----
> > > >>> > From: kellen sunderland <ke...@gmail.com>
> > > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > > >>> > To: dev@mxnet.incubator.apache.org
> > > >>> > Subject: Re: new website, docs code freeze
> > > >>> >
> > > >>> > New site looks good.  I do notice that a few tutorials from the old
> > > >>> site are
> > > >>> > missing (for example the TensorRT tutorial).  Any plans to bring
> > them
> > > >>> back?
> > > >>> >
> > > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > > haibin.lin.aws@gmail.com>
> > > >>> > wrote:
> > > >>> >
> > > >>> > > Another issue I found with the current website: the Sphinx object
> > > >>> > > inventory
> > > >>> > > <https://www.sphinx-
> > > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
> > GluonNLP
> > > >>> > > relies on this file to link document across projects. Shall we
> > add
> > > it
> > > >>> > > back?
> > > >>> > >
> > > >>> > > Best,
> > > >>> > > Haibin
> > > >>> > >
> > > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
> > > >>> wrote:
> > > >>> > >
> > > >>> > > > Hi,
> > > >>> > > >
> > > >>> > > >
> > > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > >>> > > > <th...@gmail.com>
> > > >>> > > > wrote:
> > > >>> > > >
> > > >>> > > > > Thanks all for the feedback,
> > > >>> > > > >
> > > >>> > > > > We'll send an email next week with the list of missing
> > > features,
> > > >>> > > content
> > > >>> > > > > and bugs that we plan to fix.
> > > >>> > > > > We took the option of releasing early, with some features
> > > >>> missing,
> > > >>> > > rather
> > > >>> > > > > than trying to be at feature parity with the old website
> > before
> > > >>> > > launching
> > > >>> > > > > the website.
> > > >>> > > > > The reason why we decided to do that is two-fold:
> > > >>> > > > > - playing catch-up with docs in master introduce daily
> > > conflicts
> > > >>> > > > > that
> > > >>> > > > need
> > > >>> > > > > to be resolved and introduce opportunity for errors
> > > >>> > > > > - by releasing early, we can take advantage of the community
> > > >>> > > > contributions
> > > >>> > > > > in modifying whatever the community feels like a better way
> > of
> > > >>> > > > > doing things.
> > > >>> > > > >
> > > >>> > > > > One of the goals of the new website was to disentangle the
> > main
> > > >>> > > website,
> > > >>> > > > > now called "static_site" to the auto-generated docs. Now the
> > > >>> > > > > overall
> > > >>> > > site
> > > >>> > > > > is made of a main static site, with easy to modify content
> > and
> > > >>> > > > > easy to understand architecture for anybody familiar with
> > basic
> > > >>> > > > > html, and a collection of mini-websites for each language
> > > >>> bindings
> > > >>> > > > > that can be
> > > >>> > > built
> > > >>> > > > in
> > > >>> > > > > isolation and that are self-contained. Actually the new CI
> > jobs
> > > >>> > > > > builds
> > > >>> > > > all
> > > >>> > > > > of them in parallel independently.
> > > >>> > > > >
> > > >>> > > > > There is PLENTY of room for improvement, it would be great if
> > > the
> > > >>> > > > community
> > > >>> > > > > can help contribute to bring the new website at the same
> > level
> > > of
> > > >>> > > content
> > > >>> > > > > richness as the old one, and then even further.
> > > >>> > > > >
> > > >>> > > > > Missing features:
> > > >>> > > > > - As pointed by Haibin, the API docs do not have the full
> > list
> > > of
> > > >>> > > > operators
> > > >>> > > > > and classes. There is a mix of auto-generated docs based on
> > > >>> > > > > packages,
> > > >>> > > and
> > > >>> > > > > some docs that are spelled out manually to improve the
> > logical
> > > >>> > > > organization
> > > >>> > > > > of the package where there is a need. The drawback with
> > > manually
> > > >>> > > > > listed classes in a package is that it's very easy to miss
> > > some.
> > > >>> > > > > If someone
> > > >>> > > > wanted
> > > >>> > > > > to build a sanity check that would automatically detect which
> > > >>> > > > > classes
> > > >>> > > are
> > > >>> > > > > not in the documentation, or if someone knew how to enable
> > that
> > > >>> > > > > with sphinx, that would be a great addition to the python
> > docs
> > > >>> > > > > - There is missing content in the python tutorials, and the
> > > >>> > > > discoverability
> > > >>> > > > > could be improved. Some old tutorials have not been migrated
> > > >>> just yet.
> > > >>> > > > > - The nightly tests on tutorials have been disabled for now
> > > >>> > > > > - There is no "Download jupyter notebook" for tutorials just
> > > yet.
> > > >>> > > > > - Non-python tutorials might benefit from a blurb description
> > > and
> > > >>> > > > > a
> > > >>> > > > better
> > > >>> > > > > content organization.
> > > >>> > > > > - Python tutorials could be better organized, have a picture
> > > >>> > > accompanying
> > > >>> > > > > their description
> > > >>> > > > > - There is no site-wide search, this is not an easy problem
> > to
> > > >>> > > > > solve to
> > > >>> > > > be
> > > >>> > > > > fair given the static nature of the website, but maybe an
> > > >>> external
> > > >>> > > plugin
> > > >>> > > > > might be able to give a half-way solution
> > > >>> > > > > - There is no version selector for the docs
> > > >>> > > > > - There is bug in search box of the python docs, but this is
> > > just
> > > >>> > > > > a
> > > >>> > > small
> > > >>> > > > > JS bug that can be fixed easily (on my list for next week)
> > > >>> > > > > - Most old links have not had a redirect put in place.
> > > >>> > > > >
> > > >>> > > > >
> > > >>> > > > I noticed on the Ubuntu home page in the Developer dropdown
> > that
> > > >>> the
> > > >>> > > > link MXNet on Ubuntu
> > > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> > > >>> > > > >with
> > > >>> > > > Nvidia
> > > >>> > > > <
> > > >>> > > >
> > > >>> > >
> > > >>>
> > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > >>> > > mxnet/
> > > >>> > > > >
> > > >>> > > > doesn't work anymore, it points to:
> > > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> > > >>> > > >
> > > >>> > > > Also, on the MXNet 'getting started' page
> > > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> > > "Ubuntu
> > > >>> > > > Installation Guide" at the bottom doesn't work either, it
> > points
> > > >>> to:
> > > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > >>> > > >
> > > >>> > > >
> > > >>> > > > I suggest you do a scan of the new website to find these
> > dangling
> > > >>> links.
> > > >>> > > >
> > > >>> > > > regards,
> > > >>> > > >
> > > >>> > > > Lieven
> > > >>> > > >
> > > >>> > > >
> > > >>> > > >
> > > >>> > > > > We'll formalize this in github issues next week, but they are
> > > all
> > > >>> > > fairly
> > > >>> > > > > small and helping out on these would be a great way of
> > > >>> > > > > familiarizing yourself with the new website build system and
> > > >>> website
> > > >>> > architecture.
> > > >>> > > > >
> > > >>> > > > >  Thanks all for the feedback, please keep it coming!
> > > >>> > > > >
> > > >>> > > > > Thomas Delteil
> > > >>> > > > >
> > > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > >>> > > > > <ha...@gmail.com> a écrit :
> > > >>> > > > >
> > > >>> > > > > > It looks like my previous email did not go through.
> > > Re-sending:
> > > >>> > > > > >
> > > >>> > > > > > Hi Aaron,
> > > >>> > > > > >
> > > >>> > > > > > The website looks cool. Thanks for pushing this to
> > > production.
> > > >>> A
> > > >>> > > > > > few
> > > >>> > > > > > questions:
> > > >>> > > > > >
> > > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find
> > > that
> > > >>> > > > > > most operators under mx.sym.* are missing. Is this
> > expected?
> > > >>> > > > > > - I was also checking the search functionality, searching
> > the
> > > >>> > > > > > keyword "ndarray" only returns one result
> > > >>> > > > > > "mxnet.ndarray.NDArray", which
> > > >>> > > > doesn't
> > > >>> > > > > > seem right. There animation keeps going (Searching. ->
> > > >>> > > > > > Searching.. -> Searching ...) and gives me an impression
> > that
> > > >>> > > > > > the search is never completely done(?).
> > > >>> > > > > >
> > > >>> > > > > > Best,
> > > >>> > > > > > Haibin
> > > >>> > > > > >
> > > >>> > > > > >
> > > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > > >>> > > chai.bapat@gmail.com>
> > > >>> > > > > > wrote:
> > > >>> > > > > >
> > > >>> > > > > > > Thanks Aaron and the team for launching new website!
> > > >>> > > > > > >
> > > >>> > > > > > > 1. There's no search button anywhere on the landing page.
> > > >>> > > > > > > 2. I wasn't able to find FAQ (and without search button I
> > > >>> dont
> > > >>> > > > > > > have
> > > >>> > > > > > option
> > > >>> > > > > > > but to go manually on each menu). Only when I go to
> > > >>> > > > > > > Docs&Tutorials
> > > >>> > > ->
> > > >>> > > > > FAQ
> > > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > > >>> > > > > > >
> > > >>> > > > > > > Suggestions
> > > >>> > > > > > > Might want to make this searchable and pop FAQ on the
> > main
> > > >>> > > > > > > page (or somewhere prominent)
> > > >>> > > > > > >
> > > >>> > > > > > > Thanks,
> > > >>> > > > > > > Chai
> > > >>> > > > > > >
> > > >>> > > > > > >
> > > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > > >>> > > ptrendx@apache.org>
> > > >>> > > > > > > wrote:
> > > >>> > > > > > >
> > > >>> > > > > > > > There seems to be a problem with (at least Python, did
> > > not
> > > >>> > > > > > > > check
> > > >>> > > > > > others)
> > > >>> > > > > > > > APIs. For example this page:
> > > >>> > > > > > > >
> > > >>> > > > > > > >
> > > >>> > > > > > >
> > > >>> > > > > >
> > > >>> > > > >
> > > >>> > > >
> > > >>> > >
> > > >>> >
> > > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > > >>> > > /mxnet.symbol.Symbol.argmax.html
> > > >>> > > > > > > >
> > > >>> > > > > > > > says that it is a convenience method for argmax (with a
> > > >>> > > > > > > > link),
> > > >>> > > but
> > > >>> > > > > > > > clicking that link just points to the same website (and
> > > so
> > > >>> > > > > > > > user
> > > >>> > > has
> > > >>> > > > > no
> > > >>> > > > > > > way
> > > >>> > > > > > > > of getting to the docs of the actual operator).
> > > >>> > > > > > > >
> > > >>> > > > > > > > When I tried to manually remove Symbol from the URL to
> > > get
> > > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
> > webpage
> > > >>> > > > > > > > which I
> > > >>> > > guess
> > > >>> > > > > > also
> > > >>> > > > > > > > should not happen (ignoring the fact that this should
> > > >>> exist,
> > > >>> > > going
> > > >>> > > > to
> > > >>> > > > > > > > random URL under the website should redirect to the
> > main
> > > >>> > > > > > > > page I
> > > >>> > > > > think).
> > > >>> > > > > > > >
> > > >>> > > > > > > > Przemek
> > > >>> > > > > > > >
> > > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
> > > >>> wrote:
> > > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
> > > >>> > > > > > > > > launching
> > > >>> > > > > this!
> > > >>> > > > > > > > >
> > > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > > >>> > > > carinmeier@gmail.com>
> > > >>> > > > > > > > wrote:
> > > >>> > > > > > > > >
> > > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > > >>> > > > > > > > > >
> > > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > >>> > > > > > > > aaron.s.markham@gmail.com>
> > > >>> > > > > > > > > > wrote:
> > > >>> > > > > > > > > >
> > > >>> > > > > > > > > > > Alrighty! The new site is launched. You might
> > need
> > > to
> > > >>> > > > > > > > > > > clear
> > > >>> > > > > your
> > > >>> > > > > > > > cache.
> > > >>> > > > > > > > > > >
> > > >>> > > > > > > > > > > Cheers,
> > > >>> > > > > > > > > > > Aaron
> > > >>> > > > > > > > > > >
> > > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > >>> > > > > > > > aaron.s.markham@gmail.com
> > > >>> > > > > > > > > > >
> > > >>> > > > > > > > > > > wrote:
> > > >>> > > > > > > > > > > >
> > > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> > > >>> > > > > > > > > > > > continue
> > > >>> > > > > holding
> > > >>> > > > > > > > off on
> > > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> > > objections,
> > > >>> > > > > > > > > > > > I'd
> > > >>> > > > like
> > > >>> > > > > to
> > > >>> > > > > > > > launch
> > > >>> > > > > > > > > > > > the new website today.
> > > >>> > > > > > > > > > > >
> > > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > > >>> > > > > > > > > > > wrote:
> > > >>> > > > > > > > > > > > >
> > > >>> > > > > > > > > > > > > Hi everyone,
> > > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new website
> > and
> > > >>> > > > > > > > > > > > > docs
> > > >>> > > have
> > > >>> > > > > > > passed
> > > >>> > > > > > > > CI
> > > >>> > > > > > > > > > > > > (finally). Please do not make changes to
> > /docs
> > > or
> > > >>> > > > > > > > > > > > > /ci
> > > >>> > > > until
> > > >>> > > > > > we
> > > >>> > > > > > > > get
> > > >>> > > > > > > > > > > > > these approved and merged. Every time
> > there's a
> > > >>> > > > > > > > > > > > > merge
> > > >>> > > > > > conflict
> > > >>> > > > > > > > it has
> > > >>> > > > > > > > > > > > > set us back a day or two while shepherding
> > the
> > > >>> PRs
> > > >>> > > > through
> > > >>> > > > > CI
> > > >>> > > > > > > > again.
> > > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> > discovered
> > > >>> in
> > > >>> > > > > > > > > > > > > a
> > > >>> > > > > review,
> > > >>> > > > > > I
> > > >>> > > > > > > > > > > > > recommend that we hold any patches or updates
> > > to
> > > >>> > > > > > > > > > > > > the
> > > >>> > > PRs
> > > >>> > > > to
> > > >>> > > > > > > > follow-up
> > > >>> > > > > > > > > > > > > PRs.
> > > >>> > > > > > > > > > > > >
> > > >>> > > > > > > > > > > > > There are four steps to launch:
> > > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
> > > >>> merge
> > > >>> > > 15885
> > > >>> > > > to
> > > >>> > > > > > > > delete
> > > >>> > > > > > > > > > the
> > > >>> > > > > > > > > > > > > old content first.
> > > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the
> > > new
> > > >>> > > > > > > > > > > > > CI
> > > >>> > > > flows
> > > >>> > > > > > and
> > > >>> > > > > > > > > > updates
> > > >>> > > > > > > > > > > > > to the content Thomas and I have already had
> > > >>> > > > > > > > > > > > > merged in
> > > >>> > > > > 15884
> > > >>> > > > > > > [3].
> > > >>> > > > > > > > > > > > > 3. I will change the website validation
> > Jenkins
> > > >>> > > pipeline
> > > >>> > > > to
> > > >>> > > > > > > > point to
> > > >>> > > > > > > > > > > > > the new pipeline.
> > > >>> > > > > > > > > > > > > 4. I will change the website publishing
> > Jenkins
> > > >>> > > pipeline
> > > >>> > > > to
> > > >>> > > > > > > > point to
> > > >>> > > > > > > > > > > > > its new pipeline as well. Once triggered, the
> > > old
> > > >>> > > > > > > > > > > > > site
> > > >>> > > > will
> > > >>> > > > > > be
> > > >>> > > > > > > > > > > > > replaced with the new one.
> > > >>> > > > > > > > > > > > >
> > > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
> > > >>> > > > beta.mxnet.io
> > > >>> > > > > > to
> > > >>> > > > > > > > point
> > > >>> > > > > > > > > > to
> > > >>> > > > > > > > > > > > > production, and there will likely be some
> > > >>> > > > > redirect/.htaccess
> > > >>> > > > > > > > updates
> > > >>> > > > > > > > > > > > > needed next week to assist with any deep
> > > linking
> > > >>> > > > > > > > > > > > > and
> > > >>> > > 404
> > > >>> > > > > > issues
> > > >>> > > > > > > > that
> > > >>> > > > > > > > > > > > > pop up.
> > > >>> > > > > > > > > > > > >
> > > >>> > > > > > > > > > > > > Cheers,
> > > >>> > > > > > > > > > > > > Aaron
> > > >>> > > > > > > > > > > > >
> > > >>> > > > > > > > > > > > > [1]
> > > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > > >>> > > > > > > > > > > > > [2]
> > > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > > >>> > > > > > > > > > > > > [3]
> > > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > > >>> > > > > > > > > > >
> > > >>> > > > > > > > > >
> > > >>> > > > > > > > >
> > > >>> > > > > > > >
> > > >>> > > > > > >
> > > >>> > > > > > >
> > > >>> > > > > > > --
> > > >>> > > > > > > *Chaitanya Prakash Bapat*
> > > >>> > > > > > > *+1 (973) 953-6299*
> > > >>> > > > > > >
> > > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > >>> > > > > > https://www.facebook.com/chaibapat
> > > >>> > > > > > > ]
> > > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > > >>> > > > > > >[image:
> > > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > >>> > > > > > >
> > > >>> > > > > >
> > > >>> > > > >
> > > >>> > > >
> > > >>> > >
> > > >>>
> > > >>
> > >
> >

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

@Philip Yes we're looking at link redirects for older links that might be
hosted externally (using htaccess is my preferred way to handle it for now
as you sugested) and we'll use a broken link checker to update the links
that are hosted internally. We'll update the 404 to add an explanation on
the website update. Google indexes will slowly update across the week so
the google search issues will be less of a problem.

If you find any such links yourself, or missing tutorials, please consider
stepping up and helping fixing them. The more people get familiar with the
new website architecture, the least likely it is to fall in a state of
stalled updates like the previous one.

For the sphinx issues in the python mini-website, missing API classes, if
anybody is familiar with it, I'd love for us to bring back the automatic
doc generation for each package so at least we have a list of all available
classes in each sub package rather than relying on manual insertion of each
class, which is brittle and not future proof. @Lin, Haibin
<ha...@amazon.com> if you have experience with it, could we sync up
offline on how you suggest to do that based on your gluon-nlp experience?

@Marco, I'm currently traveling for ICDAR in Sydney, and Aaron is on PTO in
Europe, I'll try make time today to help with the fixes since it is
impacting a lot of users.

In the meanwhile, any help is appreciated, and more than the value of the
fixes, let me repeat that there is tremendous value in having more people
familiar with the website build pipelines. Aaron is the main owner for the
docs but he is already super busy with all his other responsibilities. I'm
available to help if anybody is stuck. I believe Aaron has updated the
READMEs on how to test the websites locally, if they're not clear, feel
free to contribute your own explanations or ask for help directly to me by
email or on the discuss forum.

Good hunting!

Thomas



Le mer. 25 sept. 2019 à 10:10, Marco de Abreu <ma...@gmail.com> a
écrit :

> Good catch, Mu! Also good idea, Philip!
>
> Aaron and Thomas, are you going to work on this?
>
> -Marco
>
> On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:
>
> > The questions I found are:
> >
> > 1. Not ever page contains, especially the homepage
> >
> >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> > 2. The correct tracking id is UA-96378503-1 instead of UA-96378503-11 in
> >
> >
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> >
> > On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
> >
> > > I think the reason is that the google tracker is not included in the
> new
> > > website.
> > >
> > > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <
> marco.g.abreu@gmail.com>
> > > wrote:
> > >
> > >> Hello,
> > >>
> > >> I checked the Google Analytics statistics and the launch of the new
> > >> website reduced the traffic by over 80%:
> > >>
> > >> [image: image.png]
> > >>
> > >> (Please let me know if the image is not visible)
> > >>
> > >> How shall we handle this?
> > >>
> > >> Best regards,
> > >> Marco
> > >>
> > >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> > >> wrote:
> > >>
> > >>> For the install page [1], I suggest to add the selection of backend
> > >>> DeepNumpy [2] which will be more clean.
> > >>>
> > >>> [1] http://mxnet.incubator.apache.org/index.html
> > >>> [2] https://numpy.mxnet.io/#installation
> > >>>
> > >>>
> > >>>
> > >>> > -----Original Message-----
> > >>> > From: kellen sunderland <ke...@gmail.com>
> > >>> > Sent: Monday, September 23, 2019 12:47 PM
> > >>> > To: dev@mxnet.incubator.apache.org
> > >>> > Subject: Re: new website, docs code freeze
> > >>> >
> > >>> > New site looks good.  I do notice that a few tutorials from the old
> > >>> site are
> > >>> > missing (for example the TensorRT tutorial).  Any plans to bring
> them
> > >>> back?
> > >>> >
> > >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> > haibin.lin.aws@gmail.com>
> > >>> > wrote:
> > >>> >
> > >>> > > Another issue I found with the current website: the Sphinx object
> > >>> > > inventory
> > >>> > > <https://www.sphinx-
> > >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> > >>> > > l> file https://mxnet.apache.org/objects.inv is missing.
> GluonNLP
> > >>> > > relies on this file to link document across projects. Shall we
> add
> > it
> > >>> > > back?
> > >>> > >
> > >>> > > Best,
> > >>> > > Haibin
> > >>> > >
> > >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
> > >>> wrote:
> > >>> > >
> > >>> > > > Hi,
> > >>> > > >
> > >>> > > >
> > >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > >>> > > > <th...@gmail.com>
> > >>> > > > wrote:
> > >>> > > >
> > >>> > > > > Thanks all for the feedback,
> > >>> > > > >
> > >>> > > > > We'll send an email next week with the list of missing
> > features,
> > >>> > > content
> > >>> > > > > and bugs that we plan to fix.
> > >>> > > > > We took the option of releasing early, with some features
> > >>> missing,
> > >>> > > rather
> > >>> > > > > than trying to be at feature parity with the old website
> before
> > >>> > > launching
> > >>> > > > > the website.
> > >>> > > > > The reason why we decided to do that is two-fold:
> > >>> > > > > - playing catch-up with docs in master introduce daily
> > conflicts
> > >>> > > > > that
> > >>> > > > need
> > >>> > > > > to be resolved and introduce opportunity for errors
> > >>> > > > > - by releasing early, we can take advantage of the community
> > >>> > > > contributions
> > >>> > > > > in modifying whatever the community feels like a better way
> of
> > >>> > > > > doing things.
> > >>> > > > >
> > >>> > > > > One of the goals of the new website was to disentangle the
> main
> > >>> > > website,
> > >>> > > > > now called "static_site" to the auto-generated docs. Now the
> > >>> > > > > overall
> > >>> > > site
> > >>> > > > > is made of a main static site, with easy to modify content
> and
> > >>> > > > > easy to understand architecture for anybody familiar with
> basic
> > >>> > > > > html, and a collection of mini-websites for each language
> > >>> bindings
> > >>> > > > > that can be
> > >>> > > built
> > >>> > > > in
> > >>> > > > > isolation and that are self-contained. Actually the new CI
> jobs
> > >>> > > > > builds
> > >>> > > > all
> > >>> > > > > of them in parallel independently.
> > >>> > > > >
> > >>> > > > > There is PLENTY of room for improvement, it would be great if
> > the
> > >>> > > > community
> > >>> > > > > can help contribute to bring the new website at the same
> level
> > of
> > >>> > > content
> > >>> > > > > richness as the old one, and then even further.
> > >>> > > > >
> > >>> > > > > Missing features:
> > >>> > > > > - As pointed by Haibin, the API docs do not have the full
> list
> > of
> > >>> > > > operators
> > >>> > > > > and classes. There is a mix of auto-generated docs based on
> > >>> > > > > packages,
> > >>> > > and
> > >>> > > > > some docs that are spelled out manually to improve the
> logical
> > >>> > > > organization
> > >>> > > > > of the package where there is a need. The drawback with
> > manually
> > >>> > > > > listed classes in a package is that it's very easy to miss
> > some.
> > >>> > > > > If someone
> > >>> > > > wanted
> > >>> > > > > to build a sanity check that would automatically detect which
> > >>> > > > > classes
> > >>> > > are
> > >>> > > > > not in the documentation, or if someone knew how to enable
> that
> > >>> > > > > with sphinx, that would be a great addition to the python
> docs
> > >>> > > > > - There is missing content in the python tutorials, and the
> > >>> > > > discoverability
> > >>> > > > > could be improved. Some old tutorials have not been migrated
> > >>> just yet.
> > >>> > > > > - The nightly tests on tutorials have been disabled for now
> > >>> > > > > - There is no "Download jupyter notebook" for tutorials just
> > yet.
> > >>> > > > > - Non-python tutorials might benefit from a blurb description
> > and
> > >>> > > > > a
> > >>> > > > better
> > >>> > > > > content organization.
> > >>> > > > > - Python tutorials could be better organized, have a picture
> > >>> > > accompanying
> > >>> > > > > their description
> > >>> > > > > - There is no site-wide search, this is not an easy problem
> to
> > >>> > > > > solve to
> > >>> > > > be
> > >>> > > > > fair given the static nature of the website, but maybe an
> > >>> external
> > >>> > > plugin
> > >>> > > > > might be able to give a half-way solution
> > >>> > > > > - There is no version selector for the docs
> > >>> > > > > - There is bug in search box of the python docs, but this is
> > just
> > >>> > > > > a
> > >>> > > small
> > >>> > > > > JS bug that can be fixed easily (on my list for next week)
> > >>> > > > > - Most old links have not had a redirect put in place.
> > >>> > > > >
> > >>> > > > >
> > >>> > > > I noticed on the Ubuntu home page in the Developer dropdown
> that
> > >>> the
> > >>> > > > link MXNet on Ubuntu
> > >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> > >>> > > > >with
> > >>> > > > Nvidia
> > >>> > > > <
> > >>> > > >
> > >>> > >
> > >>>
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > >>> > > mxnet/
> > >>> > > > >
> > >>> > > > doesn't work anymore, it points to:
> > >>> > > > https://mxnet.incubator.apache.org/install/index.html
> > >>> > > >
> > >>> > > > Also, on the MXNet 'getting started' page
> > >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> > "Ubuntu
> > >>> > > > Installation Guide" at the bottom doesn't work either, it
> points
> > >>> to:
> > >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > >>> > > >
> > >>> > > >
> > >>> > > > I suggest you do a scan of the new website to find these
> dangling
> > >>> links.
> > >>> > > >
> > >>> > > > regards,
> > >>> > > >
> > >>> > > > Lieven
> > >>> > > >
> > >>> > > >
> > >>> > > >
> > >>> > > > > We'll formalize this in github issues next week, but they are
> > all
> > >>> > > fairly
> > >>> > > > > small and helping out on these would be a great way of
> > >>> > > > > familiarizing yourself with the new website build system and
> > >>> website
> > >>> > architecture.
> > >>> > > > >
> > >>> > > > >  Thanks all for the feedback, please keep it coming!
> > >>> > > > >
> > >>> > > > > Thomas Delteil
> > >>> > > > >
> > >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > >>> > > > > <ha...@gmail.com> a écrit :
> > >>> > > > >
> > >>> > > > > > It looks like my previous email did not go through.
> > Re-sending:
> > >>> > > > > >
> > >>> > > > > > Hi Aaron,
> > >>> > > > > >
> > >>> > > > > > The website looks cool. Thanks for pushing this to
> > production.
> > >>> A
> > >>> > > > > > few
> > >>> > > > > > questions:
> > >>> > > > > >
> > >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find
> > that
> > >>> > > > > > most operators under mx.sym.* are missing. Is this
> expected?
> > >>> > > > > > - I was also checking the search functionality, searching
> the
> > >>> > > > > > keyword "ndarray" only returns one result
> > >>> > > > > > "mxnet.ndarray.NDArray", which
> > >>> > > > doesn't
> > >>> > > > > > seem right. There animation keeps going (Searching. ->
> > >>> > > > > > Searching.. -> Searching ...) and gives me an impression
> that
> > >>> > > > > > the search is never completely done(?).
> > >>> > > > > >
> > >>> > > > > > Best,
> > >>> > > > > > Haibin
> > >>> > > > > >
> > >>> > > > > >
> > >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > >>> > > chai.bapat@gmail.com>
> > >>> > > > > > wrote:
> > >>> > > > > >
> > >>> > > > > > > Thanks Aaron and the team for launching new website!
> > >>> > > > > > >
> > >>> > > > > > > 1. There's no search button anywhere on the landing page.
> > >>> > > > > > > 2. I wasn't able to find FAQ (and without search button I
> > >>> dont
> > >>> > > > > > > have
> > >>> > > > > > option
> > >>> > > > > > > but to go manually on each menu). Only when I go to
> > >>> > > > > > > Docs&Tutorials
> > >>> > > ->
> > >>> > > > > FAQ
> > >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > >>> > > > > > >
> > >>> > > > > > > Suggestions
> > >>> > > > > > > Might want to make this searchable and pop FAQ on the
> main
> > >>> > > > > > > page (or somewhere prominent)
> > >>> > > > > > >
> > >>> > > > > > > Thanks,
> > >>> > > > > > > Chai
> > >>> > > > > > >
> > >>> > > > > > >
> > >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > >>> > > ptrendx@apache.org>
> > >>> > > > > > > wrote:
> > >>> > > > > > >
> > >>> > > > > > > > There seems to be a problem with (at least Python, did
> > not
> > >>> > > > > > > > check
> > >>> > > > > > others)
> > >>> > > > > > > > APIs. For example this page:
> > >>> > > > > > > >
> > >>> > > > > > > >
> > >>> > > > > > >
> > >>> > > > > >
> > >>> > > > >
> > >>> > > >
> > >>> > >
> > >>> >
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > >>> > > /mxnet.symbol.Symbol.argmax.html
> > >>> > > > > > > >
> > >>> > > > > > > > says that it is a convenience method for argmax (with a
> > >>> > > > > > > > link),
> > >>> > > but
> > >>> > > > > > > > clicking that link just points to the same website (and
> > so
> > >>> > > > > > > > user
> > >>> > > has
> > >>> > > > > no
> > >>> > > > > > > way
> > >>> > > > > > > > of getting to the docs of the actual operator).
> > >>> > > > > > > >
> > >>> > > > > > > > When I tried to manually remove Symbol from the URL to
> > get
> > >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found"
> webpage
> > >>> > > > > > > > which I
> > >>> > > guess
> > >>> > > > > > also
> > >>> > > > > > > > should not happen (ignoring the fact that this should
> > >>> exist,
> > >>> > > going
> > >>> > > > to
> > >>> > > > > > > > random URL under the website should redirect to the
> main
> > >>> > > > > > > > page I
> > >>> > > > > think).
> > >>> > > > > > > >
> > >>> > > > > > > > Przemek
> > >>> > > > > > > >
> > >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
> > >>> wrote:
> > >>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
> > >>> > > > > > > > > launching
> > >>> > > > > this!
> > >>> > > > > > > > >
> > >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > >>> > > > carinmeier@gmail.com>
> > >>> > > > > > > > wrote:
> > >>> > > > > > > > >
> > >>> > > > > > > > > > Nice!!! Congrats everyone!
> > >>> > > > > > > > > >
> > >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > >>> > > > > > > > aaron.s.markham@gmail.com>
> > >>> > > > > > > > > > wrote:
> > >>> > > > > > > > > >
> > >>> > > > > > > > > > > Alrighty! The new site is launched. You might
> need
> > to
> > >>> > > > > > > > > > > clear
> > >>> > > > > your
> > >>> > > > > > > > cache.
> > >>> > > > > > > > > > >
> > >>> > > > > > > > > > > Cheers,
> > >>> > > > > > > > > > > Aaron
> > >>> > > > > > > > > > >
> > >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > >>> > > > > > > > aaron.s.markham@gmail.com
> > >>> > > > > > > > > > >
> > >>> > > > > > > > > > > wrote:
> > >>> > > > > > > > > > > >
> > >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> > >>> > > > > > > > > > > > continue
> > >>> > > > > holding
> > >>> > > > > > > > off on
> > >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> > objections,
> > >>> > > > > > > > > > > > I'd
> > >>> > > > like
> > >>> > > > > to
> > >>> > > > > > > > launch
> > >>> > > > > > > > > > > > the new website today.
> > >>> > > > > > > > > > > >
> > >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > >>> > > > > > > > > > aaron.s.markham@gmail.com>
> > >>> > > > > > > > > > > wrote:
> > >>> > > > > > > > > > > > >
> > >>> > > > > > > > > > > > > Hi everyone,
> > >>> > > > > > > > > > > > > The last two PRs [1][2] for the new website
> and
> > >>> > > > > > > > > > > > > docs
> > >>> > > have
> > >>> > > > > > > passed
> > >>> > > > > > > > CI
> > >>> > > > > > > > > > > > > (finally). Please do not make changes to
> /docs
> > or
> > >>> > > > > > > > > > > > > /ci
> > >>> > > > until
> > >>> > > > > > we
> > >>> > > > > > > > get
> > >>> > > > > > > > > > > > > these approved and merged. Every time
> there's a
> > >>> > > > > > > > > > > > > merge
> > >>> > > > > > conflict
> > >>> > > > > > > > it has
> > >>> > > > > > > > > > > > > set us back a day or two while shepherding
> the
> > >>> PRs
> > >>> > > > through
> > >>> > > > > CI
> > >>> > > > > > > > again.
> > >>> > > > > > > > > > > > > Unless there are catastrophic issues
> discovered
> > >>> in
> > >>> > > > > > > > > > > > > a
> > >>> > > > > review,
> > >>> > > > > > I
> > >>> > > > > > > > > > > > > recommend that we hold any patches or updates
> > to
> > >>> > > > > > > > > > > > > the
> > >>> > > PRs
> > >>> > > > to
> > >>> > > > > > > > follow-up
> > >>> > > > > > > > > > > > > PRs.
> > >>> > > > > > > > > > > > >
> > >>> > > > > > > > > > > > > There are four steps to launch:
> > >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
> > >>> merge
> > >>> > > 15885
> > >>> > > > to
> > >>> > > > > > > > delete
> > >>> > > > > > > > > > the
> > >>> > > > > > > > > > > > > old content first.
> > >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the
> > new
> > >>> > > > > > > > > > > > > CI
> > >>> > > > flows
> > >>> > > > > > and
> > >>> > > > > > > > > > updates
> > >>> > > > > > > > > > > > > to the content Thomas and I have already had
> > >>> > > > > > > > > > > > > merged in
> > >>> > > > > 15884
> > >>> > > > > > > [3].
> > >>> > > > > > > > > > > > > 3. I will change the website validation
> Jenkins
> > >>> > > pipeline
> > >>> > > > to
> > >>> > > > > > > > point to
> > >>> > > > > > > > > > > > > the new pipeline.
> > >>> > > > > > > > > > > > > 4. I will change the website publishing
> Jenkins
> > >>> > > pipeline
> > >>> > > > to
> > >>> > > > > > > > point to
> > >>> > > > > > > > > > > > > its new pipeline as well. Once triggered, the
> > old
> > >>> > > > > > > > > > > > > site
> > >>> > > > will
> > >>> > > > > > be
> > >>> > > > > > > > > > > > > replaced with the new one.
> > >>> > > > > > > > > > > > >
> > >>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
> > >>> > > > beta.mxnet.io
> > >>> > > > > > to
> > >>> > > > > > > > point
> > >>> > > > > > > > > > to
> > >>> > > > > > > > > > > > > production, and there will likely be some
> > >>> > > > > redirect/.htaccess
> > >>> > > > > > > > updates
> > >>> > > > > > > > > > > > > needed next week to assist with any deep
> > linking
> > >>> > > > > > > > > > > > > and
> > >>> > > 404
> > >>> > > > > > issues
> > >>> > > > > > > > that
> > >>> > > > > > > > > > > > > pop up.
> > >>> > > > > > > > > > > > >
> > >>> > > > > > > > > > > > > Cheers,
> > >>> > > > > > > > > > > > > Aaron
> > >>> > > > > > > > > > > > >
> > >>> > > > > > > > > > > > > [1]
> > >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> > >>> > > > > > > > > > > > > [2]
> > >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> > >>> > > > > > > > > > > > > [3]
> > >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> > >>> > > > > > > > > > >
> > >>> > > > > > > > > >
> > >>> > > > > > > > >
> > >>> > > > > > > >
> > >>> > > > > > >
> > >>> > > > > > >
> > >>> > > > > > > --
> > >>> > > > > > > *Chaitanya Prakash Bapat*
> > >>> > > > > > > *+1 (973) 953-6299*
> > >>> > > > > > >
> > >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> > >>> > > > > > https://www.facebook.com/chaibapat
> > >>> > > > > > > ]
> > >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > >>> > > > > > > https://twitter.com/ChaiBapchya]
> > >>> > > > > > ><https://twitter.com/ChaiBapchya
> > >>> > > > > > >[image:
> > >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > >>> > > > > > >
> > >>> > > > > >
> > >>> > > > >
> > >>> > > >
> > >>> > >
> > >>>
> > >>
> >
>

Re: new website, docs code freeze

[Marco de Abreu <ma...@gmail.com>]

Good catch, Mu! Also good idea, Philip!

Aaron and Thomas, are you going to work on this?

-Marco

On Wed, Sep 25, 2019 at 1:28 AM Mu Li <mu...@gmail.com> wrote:

> The questions I found are:
>
> 1. Not ever page contains, especially the homepage
>
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
> 2. The correct tracking id is UA-96378503-1 instead of UA-96378503-11 in
>
> http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
>
> On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:
>
> > I think the reason is that the google tracker is not included in the new
> > website.
> >
> > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <ma...@gmail.com>
> > wrote:
> >
> >> Hello,
> >>
> >> I checked the Google Analytics statistics and the launch of the new
> >> website reduced the traffic by over 80%:
> >>
> >> [image: image.png]
> >>
> >> (Please let me know if the image is not visible)
> >>
> >> How shall we handle this?
> >>
> >> Best regards,
> >> Marco
> >>
> >> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> >> wrote:
> >>
> >>> For the install page [1], I suggest to add the selection of backend
> >>> DeepNumpy [2] which will be more clean.
> >>>
> >>> [1] http://mxnet.incubator.apache.org/index.html
> >>> [2] https://numpy.mxnet.io/#installation
> >>>
> >>>
> >>>
> >>> > -----Original Message-----
> >>> > From: kellen sunderland <ke...@gmail.com>
> >>> > Sent: Monday, September 23, 2019 12:47 PM
> >>> > To: dev@mxnet.incubator.apache.org
> >>> > Subject: Re: new website, docs code freeze
> >>> >
> >>> > New site looks good.  I do notice that a few tutorials from the old
> >>> site are
> >>> > missing (for example the TensorRT tutorial).  Any plans to bring them
> >>> back?
> >>> >
> >>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> haibin.lin.aws@gmail.com>
> >>> > wrote:
> >>> >
> >>> > > Another issue I found with the current website: the Sphinx object
> >>> > > inventory
> >>> > > <https://www.sphinx-
> >>> > doc.org/en/master/usage/extensions/intersphinx.htm
> >>> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
> >>> > > relies on this file to link document across projects. Shall we add
> it
> >>> > > back?
> >>> > >
> >>> > > Best,
> >>> > > Haibin
> >>> > >
> >>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
> >>> wrote:
> >>> > >
> >>> > > > Hi,
> >>> > > >
> >>> > > >
> >>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> >>> > > > <th...@gmail.com>
> >>> > > > wrote:
> >>> > > >
> >>> > > > > Thanks all for the feedback,
> >>> > > > >
> >>> > > > > We'll send an email next week with the list of missing
> features,
> >>> > > content
> >>> > > > > and bugs that we plan to fix.
> >>> > > > > We took the option of releasing early, with some features
> >>> missing,
> >>> > > rather
> >>> > > > > than trying to be at feature parity with the old website before
> >>> > > launching
> >>> > > > > the website.
> >>> > > > > The reason why we decided to do that is two-fold:
> >>> > > > > - playing catch-up with docs in master introduce daily
> conflicts
> >>> > > > > that
> >>> > > > need
> >>> > > > > to be resolved and introduce opportunity for errors
> >>> > > > > - by releasing early, we can take advantage of the community
> >>> > > > contributions
> >>> > > > > in modifying whatever the community feels like a better way of
> >>> > > > > doing things.
> >>> > > > >
> >>> > > > > One of the goals of the new website was to disentangle the main
> >>> > > website,
> >>> > > > > now called "static_site" to the auto-generated docs. Now the
> >>> > > > > overall
> >>> > > site
> >>> > > > > is made of a main static site, with easy to modify content and
> >>> > > > > easy to understand architecture for anybody familiar with basic
> >>> > > > > html, and a collection of mini-websites for each language
> >>> bindings
> >>> > > > > that can be
> >>> > > built
> >>> > > > in
> >>> > > > > isolation and that are self-contained. Actually the new CI jobs
> >>> > > > > builds
> >>> > > > all
> >>> > > > > of them in parallel independently.
> >>> > > > >
> >>> > > > > There is PLENTY of room for improvement, it would be great if
> the
> >>> > > > community
> >>> > > > > can help contribute to bring the new website at the same level
> of
> >>> > > content
> >>> > > > > richness as the old one, and then even further.
> >>> > > > >
> >>> > > > > Missing features:
> >>> > > > > - As pointed by Haibin, the API docs do not have the full list
> of
> >>> > > > operators
> >>> > > > > and classes. There is a mix of auto-generated docs based on
> >>> > > > > packages,
> >>> > > and
> >>> > > > > some docs that are spelled out manually to improve the logical
> >>> > > > organization
> >>> > > > > of the package where there is a need. The drawback with
> manually
> >>> > > > > listed classes in a package is that it's very easy to miss
> some.
> >>> > > > > If someone
> >>> > > > wanted
> >>> > > > > to build a sanity check that would automatically detect which
> >>> > > > > classes
> >>> > > are
> >>> > > > > not in the documentation, or if someone knew how to enable that
> >>> > > > > with sphinx, that would be a great addition to the python docs
> >>> > > > > - There is missing content in the python tutorials, and the
> >>> > > > discoverability
> >>> > > > > could be improved. Some old tutorials have not been migrated
> >>> just yet.
> >>> > > > > - The nightly tests on tutorials have been disabled for now
> >>> > > > > - There is no "Download jupyter notebook" for tutorials just
> yet.
> >>> > > > > - Non-python tutorials might benefit from a blurb description
> and
> >>> > > > > a
> >>> > > > better
> >>> > > > > content organization.
> >>> > > > > - Python tutorials could be better organized, have a picture
> >>> > > accompanying
> >>> > > > > their description
> >>> > > > > - There is no site-wide search, this is not an easy problem to
> >>> > > > > solve to
> >>> > > > be
> >>> > > > > fair given the static nature of the website, but maybe an
> >>> external
> >>> > > plugin
> >>> > > > > might be able to give a half-way solution
> >>> > > > > - There is no version selector for the docs
> >>> > > > > - There is bug in search box of the python docs, but this is
> just
> >>> > > > > a
> >>> > > small
> >>> > > > > JS bug that can be fixed easily (on my list for next week)
> >>> > > > > - Most old links have not had a redirect put in place.
> >>> > > > >
> >>> > > > >
> >>> > > > I noticed on the Ubuntu home page in the Developer dropdown that
> >>> the
> >>> > > > link MXNet on Ubuntu
> >>> > > > <https://mxnet.incubator.apache.org/install/index.html
> >>> > > > >with
> >>> > > > Nvidia
> >>> > > > <
> >>> > > >
> >>> > >
> >>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> >>> > > mxnet/
> >>> > > > >
> >>> > > > doesn't work anymore, it points to:
> >>> > > > https://mxnet.incubator.apache.org/install/index.html
> >>> > > >
> >>> > > > Also, on the MXNet 'getting started' page
> >>> > > > https://mxnet.incubator.apache.org/get_started , the link
> "Ubuntu
> >>> > > > Installation Guide" at the bottom doesn't work either, it points
> >>> to:
> >>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> >>> > > >
> >>> > > >
> >>> > > > I suggest you do a scan of the new website to find these dangling
> >>> links.
> >>> > > >
> >>> > > > regards,
> >>> > > >
> >>> > > > Lieven
> >>> > > >
> >>> > > >
> >>> > > >
> >>> > > > > We'll formalize this in github issues next week, but they are
> all
> >>> > > fairly
> >>> > > > > small and helping out on these would be a great way of
> >>> > > > > familiarizing yourself with the new website build system and
> >>> website
> >>> > architecture.
> >>> > > > >
> >>> > > > >  Thanks all for the feedback, please keep it coming!
> >>> > > > >
> >>> > > > > Thomas Delteil
> >>> > > > >
> >>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> >>> > > > > <ha...@gmail.com> a écrit :
> >>> > > > >
> >>> > > > > > It looks like my previous email did not go through.
> Re-sending:
> >>> > > > > >
> >>> > > > > > Hi Aaron,
> >>> > > > > >
> >>> > > > > > The website looks cool. Thanks for pushing this to
> production.
> >>> A
> >>> > > > > > few
> >>> > > > > > questions:
> >>> > > > > >
> >>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find
> that
> >>> > > > > > most operators under mx.sym.* are missing. Is this expected?
> >>> > > > > > - I was also checking the search functionality, searching the
> >>> > > > > > keyword "ndarray" only returns one result
> >>> > > > > > "mxnet.ndarray.NDArray", which
> >>> > > > doesn't
> >>> > > > > > seem right. There animation keeps going (Searching. ->
> >>> > > > > > Searching.. -> Searching ...) and gives me an impression that
> >>> > > > > > the search is never completely done(?).
> >>> > > > > >
> >>> > > > > > Best,
> >>> > > > > > Haibin
> >>> > > > > >
> >>> > > > > >
> >>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> >>> > > chai.bapat@gmail.com>
> >>> > > > > > wrote:
> >>> > > > > >
> >>> > > > > > > Thanks Aaron and the team for launching new website!
> >>> > > > > > >
> >>> > > > > > > 1. There's no search button anywhere on the landing page.
> >>> > > > > > > 2. I wasn't able to find FAQ (and without search button I
> >>> dont
> >>> > > > > > > have
> >>> > > > > > option
> >>> > > > > > > but to go manually on each menu). Only when I go to
> >>> > > > > > > Docs&Tutorials
> >>> > > ->
> >>> > > > > FAQ
> >>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> >>> > > > > > >
> >>> > > > > > > Suggestions
> >>> > > > > > > Might want to make this searchable and pop FAQ on the main
> >>> > > > > > > page (or somewhere prominent)
> >>> > > > > > >
> >>> > > > > > > Thanks,
> >>> > > > > > > Chai
> >>> > > > > > >
> >>> > > > > > >
> >>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> >>> > > ptrendx@apache.org>
> >>> > > > > > > wrote:
> >>> > > > > > >
> >>> > > > > > > > There seems to be a problem with (at least Python, did
> not
> >>> > > > > > > > check
> >>> > > > > > others)
> >>> > > > > > > > APIs. For example this page:
> >>> > > > > > > >
> >>> > > > > > > >
> >>> > > > > > >
> >>> > > > > >
> >>> > > > >
> >>> > > >
> >>> > >
> >>> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> >>> > > /mxnet.symbol.Symbol.argmax.html
> >>> > > > > > > >
> >>> > > > > > > > says that it is a convenience method for argmax (with a
> >>> > > > > > > > link),
> >>> > > but
> >>> > > > > > > > clicking that link just points to the same website (and
> so
> >>> > > > > > > > user
> >>> > > has
> >>> > > > > no
> >>> > > > > > > way
> >>> > > > > > > > of getting to the docs of the actual operator).
> >>> > > > > > > >
> >>> > > > > > > > When I tried to manually remove Symbol from the URL to
> get
> >>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
> >>> > > > > > > > which I
> >>> > > guess
> >>> > > > > > also
> >>> > > > > > > > should not happen (ignoring the fact that this should
> >>> exist,
> >>> > > going
> >>> > > > to
> >>> > > > > > > > random URL under the website should redirect to the main
> >>> > > > > > > > page I
> >>> > > > > think).
> >>> > > > > > > >
> >>> > > > > > > > Przemek
> >>> > > > > > > >
> >>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
> >>> wrote:
> >>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
> >>> > > > > > > > > launching
> >>> > > > > this!
> >>> > > > > > > > >
> >>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> >>> > > > carinmeier@gmail.com>
> >>> > > > > > > > wrote:
> >>> > > > > > > > >
> >>> > > > > > > > > > Nice!!! Congrats everyone!
> >>> > > > > > > > > >
> >>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> >>> > > > > > > > aaron.s.markham@gmail.com>
> >>> > > > > > > > > > wrote:
> >>> > > > > > > > > >
> >>> > > > > > > > > > > Alrighty! The new site is launched. You might need
> to
> >>> > > > > > > > > > > clear
> >>> > > > > your
> >>> > > > > > > > cache.
> >>> > > > > > > > > > >
> >>> > > > > > > > > > > Cheers,
> >>> > > > > > > > > > > Aaron
> >>> > > > > > > > > > >
> >>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> >>> > > > > > > > aaron.s.markham@gmail.com
> >>> > > > > > > > > > >
> >>> > > > > > > > > > > wrote:
> >>> > > > > > > > > > > >
> >>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> >>> > > > > > > > > > > > continue
> >>> > > > > holding
> >>> > > > > > > > off on
> >>> > > > > > > > > > > > docs and CI edits. Unless there are any
> objections,
> >>> > > > > > > > > > > > I'd
> >>> > > > like
> >>> > > > > to
> >>> > > > > > > > launch
> >>> > > > > > > > > > > > the new website today.
> >>> > > > > > > > > > > >
> >>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> >>> > > > > > > > > > aaron.s.markham@gmail.com>
> >>> > > > > > > > > > > wrote:
> >>> > > > > > > > > > > > >
> >>> > > > > > > > > > > > > Hi everyone,
> >>> > > > > > > > > > > > > The last two PRs [1][2] for the new website and
> >>> > > > > > > > > > > > > docs
> >>> > > have
> >>> > > > > > > passed
> >>> > > > > > > > CI
> >>> > > > > > > > > > > > > (finally). Please do not make changes to /docs
> or
> >>> > > > > > > > > > > > > /ci
> >>> > > > until
> >>> > > > > > we
> >>> > > > > > > > get
> >>> > > > > > > > > > > > > these approved and merged. Every time there's a
> >>> > > > > > > > > > > > > merge
> >>> > > > > > conflict
> >>> > > > > > > > it has
> >>> > > > > > > > > > > > > set us back a day or two while shepherding the
> >>> PRs
> >>> > > > through
> >>> > > > > CI
> >>> > > > > > > > again.
> >>> > > > > > > > > > > > > Unless there are catastrophic issues discovered
> >>> in
> >>> > > > > > > > > > > > > a
> >>> > > > > review,
> >>> > > > > > I
> >>> > > > > > > > > > > > > recommend that we hold any patches or updates
> to
> >>> > > > > > > > > > > > > the
> >>> > > PRs
> >>> > > > to
> >>> > > > > > > > follow-up
> >>> > > > > > > > > > > > > PRs.
> >>> > > > > > > > > > > > >
> >>> > > > > > > > > > > > > There are four steps to launch:
> >>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
> >>> merge
> >>> > > 15885
> >>> > > > to
> >>> > > > > > > > delete
> >>> > > > > > > > > > the
> >>> > > > > > > > > > > > > old content first.
> >>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the
> new
> >>> > > > > > > > > > > > > CI
> >>> > > > flows
> >>> > > > > > and
> >>> > > > > > > > > > updates
> >>> > > > > > > > > > > > > to the content Thomas and I have already had
> >>> > > > > > > > > > > > > merged in
> >>> > > > > 15884
> >>> > > > > > > [3].
> >>> > > > > > > > > > > > > 3. I will change the website validation Jenkins
> >>> > > pipeline
> >>> > > > to
> >>> > > > > > > > point to
> >>> > > > > > > > > > > > > the new pipeline.
> >>> > > > > > > > > > > > > 4. I will change the website publishing Jenkins
> >>> > > pipeline
> >>> > > > to
> >>> > > > > > > > point to
> >>> > > > > > > > > > > > > its new pipeline as well. Once triggered, the
> old
> >>> > > > > > > > > > > > > site
> >>> > > > will
> >>> > > > > > be
> >>> > > > > > > > > > > > > replaced with the new one.
> >>> > > > > > > > > > > > >
> >>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
> >>> > > > beta.mxnet.io
> >>> > > > > > to
> >>> > > > > > > > point
> >>> > > > > > > > > > to
> >>> > > > > > > > > > > > > production, and there will likely be some
> >>> > > > > redirect/.htaccess
> >>> > > > > > > > updates
> >>> > > > > > > > > > > > > needed next week to assist with any deep
> linking
> >>> > > > > > > > > > > > > and
> >>> > > 404
> >>> > > > > > issues
> >>> > > > > > > > that
> >>> > > > > > > > > > > > > pop up.
> >>> > > > > > > > > > > > >
> >>> > > > > > > > > > > > > Cheers,
> >>> > > > > > > > > > > > > Aaron
> >>> > > > > > > > > > > > >
> >>> > > > > > > > > > > > > [1]
> >>> > > https://github.com/apache/incubator-mxnet/pull/15885
> >>> > > > > > > > > > > > > [2]
> >>> > > https://github.com/apache/incubator-mxnet/pull/15883
> >>> > > > > > > > > > > > > [3]
> >>> > > https://github.com/apache/incubator-mxnet/pull/15884
> >>> > > > > > > > > > >
> >>> > > > > > > > > >
> >>> > > > > > > > >
> >>> > > > > > > >
> >>> > > > > > >
> >>> > > > > > >
> >>> > > > > > > --
> >>> > > > > > > *Chaitanya Prakash Bapat*
> >>> > > > > > > *+1 (973) 953-6299*
> >>> > > > > > >
> >>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> >>> > > > > > > <https://github.com/ChaiBapchya>[image:
> >>> > > > > > https://www.facebook.com/chaibapat
> >>> > > > > > > ]
> >>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> >>> > > > > > > https://twitter.com/ChaiBapchya]
> >>> > > > > > ><https://twitter.com/ChaiBapchya
> >>> > > > > > >[image:
> >>> > > > > > > https://www.linkedin.com//in/chaibapat25]
> >>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> >>> > > > > > >
> >>> > > > > >
> >>> > > > >
> >>> > > >
> >>> > >
> >>>
> >>
>

Re: new website, docs code freeze

[Mu Li <mu...@gmail.com>]

The questions I found are:

1. Not ever page contains, especially the homepage
http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js
2. The correct tracking id is UA-96378503-1 instead of UA-96378503-11 in
http://mxnet.incubator.apache.org/api/python/docs/_static/google_analytics.js

On Tue, Sep 24, 2019 at 4:23 PM Mu Li <mu...@gmail.com> wrote:

> I think the reason is that the google tracker is not included in the new
> website.
>
> On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <ma...@gmail.com>
> wrote:
>
>> Hello,
>>
>> I checked the Google Analytics statistics and the launch of the new
>> website reduced the traffic by over 80%:
>>
>> [image: image.png]
>>
>> (Please let me know if the image is not visible)
>>
>> How shall we handle this?
>>
>> Best regards,
>> Marco
>>
>> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
>> wrote:
>>
>>> For the install page [1], I suggest to add the selection of backend
>>> DeepNumpy [2] which will be more clean.
>>>
>>> [1] http://mxnet.incubator.apache.org/index.html
>>> [2] https://numpy.mxnet.io/#installation
>>>
>>>
>>>
>>> > -----Original Message-----
>>> > From: kellen sunderland <ke...@gmail.com>
>>> > Sent: Monday, September 23, 2019 12:47 PM
>>> > To: dev@mxnet.incubator.apache.org
>>> > Subject: Re: new website, docs code freeze
>>> >
>>> > New site looks good.  I do notice that a few tutorials from the old
>>> site are
>>> > missing (for example the TensorRT tutorial).  Any plans to bring them
>>> back?
>>> >
>>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <ha...@gmail.com>
>>> > wrote:
>>> >
>>> > > Another issue I found with the current website: the Sphinx object
>>> > > inventory
>>> > > <https://www.sphinx-
>>> > doc.org/en/master/usage/extensions/intersphinx.htm
>>> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
>>> > > relies on this file to link document across projects. Shall we add it
>>> > > back?
>>> > >
>>> > > Best,
>>> > > Haibin
>>> > >
>>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
>>> wrote:
>>> > >
>>> > > > Hi,
>>> > > >
>>> > > >
>>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
>>> > > > <th...@gmail.com>
>>> > > > wrote:
>>> > > >
>>> > > > > Thanks all for the feedback,
>>> > > > >
>>> > > > > We'll send an email next week with the list of missing features,
>>> > > content
>>> > > > > and bugs that we plan to fix.
>>> > > > > We took the option of releasing early, with some features
>>> missing,
>>> > > rather
>>> > > > > than trying to be at feature parity with the old website before
>>> > > launching
>>> > > > > the website.
>>> > > > > The reason why we decided to do that is two-fold:
>>> > > > > - playing catch-up with docs in master introduce daily conflicts
>>> > > > > that
>>> > > > need
>>> > > > > to be resolved and introduce opportunity for errors
>>> > > > > - by releasing early, we can take advantage of the community
>>> > > > contributions
>>> > > > > in modifying whatever the community feels like a better way of
>>> > > > > doing things.
>>> > > > >
>>> > > > > One of the goals of the new website was to disentangle the main
>>> > > website,
>>> > > > > now called "static_site" to the auto-generated docs. Now the
>>> > > > > overall
>>> > > site
>>> > > > > is made of a main static site, with easy to modify content and
>>> > > > > easy to understand architecture for anybody familiar with basic
>>> > > > > html, and a collection of mini-websites for each language
>>> bindings
>>> > > > > that can be
>>> > > built
>>> > > > in
>>> > > > > isolation and that are self-contained. Actually the new CI jobs
>>> > > > > builds
>>> > > > all
>>> > > > > of them in parallel independently.
>>> > > > >
>>> > > > > There is PLENTY of room for improvement, it would be great if the
>>> > > > community
>>> > > > > can help contribute to bring the new website at the same level of
>>> > > content
>>> > > > > richness as the old one, and then even further.
>>> > > > >
>>> > > > > Missing features:
>>> > > > > - As pointed by Haibin, the API docs do not have the full list of
>>> > > > operators
>>> > > > > and classes. There is a mix of auto-generated docs based on
>>> > > > > packages,
>>> > > and
>>> > > > > some docs that are spelled out manually to improve the logical
>>> > > > organization
>>> > > > > of the package where there is a need. The drawback with manually
>>> > > > > listed classes in a package is that it's very easy to miss some.
>>> > > > > If someone
>>> > > > wanted
>>> > > > > to build a sanity check that would automatically detect which
>>> > > > > classes
>>> > > are
>>> > > > > not in the documentation, or if someone knew how to enable that
>>> > > > > with sphinx, that would be a great addition to the python docs
>>> > > > > - There is missing content in the python tutorials, and the
>>> > > > discoverability
>>> > > > > could be improved. Some old tutorials have not been migrated
>>> just yet.
>>> > > > > - The nightly tests on tutorials have been disabled for now
>>> > > > > - There is no "Download jupyter notebook" for tutorials just yet.
>>> > > > > - Non-python tutorials might benefit from a blurb description and
>>> > > > > a
>>> > > > better
>>> > > > > content organization.
>>> > > > > - Python tutorials could be better organized, have a picture
>>> > > accompanying
>>> > > > > their description
>>> > > > > - There is no site-wide search, this is not an easy problem to
>>> > > > > solve to
>>> > > > be
>>> > > > > fair given the static nature of the website, but maybe an
>>> external
>>> > > plugin
>>> > > > > might be able to give a half-way solution
>>> > > > > - There is no version selector for the docs
>>> > > > > - There is bug in search box of the python docs, but this is just
>>> > > > > a
>>> > > small
>>> > > > > JS bug that can be fixed easily (on my list for next week)
>>> > > > > - Most old links have not had a redirect put in place.
>>> > > > >
>>> > > > >
>>> > > > I noticed on the Ubuntu home page in the Developer dropdown that
>>> the
>>> > > > link MXNet on Ubuntu
>>> > > > <https://mxnet.incubator.apache.org/install/index.html
>>> > > > >with
>>> > > > Nvidia
>>> > > > <
>>> > > >
>>> > >
>>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
>>> > > mxnet/
>>> > > > >
>>> > > > doesn't work anymore, it points to:
>>> > > > https://mxnet.incubator.apache.org/install/index.html
>>> > > >
>>> > > > Also, on the MXNet 'getting started' page
>>> > > > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
>>> > > > Installation Guide" at the bottom doesn't work either, it points
>>> to:
>>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
>>> > > >
>>> > > >
>>> > > > I suggest you do a scan of the new website to find these dangling
>>> links.
>>> > > >
>>> > > > regards,
>>> > > >
>>> > > > Lieven
>>> > > >
>>> > > >
>>> > > >
>>> > > > > We'll formalize this in github issues next week, but they are all
>>> > > fairly
>>> > > > > small and helping out on these would be a great way of
>>> > > > > familiarizing yourself with the new website build system and
>>> website
>>> > architecture.
>>> > > > >
>>> > > > >  Thanks all for the feedback, please keep it coming!
>>> > > > >
>>> > > > > Thomas Delteil
>>> > > > >
>>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>>> > > > > <ha...@gmail.com> a écrit :
>>> > > > >
>>> > > > > > It looks like my previous email did not go through. Re-sending:
>>> > > > > >
>>> > > > > > Hi Aaron,
>>> > > > > >
>>> > > > > > The website looks cool. Thanks for pushing this to production.
>>> A
>>> > > > > > few
>>> > > > > > questions:
>>> > > > > >
>>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find that
>>> > > > > > most operators under mx.sym.* are missing. Is this expected?
>>> > > > > > - I was also checking the search functionality, searching the
>>> > > > > > keyword "ndarray" only returns one result
>>> > > > > > "mxnet.ndarray.NDArray", which
>>> > > > doesn't
>>> > > > > > seem right. There animation keeps going (Searching. ->
>>> > > > > > Searching.. -> Searching ...) and gives me an impression that
>>> > > > > > the search is never completely done(?).
>>> > > > > >
>>> > > > > > Best,
>>> > > > > > Haibin
>>> > > > > >
>>> > > > > >
>>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
>>> > > chai.bapat@gmail.com>
>>> > > > > > wrote:
>>> > > > > >
>>> > > > > > > Thanks Aaron and the team for launching new website!
>>> > > > > > >
>>> > > > > > > 1. There's no search button anywhere on the landing page.
>>> > > > > > > 2. I wasn't able to find FAQ (and without search button I
>>> dont
>>> > > > > > > have
>>> > > > > > option
>>> > > > > > > but to go manually on each menu). Only when I go to
>>> > > > > > > Docs&Tutorials
>>> > > ->
>>> > > > > FAQ
>>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
>>> > > > > > >
>>> > > > > > > Suggestions
>>> > > > > > > Might want to make this searchable and pop FAQ on the main
>>> > > > > > > page (or somewhere prominent)
>>> > > > > > >
>>> > > > > > > Thanks,
>>> > > > > > > Chai
>>> > > > > > >
>>> > > > > > >
>>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
>>> > > ptrendx@apache.org>
>>> > > > > > > wrote:
>>> > > > > > >
>>> > > > > > > > There seems to be a problem with (at least Python, did not
>>> > > > > > > > check
>>> > > > > > others)
>>> > > > > > > > APIs. For example this page:
>>> > > > > > > >
>>> > > > > > > >
>>> > > > > > >
>>> > > > > >
>>> > > > >
>>> > > >
>>> > >
>>> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
>>> > > /mxnet.symbol.Symbol.argmax.html
>>> > > > > > > >
>>> > > > > > > > says that it is a convenience method for argmax (with a
>>> > > > > > > > link),
>>> > > but
>>> > > > > > > > clicking that link just points to the same website (and so
>>> > > > > > > > user
>>> > > has
>>> > > > > no
>>> > > > > > > way
>>> > > > > > > > of getting to the docs of the actual operator).
>>> > > > > > > >
>>> > > > > > > > When I tried to manually remove Symbol from the URL to get
>>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
>>> > > > > > > > which I
>>> > > guess
>>> > > > > > also
>>> > > > > > > > should not happen (ignoring the fact that this should
>>> exist,
>>> > > going
>>> > > > to
>>> > > > > > > > random URL under the website should redirect to the main
>>> > > > > > > > page I
>>> > > > > think).
>>> > > > > > > >
>>> > > > > > > > Przemek
>>> > > > > > > >
>>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
>>> wrote:
>>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
>>> > > > > > > > > launching
>>> > > > > this!
>>> > > > > > > > >
>>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
>>> > > > carinmeier@gmail.com>
>>> > > > > > > > wrote:
>>> > > > > > > > >
>>> > > > > > > > > > Nice!!! Congrats everyone!
>>> > > > > > > > > >
>>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
>>> > > > > > > > aaron.s.markham@gmail.com>
>>> > > > > > > > > > wrote:
>>> > > > > > > > > >
>>> > > > > > > > > > > Alrighty! The new site is launched. You might need to
>>> > > > > > > > > > > clear
>>> > > > > your
>>> > > > > > > > cache.
>>> > > > > > > > > > >
>>> > > > > > > > > > > Cheers,
>>> > > > > > > > > > > Aaron
>>> > > > > > > > > > >
>>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
>>> > > > > > > > aaron.s.markham@gmail.com
>>> > > > > > > > > > >
>>> > > > > > > > > > > wrote:
>>> > > > > > > > > > > >
>>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
>>> > > > > > > > > > > > continue
>>> > > > > holding
>>> > > > > > > > off on
>>> > > > > > > > > > > > docs and CI edits. Unless there are any objections,
>>> > > > > > > > > > > > I'd
>>> > > > like
>>> > > > > to
>>> > > > > > > > launch
>>> > > > > > > > > > > > the new website today.
>>> > > > > > > > > > > >
>>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
>>> > > > > > > > > > aaron.s.markham@gmail.com>
>>> > > > > > > > > > > wrote:
>>> > > > > > > > > > > > >
>>> > > > > > > > > > > > > Hi everyone,
>>> > > > > > > > > > > > > The last two PRs [1][2] for the new website and
>>> > > > > > > > > > > > > docs
>>> > > have
>>> > > > > > > passed
>>> > > > > > > > CI
>>> > > > > > > > > > > > > (finally). Please do not make changes to /docs or
>>> > > > > > > > > > > > > /ci
>>> > > > until
>>> > > > > > we
>>> > > > > > > > get
>>> > > > > > > > > > > > > these approved and merged. Every time there's a
>>> > > > > > > > > > > > > merge
>>> > > > > > conflict
>>> > > > > > > > it has
>>> > > > > > > > > > > > > set us back a day or two while shepherding the
>>> PRs
>>> > > > through
>>> > > > > CI
>>> > > > > > > > again.
>>> > > > > > > > > > > > > Unless there are catastrophic issues discovered
>>> in
>>> > > > > > > > > > > > > a
>>> > > > > review,
>>> > > > > > I
>>> > > > > > > > > > > > > recommend that we hold any patches or updates to
>>> > > > > > > > > > > > > the
>>> > > PRs
>>> > > > to
>>> > > > > > > > follow-up
>>> > > > > > > > > > > > > PRs.
>>> > > > > > > > > > > > >
>>> > > > > > > > > > > > > There are four steps to launch:
>>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
>>> merge
>>> > > 15885
>>> > > > to
>>> > > > > > > > delete
>>> > > > > > > > > > the
>>> > > > > > > > > > > > > old content first.
>>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the new
>>> > > > > > > > > > > > > CI
>>> > > > flows
>>> > > > > > and
>>> > > > > > > > > > updates
>>> > > > > > > > > > > > > to the content Thomas and I have already had
>>> > > > > > > > > > > > > merged in
>>> > > > > 15884
>>> > > > > > > [3].
>>> > > > > > > > > > > > > 3. I will change the website validation Jenkins
>>> > > pipeline
>>> > > > to
>>> > > > > > > > point to
>>> > > > > > > > > > > > > the new pipeline.
>>> > > > > > > > > > > > > 4. I will change the website publishing Jenkins
>>> > > pipeline
>>> > > > to
>>> > > > > > > > point to
>>> > > > > > > > > > > > > its new pipeline as well. Once triggered, the old
>>> > > > > > > > > > > > > site
>>> > > > will
>>> > > > > > be
>>> > > > > > > > > > > > > replaced with the new one.
>>> > > > > > > > > > > > >
>>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
>>> > > > beta.mxnet.io
>>> > > > > > to
>>> > > > > > > > point
>>> > > > > > > > > > to
>>> > > > > > > > > > > > > production, and there will likely be some
>>> > > > > redirect/.htaccess
>>> > > > > > > > updates
>>> > > > > > > > > > > > > needed next week to assist with any deep linking
>>> > > > > > > > > > > > > and
>>> > > 404
>>> > > > > > issues
>>> > > > > > > > that
>>> > > > > > > > > > > > > pop up.
>>> > > > > > > > > > > > >
>>> > > > > > > > > > > > > Cheers,
>>> > > > > > > > > > > > > Aaron
>>> > > > > > > > > > > > >
>>> > > > > > > > > > > > > [1]
>>> > > https://github.com/apache/incubator-mxnet/pull/15885
>>> > > > > > > > > > > > > [2]
>>> > > https://github.com/apache/incubator-mxnet/pull/15883
>>> > > > > > > > > > > > > [3]
>>> > > https://github.com/apache/incubator-mxnet/pull/15884
>>> > > > > > > > > > >
>>> > > > > > > > > >
>>> > > > > > > > >
>>> > > > > > > >
>>> > > > > > >
>>> > > > > > >
>>> > > > > > > --
>>> > > > > > > *Chaitanya Prakash Bapat*
>>> > > > > > > *+1 (973) 953-6299*
>>> > > > > > >
>>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
>>> > > > > > > <https://github.com/ChaiBapchya>[image:
>>> > > > > > https://www.facebook.com/chaibapat
>>> > > > > > > ]
>>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
>>> > > > > > > https://twitter.com/ChaiBapchya]
>>> > > > > > ><https://twitter.com/ChaiBapchya
>>> > > > > > >[image:
>>> > > > > > > https://www.linkedin.com//in/chaibapat25]
>>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
>>> > > > > > >
>>> > > > > >
>>> > > > >
>>> > > >
>>> > >
>>>
>>

Re: new website, docs code freeze

[Mu Li <mu...@gmail.com>]

I think the reason is that the google tracker is not included in the new
website.

On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <ma...@gmail.com>
wrote:

> Hello,
>
> I checked the Google Analytics statistics and the launch of the new
> website reduced the traffic by over 80%:
>
> [image: image.png]
>
> (Please let me know if the image is not visible)
>
> How shall we handle this?
>
> Best regards,
> Marco
>
> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> wrote:
>
>> For the install page [1], I suggest to add the selection of backend
>> DeepNumpy [2] which will be more clean.
>>
>> [1] http://mxnet.incubator.apache.org/index.html
>> [2] https://numpy.mxnet.io/#installation
>>
>>
>>
>> > -----Original Message-----
>> > From: kellen sunderland <ke...@gmail.com>
>> > Sent: Monday, September 23, 2019 12:47 PM
>> > To: dev@mxnet.incubator.apache.org
>> > Subject: Re: new website, docs code freeze
>> >
>> > New site looks good.  I do notice that a few tutorials from the old
>> site are
>> > missing (for example the TensorRT tutorial).  Any plans to bring them
>> back?
>> >
>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <ha...@gmail.com>
>> > wrote:
>> >
>> > > Another issue I found with the current website: the Sphinx object
>> > > inventory
>> > > <https://www.sphinx-
>> > doc.org/en/master/usage/extensions/intersphinx.htm
>> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
>> > > relies on this file to link document across projects. Shall we add it
>> > > back?
>> > >
>> > > Best,
>> > > Haibin
>> > >
>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
>> wrote:
>> > >
>> > > > Hi,
>> > > >
>> > > >
>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
>> > > > <th...@gmail.com>
>> > > > wrote:
>> > > >
>> > > > > Thanks all for the feedback,
>> > > > >
>> > > > > We'll send an email next week with the list of missing features,
>> > > content
>> > > > > and bugs that we plan to fix.
>> > > > > We took the option of releasing early, with some features missing,
>> > > rather
>> > > > > than trying to be at feature parity with the old website before
>> > > launching
>> > > > > the website.
>> > > > > The reason why we decided to do that is two-fold:
>> > > > > - playing catch-up with docs in master introduce daily conflicts
>> > > > > that
>> > > > need
>> > > > > to be resolved and introduce opportunity for errors
>> > > > > - by releasing early, we can take advantage of the community
>> > > > contributions
>> > > > > in modifying whatever the community feels like a better way of
>> > > > > doing things.
>> > > > >
>> > > > > One of the goals of the new website was to disentangle the main
>> > > website,
>> > > > > now called "static_site" to the auto-generated docs. Now the
>> > > > > overall
>> > > site
>> > > > > is made of a main static site, with easy to modify content and
>> > > > > easy to understand architecture for anybody familiar with basic
>> > > > > html, and a collection of mini-websites for each language bindings
>> > > > > that can be
>> > > built
>> > > > in
>> > > > > isolation and that are self-contained. Actually the new CI jobs
>> > > > > builds
>> > > > all
>> > > > > of them in parallel independently.
>> > > > >
>> > > > > There is PLENTY of room for improvement, it would be great if the
>> > > > community
>> > > > > can help contribute to bring the new website at the same level of
>> > > content
>> > > > > richness as the old one, and then even further.
>> > > > >
>> > > > > Missing features:
>> > > > > - As pointed by Haibin, the API docs do not have the full list of
>> > > > operators
>> > > > > and classes. There is a mix of auto-generated docs based on
>> > > > > packages,
>> > > and
>> > > > > some docs that are spelled out manually to improve the logical
>> > > > organization
>> > > > > of the package where there is a need. The drawback with manually
>> > > > > listed classes in a package is that it's very easy to miss some.
>> > > > > If someone
>> > > > wanted
>> > > > > to build a sanity check that would automatically detect which
>> > > > > classes
>> > > are
>> > > > > not in the documentation, or if someone knew how to enable that
>> > > > > with sphinx, that would be a great addition to the python docs
>> > > > > - There is missing content in the python tutorials, and the
>> > > > discoverability
>> > > > > could be improved. Some old tutorials have not been migrated just
>> yet.
>> > > > > - The nightly tests on tutorials have been disabled for now
>> > > > > - There is no "Download jupyter notebook" for tutorials just yet.
>> > > > > - Non-python tutorials might benefit from a blurb description and
>> > > > > a
>> > > > better
>> > > > > content organization.
>> > > > > - Python tutorials could be better organized, have a picture
>> > > accompanying
>> > > > > their description
>> > > > > - There is no site-wide search, this is not an easy problem to
>> > > > > solve to
>> > > > be
>> > > > > fair given the static nature of the website, but maybe an external
>> > > plugin
>> > > > > might be able to give a half-way solution
>> > > > > - There is no version selector for the docs
>> > > > > - There is bug in search box of the python docs, but this is just
>> > > > > a
>> > > small
>> > > > > JS bug that can be fixed easily (on my list for next week)
>> > > > > - Most old links have not had a redirect put in place.
>> > > > >
>> > > > >
>> > > > I noticed on the Ubuntu home page in the Developer dropdown that the
>> > > > link MXNet on Ubuntu
>> > > > <https://mxnet.incubator.apache.org/install/index.html
>> > > > >with
>> > > > Nvidia
>> > > > <
>> > > >
>> > >
>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
>> > > mxnet/
>> > > > >
>> > > > doesn't work anymore, it points to:
>> > > > https://mxnet.incubator.apache.org/install/index.html
>> > > >
>> > > > Also, on the MXNet 'getting started' page
>> > > > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
>> > > > Installation Guide" at the bottom doesn't work either, it points to:
>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
>> > > >
>> > > >
>> > > > I suggest you do a scan of the new website to find these dangling
>> links.
>> > > >
>> > > > regards,
>> > > >
>> > > > Lieven
>> > > >
>> > > >
>> > > >
>> > > > > We'll formalize this in github issues next week, but they are all
>> > > fairly
>> > > > > small and helping out on these would be a great way of
>> > > > > familiarizing yourself with the new website build system and
>> website
>> > architecture.
>> > > > >
>> > > > >  Thanks all for the feedback, please keep it coming!
>> > > > >
>> > > > > Thomas Delteil
>> > > > >
>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>> > > > > <ha...@gmail.com> a écrit :
>> > > > >
>> > > > > > It looks like my previous email did not go through. Re-sending:
>> > > > > >
>> > > > > > Hi Aaron,
>> > > > > >
>> > > > > > The website looks cool. Thanks for pushing this to production. A
>> > > > > > few
>> > > > > > questions:
>> > > > > >
>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find that
>> > > > > > most operators under mx.sym.* are missing. Is this expected?
>> > > > > > - I was also checking the search functionality, searching the
>> > > > > > keyword "ndarray" only returns one result
>> > > > > > "mxnet.ndarray.NDArray", which
>> > > > doesn't
>> > > > > > seem right. There animation keeps going (Searching. ->
>> > > > > > Searching.. -> Searching ...) and gives me an impression that
>> > > > > > the search is never completely done(?).
>> > > > > >
>> > > > > > Best,
>> > > > > > Haibin
>> > > > > >
>> > > > > >
>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
>> > > chai.bapat@gmail.com>
>> > > > > > wrote:
>> > > > > >
>> > > > > > > Thanks Aaron and the team for launching new website!
>> > > > > > >
>> > > > > > > 1. There's no search button anywhere on the landing page.
>> > > > > > > 2. I wasn't able to find FAQ (and without search button I dont
>> > > > > > > have
>> > > > > > option
>> > > > > > > but to go manually on each menu). Only when I go to
>> > > > > > > Docs&Tutorials
>> > > ->
>> > > > > FAQ
>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
>> > > > > > >
>> > > > > > > Suggestions
>> > > > > > > Might want to make this searchable and pop FAQ on the main
>> > > > > > > page (or somewhere prominent)
>> > > > > > >
>> > > > > > > Thanks,
>> > > > > > > Chai
>> > > > > > >
>> > > > > > >
>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
>> > > ptrendx@apache.org>
>> > > > > > > wrote:
>> > > > > > >
>> > > > > > > > There seems to be a problem with (at least Python, did not
>> > > > > > > > check
>> > > > > > others)
>> > > > > > > > APIs. For example this page:
>> > > > > > > >
>> > > > > > > >
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
>> > > /mxnet.symbol.Symbol.argmax.html
>> > > > > > > >
>> > > > > > > > says that it is a convenience method for argmax (with a
>> > > > > > > > link),
>> > > but
>> > > > > > > > clicking that link just points to the same website (and so
>> > > > > > > > user
>> > > has
>> > > > > no
>> > > > > > > way
>> > > > > > > > of getting to the docs of the actual operator).
>> > > > > > > >
>> > > > > > > > When I tried to manually remove Symbol from the URL to get
>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
>> > > > > > > > which I
>> > > guess
>> > > > > > also
>> > > > > > > > should not happen (ignoring the fact that this should exist,
>> > > going
>> > > > to
>> > > > > > > > random URL under the website should redirect to the main
>> > > > > > > > page I
>> > > > > think).
>> > > > > > > >
>> > > > > > > > Przemek
>> > > > > > > >
>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
>> wrote:
>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
>> > > > > > > > > launching
>> > > > > this!
>> > > > > > > > >
>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
>> > > > carinmeier@gmail.com>
>> > > > > > > > wrote:
>> > > > > > > > >
>> > > > > > > > > > Nice!!! Congrats everyone!
>> > > > > > > > > >
>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
>> > > > > > > > aaron.s.markham@gmail.com>
>> > > > > > > > > > wrote:
>> > > > > > > > > >
>> > > > > > > > > > > Alrighty! The new site is launched. You might need to
>> > > > > > > > > > > clear
>> > > > > your
>> > > > > > > > cache.
>> > > > > > > > > > >
>> > > > > > > > > > > Cheers,
>> > > > > > > > > > > Aaron
>> > > > > > > > > > >
>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
>> > > > > > > > aaron.s.markham@gmail.com
>> > > > > > > > > > >
>> > > > > > > > > > > wrote:
>> > > > > > > > > > > >
>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
>> > > > > > > > > > > > continue
>> > > > > holding
>> > > > > > > > off on
>> > > > > > > > > > > > docs and CI edits. Unless there are any objections,
>> > > > > > > > > > > > I'd
>> > > > like
>> > > > > to
>> > > > > > > > launch
>> > > > > > > > > > > > the new website today.
>> > > > > > > > > > > >
>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
>> > > > > > > > > > aaron.s.markham@gmail.com>
>> > > > > > > > > > > wrote:
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > Hi everyone,
>> > > > > > > > > > > > > The last two PRs [1][2] for the new website and
>> > > > > > > > > > > > > docs
>> > > have
>> > > > > > > passed
>> > > > > > > > CI
>> > > > > > > > > > > > > (finally). Please do not make changes to /docs or
>> > > > > > > > > > > > > /ci
>> > > > until
>> > > > > > we
>> > > > > > > > get
>> > > > > > > > > > > > > these approved and merged. Every time there's a
>> > > > > > > > > > > > > merge
>> > > > > > conflict
>> > > > > > > > it has
>> > > > > > > > > > > > > set us back a day or two while shepherding the PRs
>> > > > through
>> > > > > CI
>> > > > > > > > again.
>> > > > > > > > > > > > > Unless there are catastrophic issues discovered in
>> > > > > > > > > > > > > a
>> > > > > review,
>> > > > > > I
>> > > > > > > > > > > > > recommend that we hold any patches or updates to
>> > > > > > > > > > > > > the
>> > > PRs
>> > > > to
>> > > > > > > > follow-up
>> > > > > > > > > > > > > PRs.
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > There are four steps to launch:
>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to merge
>> > > 15885
>> > > > to
>> > > > > > > > delete
>> > > > > > > > > > the
>> > > > > > > > > > > > > old content first.
>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the new
>> > > > > > > > > > > > > CI
>> > > > flows
>> > > > > > and
>> > > > > > > > > > updates
>> > > > > > > > > > > > > to the content Thomas and I have already had
>> > > > > > > > > > > > > merged in
>> > > > > 15884
>> > > > > > > [3].
>> > > > > > > > > > > > > 3. I will change the website validation Jenkins
>> > > pipeline
>> > > > to
>> > > > > > > > point to
>> > > > > > > > > > > > > the new pipeline.
>> > > > > > > > > > > > > 4. I will change the website publishing Jenkins
>> > > pipeline
>> > > > to
>> > > > > > > > point to
>> > > > > > > > > > > > > its new pipeline as well. Once triggered, the old
>> > > > > > > > > > > > > site
>> > > > will
>> > > > > > be
>> > > > > > > > > > > > > replaced with the new one.
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
>> > > > beta.mxnet.io
>> > > > > > to
>> > > > > > > > point
>> > > > > > > > > > to
>> > > > > > > > > > > > > production, and there will likely be some
>> > > > > redirect/.htaccess
>> > > > > > > > updates
>> > > > > > > > > > > > > needed next week to assist with any deep linking
>> > > > > > > > > > > > > and
>> > > 404
>> > > > > > issues
>> > > > > > > > that
>> > > > > > > > > > > > > pop up.
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > Cheers,
>> > > > > > > > > > > > > Aaron
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > [1]
>> > > https://github.com/apache/incubator-mxnet/pull/15885
>> > > > > > > > > > > > > [2]
>> > > https://github.com/apache/incubator-mxnet/pull/15883
>> > > > > > > > > > > > > [3]
>> > > https://github.com/apache/incubator-mxnet/pull/15884
>> > > > > > > > > > >
>> > > > > > > > > >
>> > > > > > > > >
>> > > > > > > >
>> > > > > > >
>> > > > > > >
>> > > > > > > --
>> > > > > > > *Chaitanya Prakash Bapat*
>> > > > > > > *+1 (973) 953-6299*
>> > > > > > >
>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
>> > > > > > > <https://github.com/ChaiBapchya>[image:
>> > > > > > https://www.facebook.com/chaibapat
>> > > > > > > ]
>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
>> > > > > > > https://twitter.com/ChaiBapchya]
>> > > > > > ><https://twitter.com/ChaiBapchya
>> > > > > > >[image:
>> > > > > > > https://www.linkedin.com//in/chaibapat25]
>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>>
>

Re: new website, docs code freeze

[Philip Cho <ch...@cs.washington.edu>]

One possible fix is to create 301 redirects via .htaccess or mod_rewrite.

Example: https://mxnet.incubator.apache.org/api/python/gluon/nn.html should
be redirected to
https://mxnet.incubator.apache.org/api/python/docs/api/gluon/nn.html

On Tue, Sep 24, 2019 at 4:23 PM Marco de Abreu <ma...@gmail.com>
wrote:

> Hi Philip,
>
> yeah that certainly makes sense. Keeping our links alive (and at least
> avoid a 404) should be our highest priority. Do we have a strategy for this
> and was that part of the website launch plan?
>
> Best regards,
> Marco
>
> On Wed, Sep 25, 2019 at 1:20 AM Philip Cho <ch...@cs.washington.edu>
> wrote:
>
> > Hi Marco:
> >
> > Today, I searched for "mxnet conv" and clicked on the first link (Gluon
> > Neural Network Layers — mxnet documentation) and got a 404.
> > I suppose documents have different URLs under the new doc system? This
> may
> > explain drop in traffic.
> >
> > Philip.
> >
> > On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <ma...@gmail.com>
> > wrote:
> >
> > > Hello,
> > >
> > > I checked the Google Analytics statistics and the launch of the new
> > > website reduced the traffic by over 80%:
> > >
> > > [image: image.png]
> > >
> > > (Please let me know if the image is not visible)
> > >
> > > How shall we handle this?
> > >
> > > Best regards,
> > > Marco
> > >
> > > On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> > > wrote:
> > >
> > >> For the install page [1], I suggest to add the selection of backend
> > >> DeepNumpy [2] which will be more clean.
> > >>
> > >> [1] http://mxnet.incubator.apache.org/index.html
> > >> [2] https://numpy.mxnet.io/#installation
> > >>
> > >>
> > >>
> > >> > -----Original Message-----
> > >> > From: kellen sunderland <ke...@gmail.com>
> > >> > Sent: Monday, September 23, 2019 12:47 PM
> > >> > To: dev@mxnet.incubator.apache.org
> > >> > Subject: Re: new website, docs code freeze
> > >> >
> > >> > New site looks good.  I do notice that a few tutorials from the old
> > >> site are
> > >> > missing (for example the TensorRT tutorial).  Any plans to bring
> them
> > >> back?
> > >> >
> > >> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <
> haibin.lin.aws@gmail.com
> > >
> > >> > wrote:
> > >> >
> > >> > > Another issue I found with the current website: the Sphinx object
> > >> > > inventory
> > >> > > <https://www.sphinx-
> > >> > doc.org/en/master/usage/extensions/intersphinx.htm
> > >> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
> > >> > > relies on this file to link document across projects. Shall we add
> > it
> > >> > > back?
> > >> > >
> > >> > > Best,
> > >> > > Haibin
> > >> > >
> > >> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
> > >> wrote:
> > >> > >
> > >> > > > Hi,
> > >> > > >
> > >> > > >
> > >> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > >> > > > <th...@gmail.com>
> > >> > > > wrote:
> > >> > > >
> > >> > > > > Thanks all for the feedback,
> > >> > > > >
> > >> > > > > We'll send an email next week with the list of missing
> features,
> > >> > > content
> > >> > > > > and bugs that we plan to fix.
> > >> > > > > We took the option of releasing early, with some features
> > missing,
> > >> > > rather
> > >> > > > > than trying to be at feature parity with the old website
> before
> > >> > > launching
> > >> > > > > the website.
> > >> > > > > The reason why we decided to do that is two-fold:
> > >> > > > > - playing catch-up with docs in master introduce daily
> conflicts
> > >> > > > > that
> > >> > > > need
> > >> > > > > to be resolved and introduce opportunity for errors
> > >> > > > > - by releasing early, we can take advantage of the community
> > >> > > > contributions
> > >> > > > > in modifying whatever the community feels like a better way of
> > >> > > > > doing things.
> > >> > > > >
> > >> > > > > One of the goals of the new website was to disentangle the
> main
> > >> > > website,
> > >> > > > > now called "static_site" to the auto-generated docs. Now the
> > >> > > > > overall
> > >> > > site
> > >> > > > > is made of a main static site, with easy to modify content and
> > >> > > > > easy to understand architecture for anybody familiar with
> basic
> > >> > > > > html, and a collection of mini-websites for each language
> > bindings
> > >> > > > > that can be
> > >> > > built
> > >> > > > in
> > >> > > > > isolation and that are self-contained. Actually the new CI
> jobs
> > >> > > > > builds
> > >> > > > all
> > >> > > > > of them in parallel independently.
> > >> > > > >
> > >> > > > > There is PLENTY of room for improvement, it would be great if
> > the
> > >> > > > community
> > >> > > > > can help contribute to bring the new website at the same level
> > of
> > >> > > content
> > >> > > > > richness as the old one, and then even further.
> > >> > > > >
> > >> > > > > Missing features:
> > >> > > > > - As pointed by Haibin, the API docs do not have the full list
> > of
> > >> > > > operators
> > >> > > > > and classes. There is a mix of auto-generated docs based on
> > >> > > > > packages,
> > >> > > and
> > >> > > > > some docs that are spelled out manually to improve the logical
> > >> > > > organization
> > >> > > > > of the package where there is a need. The drawback with
> manually
> > >> > > > > listed classes in a package is that it's very easy to miss
> some.
> > >> > > > > If someone
> > >> > > > wanted
> > >> > > > > to build a sanity check that would automatically detect which
> > >> > > > > classes
> > >> > > are
> > >> > > > > not in the documentation, or if someone knew how to enable
> that
> > >> > > > > with sphinx, that would be a great addition to the python docs
> > >> > > > > - There is missing content in the python tutorials, and the
> > >> > > > discoverability
> > >> > > > > could be improved. Some old tutorials have not been migrated
> > just
> > >> yet.
> > >> > > > > - The nightly tests on tutorials have been disabled for now
> > >> > > > > - There is no "Download jupyter notebook" for tutorials just
> > yet.
> > >> > > > > - Non-python tutorials might benefit from a blurb description
> > and
> > >> > > > > a
> > >> > > > better
> > >> > > > > content organization.
> > >> > > > > - Python tutorials could be better organized, have a picture
> > >> > > accompanying
> > >> > > > > their description
> > >> > > > > - There is no site-wide search, this is not an easy problem to
> > >> > > > > solve to
> > >> > > > be
> > >> > > > > fair given the static nature of the website, but maybe an
> > external
> > >> > > plugin
> > >> > > > > might be able to give a half-way solution
> > >> > > > > - There is no version selector for the docs
> > >> > > > > - There is bug in search box of the python docs, but this is
> > just
> > >> > > > > a
> > >> > > small
> > >> > > > > JS bug that can be fixed easily (on my list for next week)
> > >> > > > > - Most old links have not had a redirect put in place.
> > >> > > > >
> > >> > > > >
> > >> > > > I noticed on the Ubuntu home page in the Developer dropdown that
> > the
> > >> > > > link MXNet on Ubuntu
> > >> > > > <https://mxnet.incubator.apache.org/install/index.html
> > >> > > > >with
> > >> > > > Nvidia
> > >> > > > <
> > >> > > >
> > >> > >
> > >>
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > >> > > mxnet/
> > >> > > > >
> > >> > > > doesn't work anymore, it points to:
> > >> > > > https://mxnet.incubator.apache.org/install/index.html
> > >> > > >
> > >> > > > Also, on the MXNet 'getting started' page
> > >> > > > https://mxnet.incubator.apache.org/get_started , the link
> "Ubuntu
> > >> > > > Installation Guide" at the bottom doesn't work either, it points
> > to:
> > >> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > >> > > >
> > >> > > >
> > >> > > > I suggest you do a scan of the new website to find these
> dangling
> > >> links.
> > >> > > >
> > >> > > > regards,
> > >> > > >
> > >> > > > Lieven
> > >> > > >
> > >> > > >
> > >> > > >
> > >> > > > > We'll formalize this in github issues next week, but they are
> > all
> > >> > > fairly
> > >> > > > > small and helping out on these would be a great way of
> > >> > > > > familiarizing yourself with the new website build system and
> > >> website
> > >> > architecture.
> > >> > > > >
> > >> > > > >  Thanks all for the feedback, please keep it coming!
> > >> > > > >
> > >> > > > > Thomas Delteil
> > >> > > > >
> > >> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > >> > > > > <ha...@gmail.com> a écrit :
> > >> > > > >
> > >> > > > > > It looks like my previous email did not go through.
> > Re-sending:
> > >> > > > > >
> > >> > > > > > Hi Aaron,
> > >> > > > > >
> > >> > > > > > The website looks cool. Thanks for pushing this to
> > production. A
> > >> > > > > > few
> > >> > > > > > questions:
> > >> > > > > >
> > >> > > > > > - I was looking for the API doc for mx.sym.dot, but I find
> > that
> > >> > > > > > most operators under mx.sym.* are missing. Is this expected?
> > >> > > > > > - I was also checking the search functionality, searching
> the
> > >> > > > > > keyword "ndarray" only returns one result
> > >> > > > > > "mxnet.ndarray.NDArray", which
> > >> > > > doesn't
> > >> > > > > > seem right. There animation keeps going (Searching. ->
> > >> > > > > > Searching.. -> Searching ...) and gives me an impression
> that
> > >> > > > > > the search is never completely done(?).
> > >> > > > > >
> > >> > > > > > Best,
> > >> > > > > > Haibin
> > >> > > > > >
> > >> > > > > >
> > >> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > >> > > chai.bapat@gmail.com>
> > >> > > > > > wrote:
> > >> > > > > >
> > >> > > > > > > Thanks Aaron and the team for launching new website!
> > >> > > > > > >
> > >> > > > > > > 1. There's no search button anywhere on the landing page.
> > >> > > > > > > 2. I wasn't able to find FAQ (and without search button I
> > dont
> > >> > > > > > > have
> > >> > > > > > option
> > >> > > > > > > but to go manually on each menu). Only when I go to
> > >> > > > > > > Docs&Tutorials
> > >> > > ->
> > >> > > > > FAQ
> > >> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > >> > > > > > >
> > >> > > > > > > Suggestions
> > >> > > > > > > Might want to make this searchable and pop FAQ on the main
> > >> > > > > > > page (or somewhere prominent)
> > >> > > > > > >
> > >> > > > > > > Thanks,
> > >> > > > > > > Chai
> > >> > > > > > >
> > >> > > > > > >
> > >> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > >> > > ptrendx@apache.org>
> > >> > > > > > > wrote:
> > >> > > > > > >
> > >> > > > > > > > There seems to be a problem with (at least Python, did
> not
> > >> > > > > > > > check
> > >> > > > > > others)
> > >> > > > > > > > APIs. For example this page:
> > >> > > > > > > >
> > >> > > > > > > >
> > >> > > > > > >
> > >> > > > > >
> > >> > > > >
> > >> > > >
> > >> > >
> > >> >
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > >> > > /mxnet.symbol.Symbol.argmax.html
> > >> > > > > > > >
> > >> > > > > > > > says that it is a convenience method for argmax (with a
> > >> > > > > > > > link),
> > >> > > but
> > >> > > > > > > > clicking that link just points to the same website (and
> so
> > >> > > > > > > > user
> > >> > > has
> > >> > > > > no
> > >> > > > > > > way
> > >> > > > > > > > of getting to the docs of the actual operator).
> > >> > > > > > > >
> > >> > > > > > > > When I tried to manually remove Symbol from the URL to
> get
> > >> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
> > >> > > > > > > > which I
> > >> > > guess
> > >> > > > > > also
> > >> > > > > > > > should not happen (ignoring the fact that this should
> > exist,
> > >> > > going
> > >> > > > to
> > >> > > > > > > > random URL under the website should redirect to the main
> > >> > > > > > > > page I
> > >> > > > > think).
> > >> > > > > > > >
> > >> > > > > > > > Przemek
> > >> > > > > > > >
> > >> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
> > >> wrote:
> > >> > > > > > > > > Looks very neat. Thank you Aaron and many others for
> > >> > > > > > > > > launching
> > >> > > > > this!
> > >> > > > > > > > >
> > >> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > >> > > > carinmeier@gmail.com>
> > >> > > > > > > > wrote:
> > >> > > > > > > > >
> > >> > > > > > > > > > Nice!!! Congrats everyone!
> > >> > > > > > > > > >
> > >> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > >> > > > > > > > aaron.s.markham@gmail.com>
> > >> > > > > > > > > > wrote:
> > >> > > > > > > > > >
> > >> > > > > > > > > > > Alrighty! The new site is launched. You might need
> > to
> > >> > > > > > > > > > > clear
> > >> > > > > your
> > >> > > > > > > > cache.
> > >> > > > > > > > > > >
> > >> > > > > > > > > > > Cheers,
> > >> > > > > > > > > > > Aaron
> > >> > > > > > > > > > >
> > >> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > >> > > > > > > > aaron.s.markham@gmail.com
> > >> > > > > > > > > > >
> > >> > > > > > > > > > > wrote:
> > >> > > > > > > > > > > >
> > >> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> > >> > > > > > > > > > > > continue
> > >> > > > > holding
> > >> > > > > > > > off on
> > >> > > > > > > > > > > > docs and CI edits. Unless there are any
> > objections,
> > >> > > > > > > > > > > > I'd
> > >> > > > like
> > >> > > > > to
> > >> > > > > > > > launch
> > >> > > > > > > > > > > > the new website today.
> > >> > > > > > > > > > > >
> > >> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > >> > > > > > > > > > aaron.s.markham@gmail.com>
> > >> > > > > > > > > > > wrote:
> > >> > > > > > > > > > > > >
> > >> > > > > > > > > > > > > Hi everyone,
> > >> > > > > > > > > > > > > The last two PRs [1][2] for the new website
> and
> > >> > > > > > > > > > > > > docs
> > >> > > have
> > >> > > > > > > passed
> > >> > > > > > > > CI
> > >> > > > > > > > > > > > > (finally). Please do not make changes to /docs
> > or
> > >> > > > > > > > > > > > > /ci
> > >> > > > until
> > >> > > > > > we
> > >> > > > > > > > get
> > >> > > > > > > > > > > > > these approved and merged. Every time there's
> a
> > >> > > > > > > > > > > > > merge
> > >> > > > > > conflict
> > >> > > > > > > > it has
> > >> > > > > > > > > > > > > set us back a day or two while shepherding the
> > PRs
> > >> > > > through
> > >> > > > > CI
> > >> > > > > > > > again.
> > >> > > > > > > > > > > > > Unless there are catastrophic issues
> discovered
> > in
> > >> > > > > > > > > > > > > a
> > >> > > > > review,
> > >> > > > > > I
> > >> > > > > > > > > > > > > recommend that we hold any patches or updates
> to
> > >> > > > > > > > > > > > > the
> > >> > > PRs
> > >> > > > to
> > >> > > > > > > > follow-up
> > >> > > > > > > > > > > > > PRs.
> > >> > > > > > > > > > > > >
> > >> > > > > > > > > > > > > There are four steps to launch:
> > >> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
> > merge
> > >> > > 15885
> > >> > > > to
> > >> > > > > > > > delete
> > >> > > > > > > > > > the
> > >> > > > > > > > > > > > > old content first.
> > >> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the
> > new
> > >> > > > > > > > > > > > > CI
> > >> > > > flows
> > >> > > > > > and
> > >> > > > > > > > > > updates
> > >> > > > > > > > > > > > > to the content Thomas and I have already had
> > >> > > > > > > > > > > > > merged in
> > >> > > > > 15884
> > >> > > > > > > [3].
> > >> > > > > > > > > > > > > 3. I will change the website validation
> Jenkins
> > >> > > pipeline
> > >> > > > to
> > >> > > > > > > > point to
> > >> > > > > > > > > > > > > the new pipeline.
> > >> > > > > > > > > > > > > 4. I will change the website publishing
> Jenkins
> > >> > > pipeline
> > >> > > > to
> > >> > > > > > > > point to
> > >> > > > > > > > > > > > > its new pipeline as well. Once triggered, the
> > old
> > >> > > > > > > > > > > > > site
> > >> > > > will
> > >> > > > > > be
> > >> > > > > > > > > > > > > replaced with the new one.
> > >> > > > > > > > > > > > >
> > >> > > > > > > > > > > > > Post launch we'll need to update the DNS for
> > >> > > > beta.mxnet.io
> > >> > > > > > to
> > >> > > > > > > > point
> > >> > > > > > > > > > to
> > >> > > > > > > > > > > > > production, and there will likely be some
> > >> > > > > redirect/.htaccess
> > >> > > > > > > > updates
> > >> > > > > > > > > > > > > needed next week to assist with any deep
> linking
> > >> > > > > > > > > > > > > and
> > >> > > 404
> > >> > > > > > issues
> > >> > > > > > > > that
> > >> > > > > > > > > > > > > pop up.
> > >> > > > > > > > > > > > >
> > >> > > > > > > > > > > > > Cheers,
> > >> > > > > > > > > > > > > Aaron
> > >> > > > > > > > > > > > >
> > >> > > > > > > > > > > > > [1]
> > >> > > https://github.com/apache/incubator-mxnet/pull/15885
> > >> > > > > > > > > > > > > [2]
> > >> > > https://github.com/apache/incubator-mxnet/pull/15883
> > >> > > > > > > > > > > > > [3]
> > >> > > https://github.com/apache/incubator-mxnet/pull/15884
> > >> > > > > > > > > > >
> > >> > > > > > > > > >
> > >> > > > > > > > >
> > >> > > > > > > >
> > >> > > > > > >
> > >> > > > > > >
> > >> > > > > > > --
> > >> > > > > > > *Chaitanya Prakash Bapat*
> > >> > > > > > > *+1 (973) 953-6299*
> > >> > > > > > >
> > >> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > >> > > > > > > <https://github.com/ChaiBapchya>[image:
> > >> > > > > > https://www.facebook.com/chaibapat
> > >> > > > > > > ]
> > >> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > >> > > > > > > https://twitter.com/ChaiBapchya]
> > >> > > > > > ><https://twitter.com/ChaiBapchya
> > >> > > > > > >[image:
> > >> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > >> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > >> > > > > > >
> > >> > > > > >
> > >> > > > >
> > >> > > >
> > >> > >
> > >>
> > >
> >
>

Re: new website, docs code freeze

[Marco de Abreu <ma...@gmail.com>]

Hi Philip,

yeah that certainly makes sense. Keeping our links alive (and at least
avoid a 404) should be our highest priority. Do we have a strategy for this
and was that part of the website launch plan?

Best regards,
Marco

On Wed, Sep 25, 2019 at 1:20 AM Philip Cho <ch...@cs.washington.edu>
wrote:

> Hi Marco:
>
> Today, I searched for "mxnet conv" and clicked on the first link (Gluon
> Neural Network Layers — mxnet documentation) and got a 404.
> I suppose documents have different URLs under the new doc system? This may
> explain drop in traffic.
>
> Philip.
>
> On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <ma...@gmail.com>
> wrote:
>
> > Hello,
> >
> > I checked the Google Analytics statistics and the launch of the new
> > website reduced the traffic by over 80%:
> >
> > [image: image.png]
> >
> > (Please let me know if the image is not visible)
> >
> > How shall we handle this?
> >
> > Best regards,
> > Marco
> >
> > On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> > wrote:
> >
> >> For the install page [1], I suggest to add the selection of backend
> >> DeepNumpy [2] which will be more clean.
> >>
> >> [1] http://mxnet.incubator.apache.org/index.html
> >> [2] https://numpy.mxnet.io/#installation
> >>
> >>
> >>
> >> > -----Original Message-----
> >> > From: kellen sunderland <ke...@gmail.com>
> >> > Sent: Monday, September 23, 2019 12:47 PM
> >> > To: dev@mxnet.incubator.apache.org
> >> > Subject: Re: new website, docs code freeze
> >> >
> >> > New site looks good.  I do notice that a few tutorials from the old
> >> site are
> >> > missing (for example the TensorRT tutorial).  Any plans to bring them
> >> back?
> >> >
> >> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <haibin.lin.aws@gmail.com
> >
> >> > wrote:
> >> >
> >> > > Another issue I found with the current website: the Sphinx object
> >> > > inventory
> >> > > <https://www.sphinx-
> >> > doc.org/en/master/usage/extensions/intersphinx.htm
> >> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
> >> > > relies on this file to link document across projects. Shall we add
> it
> >> > > back?
> >> > >
> >> > > Best,
> >> > > Haibin
> >> > >
> >> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
> >> wrote:
> >> > >
> >> > > > Hi,
> >> > > >
> >> > > >
> >> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> >> > > > <th...@gmail.com>
> >> > > > wrote:
> >> > > >
> >> > > > > Thanks all for the feedback,
> >> > > > >
> >> > > > > We'll send an email next week with the list of missing features,
> >> > > content
> >> > > > > and bugs that we plan to fix.
> >> > > > > We took the option of releasing early, with some features
> missing,
> >> > > rather
> >> > > > > than trying to be at feature parity with the old website before
> >> > > launching
> >> > > > > the website.
> >> > > > > The reason why we decided to do that is two-fold:
> >> > > > > - playing catch-up with docs in master introduce daily conflicts
> >> > > > > that
> >> > > > need
> >> > > > > to be resolved and introduce opportunity for errors
> >> > > > > - by releasing early, we can take advantage of the community
> >> > > > contributions
> >> > > > > in modifying whatever the community feels like a better way of
> >> > > > > doing things.
> >> > > > >
> >> > > > > One of the goals of the new website was to disentangle the main
> >> > > website,
> >> > > > > now called "static_site" to the auto-generated docs. Now the
> >> > > > > overall
> >> > > site
> >> > > > > is made of a main static site, with easy to modify content and
> >> > > > > easy to understand architecture for anybody familiar with basic
> >> > > > > html, and a collection of mini-websites for each language
> bindings
> >> > > > > that can be
> >> > > built
> >> > > > in
> >> > > > > isolation and that are self-contained. Actually the new CI jobs
> >> > > > > builds
> >> > > > all
> >> > > > > of them in parallel independently.
> >> > > > >
> >> > > > > There is PLENTY of room for improvement, it would be great if
> the
> >> > > > community
> >> > > > > can help contribute to bring the new website at the same level
> of
> >> > > content
> >> > > > > richness as the old one, and then even further.
> >> > > > >
> >> > > > > Missing features:
> >> > > > > - As pointed by Haibin, the API docs do not have the full list
> of
> >> > > > operators
> >> > > > > and classes. There is a mix of auto-generated docs based on
> >> > > > > packages,
> >> > > and
> >> > > > > some docs that are spelled out manually to improve the logical
> >> > > > organization
> >> > > > > of the package where there is a need. The drawback with manually
> >> > > > > listed classes in a package is that it's very easy to miss some.
> >> > > > > If someone
> >> > > > wanted
> >> > > > > to build a sanity check that would automatically detect which
> >> > > > > classes
> >> > > are
> >> > > > > not in the documentation, or if someone knew how to enable that
> >> > > > > with sphinx, that would be a great addition to the python docs
> >> > > > > - There is missing content in the python tutorials, and the
> >> > > > discoverability
> >> > > > > could be improved. Some old tutorials have not been migrated
> just
> >> yet.
> >> > > > > - The nightly tests on tutorials have been disabled for now
> >> > > > > - There is no "Download jupyter notebook" for tutorials just
> yet.
> >> > > > > - Non-python tutorials might benefit from a blurb description
> and
> >> > > > > a
> >> > > > better
> >> > > > > content organization.
> >> > > > > - Python tutorials could be better organized, have a picture
> >> > > accompanying
> >> > > > > their description
> >> > > > > - There is no site-wide search, this is not an easy problem to
> >> > > > > solve to
> >> > > > be
> >> > > > > fair given the static nature of the website, but maybe an
> external
> >> > > plugin
> >> > > > > might be able to give a half-way solution
> >> > > > > - There is no version selector for the docs
> >> > > > > - There is bug in search box of the python docs, but this is
> just
> >> > > > > a
> >> > > small
> >> > > > > JS bug that can be fixed easily (on my list for next week)
> >> > > > > - Most old links have not had a redirect put in place.
> >> > > > >
> >> > > > >
> >> > > > I noticed on the Ubuntu home page in the Developer dropdown that
> the
> >> > > > link MXNet on Ubuntu
> >> > > > <https://mxnet.incubator.apache.org/install/index.html
> >> > > > >with
> >> > > > Nvidia
> >> > > > <
> >> > > >
> >> > >
> >> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> >> > > mxnet/
> >> > > > >
> >> > > > doesn't work anymore, it points to:
> >> > > > https://mxnet.incubator.apache.org/install/index.html
> >> > > >
> >> > > > Also, on the MXNet 'getting started' page
> >> > > > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
> >> > > > Installation Guide" at the bottom doesn't work either, it points
> to:
> >> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> >> > > >
> >> > > >
> >> > > > I suggest you do a scan of the new website to find these dangling
> >> links.
> >> > > >
> >> > > > regards,
> >> > > >
> >> > > > Lieven
> >> > > >
> >> > > >
> >> > > >
> >> > > > > We'll formalize this in github issues next week, but they are
> all
> >> > > fairly
> >> > > > > small and helping out on these would be a great way of
> >> > > > > familiarizing yourself with the new website build system and
> >> website
> >> > architecture.
> >> > > > >
> >> > > > >  Thanks all for the feedback, please keep it coming!
> >> > > > >
> >> > > > > Thomas Delteil
> >> > > > >
> >> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> >> > > > > <ha...@gmail.com> a écrit :
> >> > > > >
> >> > > > > > It looks like my previous email did not go through.
> Re-sending:
> >> > > > > >
> >> > > > > > Hi Aaron,
> >> > > > > >
> >> > > > > > The website looks cool. Thanks for pushing this to
> production. A
> >> > > > > > few
> >> > > > > > questions:
> >> > > > > >
> >> > > > > > - I was looking for the API doc for mx.sym.dot, but I find
> that
> >> > > > > > most operators under mx.sym.* are missing. Is this expected?
> >> > > > > > - I was also checking the search functionality, searching the
> >> > > > > > keyword "ndarray" only returns one result
> >> > > > > > "mxnet.ndarray.NDArray", which
> >> > > > doesn't
> >> > > > > > seem right. There animation keeps going (Searching. ->
> >> > > > > > Searching.. -> Searching ...) and gives me an impression that
> >> > > > > > the search is never completely done(?).
> >> > > > > >
> >> > > > > > Best,
> >> > > > > > Haibin
> >> > > > > >
> >> > > > > >
> >> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> >> > > chai.bapat@gmail.com>
> >> > > > > > wrote:
> >> > > > > >
> >> > > > > > > Thanks Aaron and the team for launching new website!
> >> > > > > > >
> >> > > > > > > 1. There's no search button anywhere on the landing page.
> >> > > > > > > 2. I wasn't able to find FAQ (and without search button I
> dont
> >> > > > > > > have
> >> > > > > > option
> >> > > > > > > but to go manually on each menu). Only when I go to
> >> > > > > > > Docs&Tutorials
> >> > > ->
> >> > > > > FAQ
> >> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> >> > > > > > >
> >> > > > > > > Suggestions
> >> > > > > > > Might want to make this searchable and pop FAQ on the main
> >> > > > > > > page (or somewhere prominent)
> >> > > > > > >
> >> > > > > > > Thanks,
> >> > > > > > > Chai
> >> > > > > > >
> >> > > > > > >
> >> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> >> > > ptrendx@apache.org>
> >> > > > > > > wrote:
> >> > > > > > >
> >> > > > > > > > There seems to be a problem with (at least Python, did not
> >> > > > > > > > check
> >> > > > > > others)
> >> > > > > > > > APIs. For example this page:
> >> > > > > > > >
> >> > > > > > > >
> >> > > > > > >
> >> > > > > >
> >> > > > >
> >> > > >
> >> > >
> >> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> >> > > /mxnet.symbol.Symbol.argmax.html
> >> > > > > > > >
> >> > > > > > > > says that it is a convenience method for argmax (with a
> >> > > > > > > > link),
> >> > > but
> >> > > > > > > > clicking that link just points to the same website (and so
> >> > > > > > > > user
> >> > > has
> >> > > > > no
> >> > > > > > > way
> >> > > > > > > > of getting to the docs of the actual operator).
> >> > > > > > > >
> >> > > > > > > > When I tried to manually remove Symbol from the URL to get
> >> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
> >> > > > > > > > which I
> >> > > guess
> >> > > > > > also
> >> > > > > > > > should not happen (ignoring the fact that this should
> exist,
> >> > > going
> >> > > > to
> >> > > > > > > > random URL under the website should redirect to the main
> >> > > > > > > > page I
> >> > > > > think).
> >> > > > > > > >
> >> > > > > > > > Przemek
> >> > > > > > > >
> >> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
> >> wrote:
> >> > > > > > > > > Looks very neat. Thank you Aaron and many others for
> >> > > > > > > > > launching
> >> > > > > this!
> >> > > > > > > > >
> >> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> >> > > > carinmeier@gmail.com>
> >> > > > > > > > wrote:
> >> > > > > > > > >
> >> > > > > > > > > > Nice!!! Congrats everyone!
> >> > > > > > > > > >
> >> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> >> > > > > > > > aaron.s.markham@gmail.com>
> >> > > > > > > > > > wrote:
> >> > > > > > > > > >
> >> > > > > > > > > > > Alrighty! The new site is launched. You might need
> to
> >> > > > > > > > > > > clear
> >> > > > > your
> >> > > > > > > > cache.
> >> > > > > > > > > > >
> >> > > > > > > > > > > Cheers,
> >> > > > > > > > > > > Aaron
> >> > > > > > > > > > >
> >> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> >> > > > > > > > aaron.s.markham@gmail.com
> >> > > > > > > > > > >
> >> > > > > > > > > > > wrote:
> >> > > > > > > > > > > >
> >> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> >> > > > > > > > > > > > continue
> >> > > > > holding
> >> > > > > > > > off on
> >> > > > > > > > > > > > docs and CI edits. Unless there are any
> objections,
> >> > > > > > > > > > > > I'd
> >> > > > like
> >> > > > > to
> >> > > > > > > > launch
> >> > > > > > > > > > > > the new website today.
> >> > > > > > > > > > > >
> >> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> >> > > > > > > > > > aaron.s.markham@gmail.com>
> >> > > > > > > > > > > wrote:
> >> > > > > > > > > > > > >
> >> > > > > > > > > > > > > Hi everyone,
> >> > > > > > > > > > > > > The last two PRs [1][2] for the new website and
> >> > > > > > > > > > > > > docs
> >> > > have
> >> > > > > > > passed
> >> > > > > > > > CI
> >> > > > > > > > > > > > > (finally). Please do not make changes to /docs
> or
> >> > > > > > > > > > > > > /ci
> >> > > > until
> >> > > > > > we
> >> > > > > > > > get
> >> > > > > > > > > > > > > these approved and merged. Every time there's a
> >> > > > > > > > > > > > > merge
> >> > > > > > conflict
> >> > > > > > > > it has
> >> > > > > > > > > > > > > set us back a day or two while shepherding the
> PRs
> >> > > > through
> >> > > > > CI
> >> > > > > > > > again.
> >> > > > > > > > > > > > > Unless there are catastrophic issues discovered
> in
> >> > > > > > > > > > > > > a
> >> > > > > review,
> >> > > > > > I
> >> > > > > > > > > > > > > recommend that we hold any patches or updates to
> >> > > > > > > > > > > > > the
> >> > > PRs
> >> > > > to
> >> > > > > > > > follow-up
> >> > > > > > > > > > > > > PRs.
> >> > > > > > > > > > > > >
> >> > > > > > > > > > > > > There are four steps to launch:
> >> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to
> merge
> >> > > 15885
> >> > > > to
> >> > > > > > > > delete
> >> > > > > > > > > > the
> >> > > > > > > > > > > > > old content first.
> >> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the
> new
> >> > > > > > > > > > > > > CI
> >> > > > flows
> >> > > > > > and
> >> > > > > > > > > > updates
> >> > > > > > > > > > > > > to the content Thomas and I have already had
> >> > > > > > > > > > > > > merged in
> >> > > > > 15884
> >> > > > > > > [3].
> >> > > > > > > > > > > > > 3. I will change the website validation Jenkins
> >> > > pipeline
> >> > > > to
> >> > > > > > > > point to
> >> > > > > > > > > > > > > the new pipeline.
> >> > > > > > > > > > > > > 4. I will change the website publishing Jenkins
> >> > > pipeline
> >> > > > to
> >> > > > > > > > point to
> >> > > > > > > > > > > > > its new pipeline as well. Once triggered, the
> old
> >> > > > > > > > > > > > > site
> >> > > > will
> >> > > > > > be
> >> > > > > > > > > > > > > replaced with the new one.
> >> > > > > > > > > > > > >
> >> > > > > > > > > > > > > Post launch we'll need to update the DNS for
> >> > > > beta.mxnet.io
> >> > > > > > to
> >> > > > > > > > point
> >> > > > > > > > > > to
> >> > > > > > > > > > > > > production, and there will likely be some
> >> > > > > redirect/.htaccess
> >> > > > > > > > updates
> >> > > > > > > > > > > > > needed next week to assist with any deep linking
> >> > > > > > > > > > > > > and
> >> > > 404
> >> > > > > > issues
> >> > > > > > > > that
> >> > > > > > > > > > > > > pop up.
> >> > > > > > > > > > > > >
> >> > > > > > > > > > > > > Cheers,
> >> > > > > > > > > > > > > Aaron
> >> > > > > > > > > > > > >
> >> > > > > > > > > > > > > [1]
> >> > > https://github.com/apache/incubator-mxnet/pull/15885
> >> > > > > > > > > > > > > [2]
> >> > > https://github.com/apache/incubator-mxnet/pull/15883
> >> > > > > > > > > > > > > [3]
> >> > > https://github.com/apache/incubator-mxnet/pull/15884
> >> > > > > > > > > > >
> >> > > > > > > > > >
> >> > > > > > > > >
> >> > > > > > > >
> >> > > > > > >
> >> > > > > > >
> >> > > > > > > --
> >> > > > > > > *Chaitanya Prakash Bapat*
> >> > > > > > > *+1 (973) 953-6299*
> >> > > > > > >
> >> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> >> > > > > > > <https://github.com/ChaiBapchya>[image:
> >> > > > > > https://www.facebook.com/chaibapat
> >> > > > > > > ]
> >> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> >> > > > > > > https://twitter.com/ChaiBapchya]
> >> > > > > > ><https://twitter.com/ChaiBapchya
> >> > > > > > >[image:
> >> > > > > > > https://www.linkedin.com//in/chaibapat25]
> >> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> >> > > > > > >
> >> > > > > >
> >> > > > >
> >> > > >
> >> > >
> >>
> >
>

Re: new website, docs code freeze

[Philip Cho <ch...@cs.washington.edu>]

Hi Marco:

Today, I searched for "mxnet conv" and clicked on the first link (Gluon
Neural Network Layers — mxnet documentation) and got a 404.
I suppose documents have different URLs under the new doc system? This may
explain drop in traffic.

Philip.

On Tue, Sep 24, 2019 at 4:17 PM Marco de Abreu <ma...@gmail.com>
wrote:

> Hello,
>
> I checked the Google Analytics statistics and the launch of the new
> website reduced the traffic by over 80%:
>
> [image: image.png]
>
> (Please let me know if the image is not visible)
>
> How shall we handle this?
>
> Best regards,
> Marco
>
> On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com>
> wrote:
>
>> For the install page [1], I suggest to add the selection of backend
>> DeepNumpy [2] which will be more clean.
>>
>> [1] http://mxnet.incubator.apache.org/index.html
>> [2] https://numpy.mxnet.io/#installation
>>
>>
>>
>> > -----Original Message-----
>> > From: kellen sunderland <ke...@gmail.com>
>> > Sent: Monday, September 23, 2019 12:47 PM
>> > To: dev@mxnet.incubator.apache.org
>> > Subject: Re: new website, docs code freeze
>> >
>> > New site looks good.  I do notice that a few tutorials from the old
>> site are
>> > missing (for example the TensorRT tutorial).  Any plans to bring them
>> back?
>> >
>> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <ha...@gmail.com>
>> > wrote:
>> >
>> > > Another issue I found with the current website: the Sphinx object
>> > > inventory
>> > > <https://www.sphinx-
>> > doc.org/en/master/usage/extensions/intersphinx.htm
>> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
>> > > relies on this file to link document across projects. Shall we add it
>> > > back?
>> > >
>> > > Best,
>> > > Haibin
>> > >
>> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be>
>> wrote:
>> > >
>> > > > Hi,
>> > > >
>> > > >
>> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
>> > > > <th...@gmail.com>
>> > > > wrote:
>> > > >
>> > > > > Thanks all for the feedback,
>> > > > >
>> > > > > We'll send an email next week with the list of missing features,
>> > > content
>> > > > > and bugs that we plan to fix.
>> > > > > We took the option of releasing early, with some features missing,
>> > > rather
>> > > > > than trying to be at feature parity with the old website before
>> > > launching
>> > > > > the website.
>> > > > > The reason why we decided to do that is two-fold:
>> > > > > - playing catch-up with docs in master introduce daily conflicts
>> > > > > that
>> > > > need
>> > > > > to be resolved and introduce opportunity for errors
>> > > > > - by releasing early, we can take advantage of the community
>> > > > contributions
>> > > > > in modifying whatever the community feels like a better way of
>> > > > > doing things.
>> > > > >
>> > > > > One of the goals of the new website was to disentangle the main
>> > > website,
>> > > > > now called "static_site" to the auto-generated docs. Now the
>> > > > > overall
>> > > site
>> > > > > is made of a main static site, with easy to modify content and
>> > > > > easy to understand architecture for anybody familiar with basic
>> > > > > html, and a collection of mini-websites for each language bindings
>> > > > > that can be
>> > > built
>> > > > in
>> > > > > isolation and that are self-contained. Actually the new CI jobs
>> > > > > builds
>> > > > all
>> > > > > of them in parallel independently.
>> > > > >
>> > > > > There is PLENTY of room for improvement, it would be great if the
>> > > > community
>> > > > > can help contribute to bring the new website at the same level of
>> > > content
>> > > > > richness as the old one, and then even further.
>> > > > >
>> > > > > Missing features:
>> > > > > - As pointed by Haibin, the API docs do not have the full list of
>> > > > operators
>> > > > > and classes. There is a mix of auto-generated docs based on
>> > > > > packages,
>> > > and
>> > > > > some docs that are spelled out manually to improve the logical
>> > > > organization
>> > > > > of the package where there is a need. The drawback with manually
>> > > > > listed classes in a package is that it's very easy to miss some.
>> > > > > If someone
>> > > > wanted
>> > > > > to build a sanity check that would automatically detect which
>> > > > > classes
>> > > are
>> > > > > not in the documentation, or if someone knew how to enable that
>> > > > > with sphinx, that would be a great addition to the python docs
>> > > > > - There is missing content in the python tutorials, and the
>> > > > discoverability
>> > > > > could be improved. Some old tutorials have not been migrated just
>> yet.
>> > > > > - The nightly tests on tutorials have been disabled for now
>> > > > > - There is no "Download jupyter notebook" for tutorials just yet.
>> > > > > - Non-python tutorials might benefit from a blurb description and
>> > > > > a
>> > > > better
>> > > > > content organization.
>> > > > > - Python tutorials could be better organized, have a picture
>> > > accompanying
>> > > > > their description
>> > > > > - There is no site-wide search, this is not an easy problem to
>> > > > > solve to
>> > > > be
>> > > > > fair given the static nature of the website, but maybe an external
>> > > plugin
>> > > > > might be able to give a half-way solution
>> > > > > - There is no version selector for the docs
>> > > > > - There is bug in search box of the python docs, but this is just
>> > > > > a
>> > > small
>> > > > > JS bug that can be fixed easily (on my list for next week)
>> > > > > - Most old links have not had a redirect put in place.
>> > > > >
>> > > > >
>> > > > I noticed on the Ubuntu home page in the Developer dropdown that the
>> > > > link MXNet on Ubuntu
>> > > > <https://mxnet.incubator.apache.org/install/index.html
>> > > > >with
>> > > > Nvidia
>> > > > <
>> > > >
>> > >
>> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
>> > > mxnet/
>> > > > >
>> > > > doesn't work anymore, it points to:
>> > > > https://mxnet.incubator.apache.org/install/index.html
>> > > >
>> > > > Also, on the MXNet 'getting started' page
>> > > > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
>> > > > Installation Guide" at the bottom doesn't work either, it points to:
>> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
>> > > >
>> > > >
>> > > > I suggest you do a scan of the new website to find these dangling
>> links.
>> > > >
>> > > > regards,
>> > > >
>> > > > Lieven
>> > > >
>> > > >
>> > > >
>> > > > > We'll formalize this in github issues next week, but they are all
>> > > fairly
>> > > > > small and helping out on these would be a great way of
>> > > > > familiarizing yourself with the new website build system and
>> website
>> > architecture.
>> > > > >
>> > > > >  Thanks all for the feedback, please keep it coming!
>> > > > >
>> > > > > Thomas Delteil
>> > > > >
>> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
>> > > > > <ha...@gmail.com> a écrit :
>> > > > >
>> > > > > > It looks like my previous email did not go through. Re-sending:
>> > > > > >
>> > > > > > Hi Aaron,
>> > > > > >
>> > > > > > The website looks cool. Thanks for pushing this to production. A
>> > > > > > few
>> > > > > > questions:
>> > > > > >
>> > > > > > - I was looking for the API doc for mx.sym.dot, but I find that
>> > > > > > most operators under mx.sym.* are missing. Is this expected?
>> > > > > > - I was also checking the search functionality, searching the
>> > > > > > keyword "ndarray" only returns one result
>> > > > > > "mxnet.ndarray.NDArray", which
>> > > > doesn't
>> > > > > > seem right. There animation keeps going (Searching. ->
>> > > > > > Searching.. -> Searching ...) and gives me an impression that
>> > > > > > the search is never completely done(?).
>> > > > > >
>> > > > > > Best,
>> > > > > > Haibin
>> > > > > >
>> > > > > >
>> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
>> > > chai.bapat@gmail.com>
>> > > > > > wrote:
>> > > > > >
>> > > > > > > Thanks Aaron and the team for launching new website!
>> > > > > > >
>> > > > > > > 1. There's no search button anywhere on the landing page.
>> > > > > > > 2. I wasn't able to find FAQ (and without search button I dont
>> > > > > > > have
>> > > > > > option
>> > > > > > > but to go manually on each menu). Only when I go to
>> > > > > > > Docs&Tutorials
>> > > ->
>> > > > > FAQ
>> > > > > > > -> Extend and Cotribute (that I got what I wanted).
>> > > > > > >
>> > > > > > > Suggestions
>> > > > > > > Might want to make this searchable and pop FAQ on the main
>> > > > > > > page (or somewhere prominent)
>> > > > > > >
>> > > > > > > Thanks,
>> > > > > > > Chai
>> > > > > > >
>> > > > > > >
>> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
>> > > ptrendx@apache.org>
>> > > > > > > wrote:
>> > > > > > >
>> > > > > > > > There seems to be a problem with (at least Python, did not
>> > > > > > > > check
>> > > > > > others)
>> > > > > > > > APIs. For example this page:
>> > > > > > > >
>> > > > > > > >
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
>> > > /mxnet.symbol.Symbol.argmax.html
>> > > > > > > >
>> > > > > > > > says that it is a convenience method for argmax (with a
>> > > > > > > > link),
>> > > but
>> > > > > > > > clicking that link just points to the same website (and so
>> > > > > > > > user
>> > > has
>> > > > > no
>> > > > > > > way
>> > > > > > > > of getting to the docs of the actual operator).
>> > > > > > > >
>> > > > > > > > When I tried to manually remove Symbol from the URL to get
>> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
>> > > > > > > > which I
>> > > guess
>> > > > > > also
>> > > > > > > > should not happen (ignoring the fact that this should exist,
>> > > going
>> > > > to
>> > > > > > > > random URL under the website should redirect to the main
>> > > > > > > > page I
>> > > > > think).
>> > > > > > > >
>> > > > > > > > Przemek
>> > > > > > > >
>> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
>> wrote:
>> > > > > > > > > Looks very neat. Thank you Aaron and many others for
>> > > > > > > > > launching
>> > > > > this!
>> > > > > > > > >
>> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
>> > > > carinmeier@gmail.com>
>> > > > > > > > wrote:
>> > > > > > > > >
>> > > > > > > > > > Nice!!! Congrats everyone!
>> > > > > > > > > >
>> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
>> > > > > > > > aaron.s.markham@gmail.com>
>> > > > > > > > > > wrote:
>> > > > > > > > > >
>> > > > > > > > > > > Alrighty! The new site is launched. You might need to
>> > > > > > > > > > > clear
>> > > > > your
>> > > > > > > > cache.
>> > > > > > > > > > >
>> > > > > > > > > > > Cheers,
>> > > > > > > > > > > Aaron
>> > > > > > > > > > >
>> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
>> > > > > > > > aaron.s.markham@gmail.com
>> > > > > > > > > > >
>> > > > > > > > > > > wrote:
>> > > > > > > > > > > >
>> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
>> > > > > > > > > > > > continue
>> > > > > holding
>> > > > > > > > off on
>> > > > > > > > > > > > docs and CI edits. Unless there are any objections,
>> > > > > > > > > > > > I'd
>> > > > like
>> > > > > to
>> > > > > > > > launch
>> > > > > > > > > > > > the new website today.
>> > > > > > > > > > > >
>> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
>> > > > > > > > > > aaron.s.markham@gmail.com>
>> > > > > > > > > > > wrote:
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > Hi everyone,
>> > > > > > > > > > > > > The last two PRs [1][2] for the new website and
>> > > > > > > > > > > > > docs
>> > > have
>> > > > > > > passed
>> > > > > > > > CI
>> > > > > > > > > > > > > (finally). Please do not make changes to /docs or
>> > > > > > > > > > > > > /ci
>> > > > until
>> > > > > > we
>> > > > > > > > get
>> > > > > > > > > > > > > these approved and merged. Every time there's a
>> > > > > > > > > > > > > merge
>> > > > > > conflict
>> > > > > > > > it has
>> > > > > > > > > > > > > set us back a day or two while shepherding the PRs
>> > > > through
>> > > > > CI
>> > > > > > > > again.
>> > > > > > > > > > > > > Unless there are catastrophic issues discovered in
>> > > > > > > > > > > > > a
>> > > > > review,
>> > > > > > I
>> > > > > > > > > > > > > recommend that we hold any patches or updates to
>> > > > > > > > > > > > > the
>> > > PRs
>> > > > to
>> > > > > > > > follow-up
>> > > > > > > > > > > > > PRs.
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > There are four steps to launch:
>> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to merge
>> > > 15885
>> > > > to
>> > > > > > > > delete
>> > > > > > > > > > the
>> > > > > > > > > > > > > old content first.
>> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the new
>> > > > > > > > > > > > > CI
>> > > > flows
>> > > > > > and
>> > > > > > > > > > updates
>> > > > > > > > > > > > > to the content Thomas and I have already had
>> > > > > > > > > > > > > merged in
>> > > > > 15884
>> > > > > > > [3].
>> > > > > > > > > > > > > 3. I will change the website validation Jenkins
>> > > pipeline
>> > > > to
>> > > > > > > > point to
>> > > > > > > > > > > > > the new pipeline.
>> > > > > > > > > > > > > 4. I will change the website publishing Jenkins
>> > > pipeline
>> > > > to
>> > > > > > > > point to
>> > > > > > > > > > > > > its new pipeline as well. Once triggered, the old
>> > > > > > > > > > > > > site
>> > > > will
>> > > > > > be
>> > > > > > > > > > > > > replaced with the new one.
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > Post launch we'll need to update the DNS for
>> > > > beta.mxnet.io
>> > > > > > to
>> > > > > > > > point
>> > > > > > > > > > to
>> > > > > > > > > > > > > production, and there will likely be some
>> > > > > redirect/.htaccess
>> > > > > > > > updates
>> > > > > > > > > > > > > needed next week to assist with any deep linking
>> > > > > > > > > > > > > and
>> > > 404
>> > > > > > issues
>> > > > > > > > that
>> > > > > > > > > > > > > pop up.
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > Cheers,
>> > > > > > > > > > > > > Aaron
>> > > > > > > > > > > > >
>> > > > > > > > > > > > > [1]
>> > > https://github.com/apache/incubator-mxnet/pull/15885
>> > > > > > > > > > > > > [2]
>> > > https://github.com/apache/incubator-mxnet/pull/15883
>> > > > > > > > > > > > > [3]
>> > > https://github.com/apache/incubator-mxnet/pull/15884
>> > > > > > > > > > >
>> > > > > > > > > >
>> > > > > > > > >
>> > > > > > > >
>> > > > > > >
>> > > > > > >
>> > > > > > > --
>> > > > > > > *Chaitanya Prakash Bapat*
>> > > > > > > *+1 (973) 953-6299*
>> > > > > > >
>> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
>> > > > > > > <https://github.com/ChaiBapchya>[image:
>> > > > > > https://www.facebook.com/chaibapat
>> > > > > > > ]
>> > > > > > > <https://www.facebook.com/chaibapchya>[image:
>> > > > > > > https://twitter.com/ChaiBapchya]
>> > > > > > ><https://twitter.com/ChaiBapchya
>> > > > > > >[image:
>> > > > > > > https://www.linkedin.com//in/chaibapat25]
>> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
>> > > > > > >
>> > > > > >
>> > > > >
>> > > >
>> > >
>>
>

Re: new website, docs code freeze

[Marco de Abreu <ma...@gmail.com>]

Hello,

I checked the Google Analytics statistics and the launch of the new website
reduced the traffic by over 80%:

[image: image.png]

(Please let me know if the image is not visible)

How shall we handle this?

Best regards,
Marco

On Mon, Sep 23, 2019 at 7:30 AM Zhao, Patric <pa...@intel.com> wrote:

> For the install page [1], I suggest to add the selection of backend
> DeepNumpy [2] which will be more clean.
>
> [1] http://mxnet.incubator.apache.org/index.html
> [2] https://numpy.mxnet.io/#installation
>
>
>
> > -----Original Message-----
> > From: kellen sunderland <ke...@gmail.com>
> > Sent: Monday, September 23, 2019 12:47 PM
> > To: dev@mxnet.incubator.apache.org
> > Subject: Re: new website, docs code freeze
> >
> > New site looks good.  I do notice that a few tutorials from the old site
> are
> > missing (for example the TensorRT tutorial).  Any plans to bring them
> back?
> >
> > On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <ha...@gmail.com>
> > wrote:
> >
> > > Another issue I found with the current website: the Sphinx object
> > > inventory
> > > <https://www.sphinx-
> > doc.org/en/master/usage/extensions/intersphinx.htm
> > > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
> > > relies on this file to link document across projects. Shall we add it
> > > back?
> > >
> > > Best,
> > > Haibin
> > >
> > > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be> wrote:
> > >
> > > > Hi,
> > > >
> > > >
> > > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > > <th...@gmail.com>
> > > > wrote:
> > > >
> > > > > Thanks all for the feedback,
> > > > >
> > > > > We'll send an email next week with the list of missing features,
> > > content
> > > > > and bugs that we plan to fix.
> > > > > We took the option of releasing early, with some features missing,
> > > rather
> > > > > than trying to be at feature parity with the old website before
> > > launching
> > > > > the website.
> > > > > The reason why we decided to do that is two-fold:
> > > > > - playing catch-up with docs in master introduce daily conflicts
> > > > > that
> > > > need
> > > > > to be resolved and introduce opportunity for errors
> > > > > - by releasing early, we can take advantage of the community
> > > > contributions
> > > > > in modifying whatever the community feels like a better way of
> > > > > doing things.
> > > > >
> > > > > One of the goals of the new website was to disentangle the main
> > > website,
> > > > > now called "static_site" to the auto-generated docs. Now the
> > > > > overall
> > > site
> > > > > is made of a main static site, with easy to modify content and
> > > > > easy to understand architecture for anybody familiar with basic
> > > > > html, and a collection of mini-websites for each language bindings
> > > > > that can be
> > > built
> > > > in
> > > > > isolation and that are self-contained. Actually the new CI jobs
> > > > > builds
> > > > all
> > > > > of them in parallel independently.
> > > > >
> > > > > There is PLENTY of room for improvement, it would be great if the
> > > > community
> > > > > can help contribute to bring the new website at the same level of
> > > content
> > > > > richness as the old one, and then even further.
> > > > >
> > > > > Missing features:
> > > > > - As pointed by Haibin, the API docs do not have the full list of
> > > > operators
> > > > > and classes. There is a mix of auto-generated docs based on
> > > > > packages,
> > > and
> > > > > some docs that are spelled out manually to improve the logical
> > > > organization
> > > > > of the package where there is a need. The drawback with manually
> > > > > listed classes in a package is that it's very easy to miss some.
> > > > > If someone
> > > > wanted
> > > > > to build a sanity check that would automatically detect which
> > > > > classes
> > > are
> > > > > not in the documentation, or if someone knew how to enable that
> > > > > with sphinx, that would be a great addition to the python docs
> > > > > - There is missing content in the python tutorials, and the
> > > > discoverability
> > > > > could be improved. Some old tutorials have not been migrated just
> yet.
> > > > > - The nightly tests on tutorials have been disabled for now
> > > > > - There is no "Download jupyter notebook" for tutorials just yet.
> > > > > - Non-python tutorials might benefit from a blurb description and
> > > > > a
> > > > better
> > > > > content organization.
> > > > > - Python tutorials could be better organized, have a picture
> > > accompanying
> > > > > their description
> > > > > - There is no site-wide search, this is not an easy problem to
> > > > > solve to
> > > > be
> > > > > fair given the static nature of the website, but maybe an external
> > > plugin
> > > > > might be able to give a half-way solution
> > > > > - There is no version selector for the docs
> > > > > - There is bug in search box of the python docs, but this is just
> > > > > a
> > > small
> > > > > JS bug that can be fixed easily (on my list for next week)
> > > > > - Most old links have not had a redirect put in place.
> > > > >
> > > > >
> > > > I noticed on the Ubuntu home page in the Developer dropdown that the
> > > > link MXNet on Ubuntu
> > > > <https://mxnet.incubator.apache.org/install/index.html
> > > > >with
> > > > Nvidia
> > > > <
> > > >
> > > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > > mxnet/
> > > > >
> > > > doesn't work anymore, it points to:
> > > > https://mxnet.incubator.apache.org/install/index.html
> > > >
> > > > Also, on the MXNet 'getting started' page
> > > > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
> > > > Installation Guide" at the bottom doesn't work either, it points to:
> > > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > > >
> > > >
> > > > I suggest you do a scan of the new website to find these dangling
> links.
> > > >
> > > > regards,
> > > >
> > > > Lieven
> > > >
> > > >
> > > >
> > > > > We'll formalize this in github issues next week, but they are all
> > > fairly
> > > > > small and helping out on these would be a great way of
> > > > > familiarizing yourself with the new website build system and
> website
> > architecture.
> > > > >
> > > > >  Thanks all for the feedback, please keep it coming!
> > > > >
> > > > > Thomas Delteil
> > > > >
> > > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > > <ha...@gmail.com> a écrit :
> > > > >
> > > > > > It looks like my previous email did not go through. Re-sending:
> > > > > >
> > > > > > Hi Aaron,
> > > > > >
> > > > > > The website looks cool. Thanks for pushing this to production. A
> > > > > > few
> > > > > > questions:
> > > > > >
> > > > > > - I was looking for the API doc for mx.sym.dot, but I find that
> > > > > > most operators under mx.sym.* are missing. Is this expected?
> > > > > > - I was also checking the search functionality, searching the
> > > > > > keyword "ndarray" only returns one result
> > > > > > "mxnet.ndarray.NDArray", which
> > > > doesn't
> > > > > > seem right. There animation keeps going (Searching. ->
> > > > > > Searching.. -> Searching ...) and gives me an impression that
> > > > > > the search is never completely done(?).
> > > > > >
> > > > > > Best,
> > > > > > Haibin
> > > > > >
> > > > > >
> > > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > > chai.bapat@gmail.com>
> > > > > > wrote:
> > > > > >
> > > > > > > Thanks Aaron and the team for launching new website!
> > > > > > >
> > > > > > > 1. There's no search button anywhere on the landing page.
> > > > > > > 2. I wasn't able to find FAQ (and without search button I dont
> > > > > > > have
> > > > > > option
> > > > > > > but to go manually on each menu). Only when I go to
> > > > > > > Docs&Tutorials
> > > ->
> > > > > FAQ
> > > > > > > -> Extend and Cotribute (that I got what I wanted).
> > > > > > >
> > > > > > > Suggestions
> > > > > > > Might want to make this searchable and pop FAQ on the main
> > > > > > > page (or somewhere prominent)
> > > > > > >
> > > > > > > Thanks,
> > > > > > > Chai
> > > > > > >
> > > > > > >
> > > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > > ptrendx@apache.org>
> > > > > > > wrote:
> > > > > > >
> > > > > > > > There seems to be a problem with (at least Python, did not
> > > > > > > > check
> > > > > > others)
> > > > > > > > APIs. For example this page:
> > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> > https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > > /mxnet.symbol.Symbol.argmax.html
> > > > > > > >
> > > > > > > > says that it is a convenience method for argmax (with a
> > > > > > > > link),
> > > but
> > > > > > > > clicking that link just points to the same website (and so
> > > > > > > > user
> > > has
> > > > > no
> > > > > > > way
> > > > > > > > of getting to the docs of the actual operator).
> > > > > > > >
> > > > > > > > When I tried to manually remove Symbol from the URL to get
> > > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
> > > > > > > > which I
> > > guess
> > > > > > also
> > > > > > > > should not happen (ignoring the fact that this should exist,
> > > going
> > > > to
> > > > > > > > random URL under the website should redirect to the main
> > > > > > > > page I
> > > > > think).
> > > > > > > >
> > > > > > > > Przemek
> > > > > > > >
> > > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com>
> wrote:
> > > > > > > > > Looks very neat. Thank you Aaron and many others for
> > > > > > > > > launching
> > > > > this!
> > > > > > > > >
> > > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > > > carinmeier@gmail.com>
> > > > > > > > wrote:
> > > > > > > > >
> > > > > > > > > > Nice!!! Congrats everyone!
> > > > > > > > > >
> > > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > > > > > > aaron.s.markham@gmail.com>
> > > > > > > > > > wrote:
> > > > > > > > > >
> > > > > > > > > > > Alrighty! The new site is launched. You might need to
> > > > > > > > > > > clear
> > > > > your
> > > > > > > > cache.
> > > > > > > > > > >
> > > > > > > > > > > Cheers,
> > > > > > > > > > > Aaron
> > > > > > > > > > >
> > > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > > > > > > aaron.s.markham@gmail.com
> > > > > > > > > > >
> > > > > > > > > > > wrote:
> > > > > > > > > > > >
> > > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> > > > > > > > > > > > continue
> > > > > holding
> > > > > > > > off on
> > > > > > > > > > > > docs and CI edits. Unless there are any objections,
> > > > > > > > > > > > I'd
> > > > like
> > > > > to
> > > > > > > > launch
> > > > > > > > > > > > the new website today.
> > > > > > > > > > > >
> > > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > > > > > > aaron.s.markham@gmail.com>
> > > > > > > > > > > wrote:
> > > > > > > > > > > > >
> > > > > > > > > > > > > Hi everyone,
> > > > > > > > > > > > > The last two PRs [1][2] for the new website and
> > > > > > > > > > > > > docs
> > > have
> > > > > > > passed
> > > > > > > > CI
> > > > > > > > > > > > > (finally). Please do not make changes to /docs or
> > > > > > > > > > > > > /ci
> > > > until
> > > > > > we
> > > > > > > > get
> > > > > > > > > > > > > these approved and merged. Every time there's a
> > > > > > > > > > > > > merge
> > > > > > conflict
> > > > > > > > it has
> > > > > > > > > > > > > set us back a day or two while shepherding the PRs
> > > > through
> > > > > CI
> > > > > > > > again.
> > > > > > > > > > > > > Unless there are catastrophic issues discovered in
> > > > > > > > > > > > > a
> > > > > review,
> > > > > > I
> > > > > > > > > > > > > recommend that we hold any patches or updates to
> > > > > > > > > > > > > the
> > > PRs
> > > > to
> > > > > > > > follow-up
> > > > > > > > > > > > > PRs.
> > > > > > > > > > > > >
> > > > > > > > > > > > > There are four steps to launch:
> > > > > > > > > > > > > 1. Once the PRs are approved, the plan is to merge
> > > 15885
> > > > to
> > > > > > > > delete
> > > > > > > > > > the
> > > > > > > > > > > > > old content first.
> > > > > > > > > > > > > 2. Then immediately merge 15883 to add in the new
> > > > > > > > > > > > > CI
> > > > flows
> > > > > > and
> > > > > > > > > > updates
> > > > > > > > > > > > > to the content Thomas and I have already had
> > > > > > > > > > > > > merged in
> > > > > 15884
> > > > > > > [3].
> > > > > > > > > > > > > 3. I will change the website validation Jenkins
> > > pipeline
> > > > to
> > > > > > > > point to
> > > > > > > > > > > > > the new pipeline.
> > > > > > > > > > > > > 4. I will change the website publishing Jenkins
> > > pipeline
> > > > to
> > > > > > > > point to
> > > > > > > > > > > > > its new pipeline as well. Once triggered, the old
> > > > > > > > > > > > > site
> > > > will
> > > > > > be
> > > > > > > > > > > > > replaced with the new one.
> > > > > > > > > > > > >
> > > > > > > > > > > > > Post launch we'll need to update the DNS for
> > > > beta.mxnet.io
> > > > > > to
> > > > > > > > point
> > > > > > > > > > to
> > > > > > > > > > > > > production, and there will likely be some
> > > > > redirect/.htaccess
> > > > > > > > updates
> > > > > > > > > > > > > needed next week to assist with any deep linking
> > > > > > > > > > > > > and
> > > 404
> > > > > > issues
> > > > > > > > that
> > > > > > > > > > > > > pop up.
> > > > > > > > > > > > >
> > > > > > > > > > > > > Cheers,
> > > > > > > > > > > > > Aaron
> > > > > > > > > > > > >
> > > > > > > > > > > > > [1]
> > > https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > > > > > > [2]
> > > https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > > > > > > [3]
> > > https://github.com/apache/incubator-mxnet/pull/15884
> > > > > > > > > > >
> > > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > > >
> > > > > > > --
> > > > > > > *Chaitanya Prakash Bapat*
> > > > > > > *+1 (973) 953-6299*
> > > > > > >
> > > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > > > > > <https://github.com/ChaiBapchya>[image:
> > > > > > https://www.facebook.com/chaibapat
> > > > > > > ]
> > > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > > > > > https://twitter.com/ChaiBapchya]
> > > > > > ><https://twitter.com/ChaiBapchya
> > > > > > >[image:
> > > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
>

RE: new website, docs code freeze

["Zhao, Patric" <pa...@intel.com>]

For the install page [1], I suggest to add the selection of backend DeepNumpy [2] which will be more clean.

[1] http://mxnet.incubator.apache.org/index.html
[2] https://numpy.mxnet.io/#installation



> -----Original Message-----
> From: kellen sunderland <ke...@gmail.com>
> Sent: Monday, September 23, 2019 12:47 PM
> To: dev@mxnet.incubator.apache.org
> Subject: Re: new website, docs code freeze
> 
> New site looks good.  I do notice that a few tutorials from the old site are
> missing (for example the TensorRT tutorial).  Any plans to bring them back?
> 
> On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <ha...@gmail.com>
> wrote:
> 
> > Another issue I found with the current website: the Sphinx object
> > inventory
> > <https://www.sphinx-
> doc.org/en/master/usage/extensions/intersphinx.htm
> > l> file https://mxnet.apache.org/objects.inv is missing. GluonNLP
> > relies on this file to link document across projects. Shall we add it
> > back?
> >
> > Best,
> > Haibin
> >
> > On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be> wrote:
> >
> > > Hi,
> > >
> > >
> > > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL
> > > <th...@gmail.com>
> > > wrote:
> > >
> > > > Thanks all for the feedback,
> > > >
> > > > We'll send an email next week with the list of missing features,
> > content
> > > > and bugs that we plan to fix.
> > > > We took the option of releasing early, with some features missing,
> > rather
> > > > than trying to be at feature parity with the old website before
> > launching
> > > > the website.
> > > > The reason why we decided to do that is two-fold:
> > > > - playing catch-up with docs in master introduce daily conflicts
> > > > that
> > > need
> > > > to be resolved and introduce opportunity for errors
> > > > - by releasing early, we can take advantage of the community
> > > contributions
> > > > in modifying whatever the community feels like a better way of
> > > > doing things.
> > > >
> > > > One of the goals of the new website was to disentangle the main
> > website,
> > > > now called "static_site" to the auto-generated docs. Now the
> > > > overall
> > site
> > > > is made of a main static site, with easy to modify content and
> > > > easy to understand architecture for anybody familiar with basic
> > > > html, and a collection of mini-websites for each language bindings
> > > > that can be
> > built
> > > in
> > > > isolation and that are self-contained. Actually the new CI jobs
> > > > builds
> > > all
> > > > of them in parallel independently.
> > > >
> > > > There is PLENTY of room for improvement, it would be great if the
> > > community
> > > > can help contribute to bring the new website at the same level of
> > content
> > > > richness as the old one, and then even further.
> > > >
> > > > Missing features:
> > > > - As pointed by Haibin, the API docs do not have the full list of
> > > operators
> > > > and classes. There is a mix of auto-generated docs based on
> > > > packages,
> > and
> > > > some docs that are spelled out manually to improve the logical
> > > organization
> > > > of the package where there is a need. The drawback with manually
> > > > listed classes in a package is that it's very easy to miss some.
> > > > If someone
> > > wanted
> > > > to build a sanity check that would automatically detect which
> > > > classes
> > are
> > > > not in the documentation, or if someone knew how to enable that
> > > > with sphinx, that would be a great addition to the python docs
> > > > - There is missing content in the python tutorials, and the
> > > discoverability
> > > > could be improved. Some old tutorials have not been migrated just yet.
> > > > - The nightly tests on tutorials have been disabled for now
> > > > - There is no "Download jupyter notebook" for tutorials just yet.
> > > > - Non-python tutorials might benefit from a blurb description and
> > > > a
> > > better
> > > > content organization.
> > > > - Python tutorials could be better organized, have a picture
> > accompanying
> > > > their description
> > > > - There is no site-wide search, this is not an easy problem to
> > > > solve to
> > > be
> > > > fair given the static nature of the website, but maybe an external
> > plugin
> > > > might be able to give a half-way solution
> > > > - There is no version selector for the docs
> > > > - There is bug in search box of the python docs, but this is just
> > > > a
> > small
> > > > JS bug that can be fixed easily (on my list for next week)
> > > > - Most old links have not had a redirect put in place.
> > > >
> > > >
> > > I noticed on the Ubuntu home page in the Developer dropdown that the
> > > link MXNet on Ubuntu
> > > <https://mxnet.incubator.apache.org/install/index.html
> > > >with
> > > Nvidia
> > > <
> > >
> > https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/
> > mxnet/
> > > >
> > > doesn't work anymore, it points to:
> > > https://mxnet.incubator.apache.org/install/index.html
> > >
> > > Also, on the MXNet 'getting started' page
> > > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
> > > Installation Guide" at the bottom doesn't work either, it points to:
> > > https://mxnet.incubator.apache.org/ubuntu_setup.html
> > >
> > >
> > > I suggest you do a scan of the new website to find these dangling links.
> > >
> > > regards,
> > >
> > > Lieven
> > >
> > >
> > >
> > > > We'll formalize this in github issues next week, but they are all
> > fairly
> > > > small and helping out on these would be a great way of
> > > > familiarizing yourself with the new website build system and website
> architecture.
> > > >
> > > >  Thanks all for the feedback, please keep it coming!
> > > >
> > > > Thomas Delteil
> > > >
> > > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin
> > > > <ha...@gmail.com> a écrit :
> > > >
> > > > > It looks like my previous email did not go through. Re-sending:
> > > > >
> > > > > Hi Aaron,
> > > > >
> > > > > The website looks cool. Thanks for pushing this to production. A
> > > > > few
> > > > > questions:
> > > > >
> > > > > - I was looking for the API doc for mx.sym.dot, but I find that
> > > > > most operators under mx.sym.* are missing. Is this expected?
> > > > > - I was also checking the search functionality, searching the
> > > > > keyword "ndarray" only returns one result
> > > > > "mxnet.ndarray.NDArray", which
> > > doesn't
> > > > > seem right. There animation keeps going (Searching. ->
> > > > > Searching.. -> Searching ...) and gives me an impression that
> > > > > the search is never completely done(?).
> > > > >
> > > > > Best,
> > > > > Haibin
> > > > >
> > > > >
> > > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> > chai.bapat@gmail.com>
> > > > > wrote:
> > > > >
> > > > > > Thanks Aaron and the team for launching new website!
> > > > > >
> > > > > > 1. There's no search button anywhere on the landing page.
> > > > > > 2. I wasn't able to find FAQ (and without search button I dont
> > > > > > have
> > > > > option
> > > > > > but to go manually on each menu). Only when I go to
> > > > > > Docs&Tutorials
> > ->
> > > > FAQ
> > > > > > -> Extend and Cotribute (that I got what I wanted).
> > > > > >
> > > > > > Suggestions
> > > > > > Might want to make this searchable and pop FAQ on the main
> > > > > > page (or somewhere prominent)
> > > > > >
> > > > > > Thanks,
> > > > > > Chai
> > > > > >
> > > > > >
> > > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> > ptrendx@apache.org>
> > > > > > wrote:
> > > > > >
> > > > > > > There seems to be a problem with (at least Python, did not
> > > > > > > check
> > > > > others)
> > > > > > > APIs. For example this page:
> > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > /mxnet.symbol.Symbol.argmax.html
> > > > > > >
> > > > > > > says that it is a convenience method for argmax (with a
> > > > > > > link),
> > but
> > > > > > > clicking that link just points to the same website (and so
> > > > > > > user
> > has
> > > > no
> > > > > > way
> > > > > > > of getting to the docs of the actual operator).
> > > > > > >
> > > > > > > When I tried to manually remove Symbol from the URL to get
> > > > > > > to mxnet.symbol.argmax.html, I got a "Not found" webpage
> > > > > > > which I
> > guess
> > > > > also
> > > > > > > should not happen (ignoring the fact that this should exist,
> > going
> > > to
> > > > > > > random URL under the website should redirect to the main
> > > > > > > page I
> > > > think).
> > > > > > >
> > > > > > > Przemek
> > > > > > >
> > > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > > > > > > Looks very neat. Thank you Aaron and many others for
> > > > > > > > launching
> > > > this!
> > > > > > > >
> > > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > > carinmeier@gmail.com>
> > > > > > > wrote:
> > > > > > > >
> > > > > > > > > Nice!!! Congrats everyone!
> > > > > > > > >
> > > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > > > > > aaron.s.markham@gmail.com>
> > > > > > > > > wrote:
> > > > > > > > >
> > > > > > > > > > Alrighty! The new site is launched. You might need to
> > > > > > > > > > clear
> > > > your
> > > > > > > cache.
> > > > > > > > > >
> > > > > > > > > > Cheers,
> > > > > > > > > > Aaron
> > > > > > > > > >
> > > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > > > > > aaron.s.markham@gmail.com
> > > > > > > > > >
> > > > > > > > > > wrote:
> > > > > > > > > > >
> > > > > > > > > > > Thanks everyone. The PRs passed CI, but please
> > > > > > > > > > > continue
> > > > holding
> > > > > > > off on
> > > > > > > > > > > docs and CI edits. Unless there are any objections,
> > > > > > > > > > > I'd
> > > like
> > > > to
> > > > > > > launch
> > > > > > > > > > > the new website today.
> > > > > > > > > > >
> > > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > > > > > aaron.s.markham@gmail.com>
> > > > > > > > > > wrote:
> > > > > > > > > > > >
> > > > > > > > > > > > Hi everyone,
> > > > > > > > > > > > The last two PRs [1][2] for the new website and
> > > > > > > > > > > > docs
> > have
> > > > > > passed
> > > > > > > CI
> > > > > > > > > > > > (finally). Please do not make changes to /docs or
> > > > > > > > > > > > /ci
> > > until
> > > > > we
> > > > > > > get
> > > > > > > > > > > > these approved and merged. Every time there's a
> > > > > > > > > > > > merge
> > > > > conflict
> > > > > > > it has
> > > > > > > > > > > > set us back a day or two while shepherding the PRs
> > > through
> > > > CI
> > > > > > > again.
> > > > > > > > > > > > Unless there are catastrophic issues discovered in
> > > > > > > > > > > > a
> > > > review,
> > > > > I
> > > > > > > > > > > > recommend that we hold any patches or updates to
> > > > > > > > > > > > the
> > PRs
> > > to
> > > > > > > follow-up
> > > > > > > > > > > > PRs.
> > > > > > > > > > > >
> > > > > > > > > > > > There are four steps to launch:
> > > > > > > > > > > > 1. Once the PRs are approved, the plan is to merge
> > 15885
> > > to
> > > > > > > delete
> > > > > > > > > the
> > > > > > > > > > > > old content first.
> > > > > > > > > > > > 2. Then immediately merge 15883 to add in the new
> > > > > > > > > > > > CI
> > > flows
> > > > > and
> > > > > > > > > updates
> > > > > > > > > > > > to the content Thomas and I have already had
> > > > > > > > > > > > merged in
> > > > 15884
> > > > > > [3].
> > > > > > > > > > > > 3. I will change the website validation Jenkins
> > pipeline
> > > to
> > > > > > > point to
> > > > > > > > > > > > the new pipeline.
> > > > > > > > > > > > 4. I will change the website publishing Jenkins
> > pipeline
> > > to
> > > > > > > point to
> > > > > > > > > > > > its new pipeline as well. Once triggered, the old
> > > > > > > > > > > > site
> > > will
> > > > > be
> > > > > > > > > > > > replaced with the new one.
> > > > > > > > > > > >
> > > > > > > > > > > > Post launch we'll need to update the DNS for
> > > beta.mxnet.io
> > > > > to
> > > > > > > point
> > > > > > > > > to
> > > > > > > > > > > > production, and there will likely be some
> > > > redirect/.htaccess
> > > > > > > updates
> > > > > > > > > > > > needed next week to assist with any deep linking
> > > > > > > > > > > > and
> > 404
> > > > > issues
> > > > > > > that
> > > > > > > > > > > > pop up.
> > > > > > > > > > > >
> > > > > > > > > > > > Cheers,
> > > > > > > > > > > > Aaron
> > > > > > > > > > > >
> > > > > > > > > > > > [1]
> > https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > > > > > [2]
> > https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > > > > > [3]
> > https://github.com/apache/incubator-mxnet/pull/15884
> > > > > > > > > >
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > > >
> > > > > > --
> > > > > > *Chaitanya Prakash Bapat*
> > > > > > *+1 (973) 953-6299*
> > > > > >
> > > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > > > > <https://github.com/ChaiBapchya>[image:
> > > > > https://www.facebook.com/chaibapat
> > > > > > ]
> > > > > > <https://www.facebook.com/chaibapchya>[image:
> > > > > > https://twitter.com/ChaiBapchya]
> > > > > ><https://twitter.com/ChaiBapchya
> > > > > >[image:
> > > > > > https://www.linkedin.com//in/chaibapat25]
> > > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > > > >
> > > > >
> > > >
> > >
> >

Re: new website, docs code freeze

[kellen sunderland <ke...@gmail.com>]

New site looks good.  I do notice that a few tutorials from the old site
are missing (for example the TensorRT tutorial).  Any plans to bring them
back?

On Sun, Sep 22, 2019 at 10:04 AM Haibin Lin <ha...@gmail.com>
wrote:

> Another issue I found with the current website: the Sphinx object inventory
> <https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html>
> file https://mxnet.apache.org/objects.inv is missing. GluonNLP relies on
> this file to link document across projects. Shall we add it back?
>
> Best,
> Haibin
>
> On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be> wrote:
>
> > Hi,
> >
> >
> > On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL <th...@gmail.com>
> > wrote:
> >
> > > Thanks all for the feedback,
> > >
> > > We'll send an email next week with the list of missing features,
> content
> > > and bugs that we plan to fix.
> > > We took the option of releasing early, with some features missing,
> rather
> > > than trying to be at feature parity with the old website before
> launching
> > > the website.
> > > The reason why we decided to do that is two-fold:
> > > - playing catch-up with docs in master introduce daily conflicts that
> > need
> > > to be resolved and introduce opportunity for errors
> > > - by releasing early, we can take advantage of the community
> > contributions
> > > in modifying whatever the community feels like a better way of doing
> > > things.
> > >
> > > One of the goals of the new website was to disentangle the main
> website,
> > > now called "static_site" to the auto-generated docs. Now the overall
> site
> > > is made of a main static site, with easy to modify content and easy to
> > > understand architecture for anybody familiar with basic html, and a
> > > collection of mini-websites for each language bindings that can be
> built
> > in
> > > isolation and that are self-contained. Actually the new CI jobs builds
> > all
> > > of them in parallel independently.
> > >
> > > There is PLENTY of room for improvement, it would be great if the
> > community
> > > can help contribute to bring the new website at the same level of
> content
> > > richness as the old one, and then even further.
> > >
> > > Missing features:
> > > - As pointed by Haibin, the API docs do not have the full list of
> > operators
> > > and classes. There is a mix of auto-generated docs based on packages,
> and
> > > some docs that are spelled out manually to improve the logical
> > organization
> > > of the package where there is a need. The drawback with manually listed
> > > classes in a package is that it's very easy to miss some. If someone
> > wanted
> > > to build a sanity check that would automatically detect which classes
> are
> > > not in the documentation, or if someone knew how to enable that with
> > > sphinx, that would be a great addition to the python docs
> > > - There is missing content in the python tutorials, and the
> > discoverability
> > > could be improved. Some old tutorials have not been migrated just yet.
> > > - The nightly tests on tutorials have been disabled for now
> > > - There is no "Download jupyter notebook" for tutorials just yet.
> > > - Non-python tutorials might benefit from a blurb description and a
> > better
> > > content organization.
> > > - Python tutorials could be better organized, have a picture
> accompanying
> > > their description
> > > - There is no site-wide search, this is not an easy problem to solve to
> > be
> > > fair given the static nature of the website, but maybe an external
> plugin
> > > might be able to give a half-way solution
> > > - There is no version selector for the docs
> > > - There is bug in search box of the python docs, but this is just a
> small
> > > JS bug that can be fixed easily (on my list for next week)
> > > - Most old links have not had a redirect put in place.
> > >
> > >
> > I noticed on the Ubuntu home page in the Developer dropdown that the link
> > MXNet on Ubuntu <https://mxnet.incubator.apache.org/install/index.html
> > >with
> > Nvidia
> > <
> >
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/mxnet/
> > >
> > doesn't work anymore, it points to:
> > https://mxnet.incubator.apache.org/install/index.html
> >
> > Also, on the MXNet 'getting started' page
> > https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
> > Installation Guide" at the bottom doesn't work either, it points to:
> > https://mxnet.incubator.apache.org/ubuntu_setup.html
> >
> >
> > I suggest you do a scan of the new website to find these dangling links.
> >
> > regards,
> >
> > Lieven
> >
> >
> >
> > > We'll formalize this in github issues next week, but they are all
> fairly
> > > small and helping out on these would be a great way of familiarizing
> > > yourself with the new website build system and website architecture.
> > >
> > >  Thanks all for the feedback, please keep it coming!
> > >
> > > Thomas Delteil
> > >
> > > Le sam. 21 sept. 2019 à 09:53, Haibin Lin <ha...@gmail.com> a
> > > écrit :
> > >
> > > > It looks like my previous email did not go through. Re-sending:
> > > >
> > > > Hi Aaron,
> > > >
> > > > The website looks cool. Thanks for pushing this to production. A few
> > > > questions:
> > > >
> > > > - I was looking for the API doc for mx.sym.dot, but I find that most
> > > > operators under mx.sym.* are missing. Is this expected?
> > > > - I was also checking the search functionality, searching the keyword
> > > > "ndarray" only returns one result "mxnet.ndarray.NDArray", which
> > doesn't
> > > > seem right. There animation keeps going (Searching. -> Searching.. ->
> > > > Searching ...) and gives me an impression that the search is never
> > > > completely done(?).
> > > >
> > > > Best,
> > > > Haibin
> > > >
> > > >
> > > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <
> chai.bapat@gmail.com>
> > > > wrote:
> > > >
> > > > > Thanks Aaron and the team for launching new website!
> > > > >
> > > > > 1. There's no search button anywhere on the landing page.
> > > > > 2. I wasn't able to find FAQ (and without search button I dont have
> > > > option
> > > > > but to go manually on each menu). Only when I go to Docs&Tutorials
> ->
> > > FAQ
> > > > > -> Extend and Cotribute (that I got what I wanted).
> > > > >
> > > > > Suggestions
> > > > > Might want to make this searchable and pop FAQ on the main page (or
> > > > > somewhere prominent)
> > > > >
> > > > > Thanks,
> > > > > Chai
> > > > >
> > > > >
> > > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <
> ptrendx@apache.org>
> > > > > wrote:
> > > > >
> > > > > > There seems to be a problem with (at least Python, did not check
> > > > others)
> > > > > > APIs. For example this page:
> > > > > >
> > > > > >
> > > > >
> > > >
> > >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html
> > > > > >
> > > > > > says that it is a convenience method for argmax (with a link),
> but
> > > > > > clicking that link just points to the same website (and so user
> has
> > > no
> > > > > way
> > > > > > of getting to the docs of the actual operator).
> > > > > >
> > > > > > When I tried to manually remove Symbol from the URL to get to
> > > > > > mxnet.symbol.argmax.html, I got a "Not found" webpage which I
> guess
> > > > also
> > > > > > should not happen (ignoring the fact that this should exist,
> going
> > to
> > > > > > random URL under the website should redirect to the main page I
> > > think).
> > > > > >
> > > > > > Przemek
> > > > > >
> > > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > > > > > Looks very neat. Thank you Aaron and many others for launching
> > > this!
> > > > > > >
> > > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> > carinmeier@gmail.com>
> > > > > > wrote:
> > > > > > >
> > > > > > > > Nice!!! Congrats everyone!
> > > > > > > >
> > > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > > > > aaron.s.markham@gmail.com>
> > > > > > > > wrote:
> > > > > > > >
> > > > > > > > > Alrighty! The new site is launched. You might need to clear
> > > your
> > > > > > cache.
> > > > > > > > >
> > > > > > > > > Cheers,
> > > > > > > > > Aaron
> > > > > > > > >
> > > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > > > > aaron.s.markham@gmail.com
> > > > > > > > >
> > > > > > > > > wrote:
> > > > > > > > > >
> > > > > > > > > > Thanks everyone. The PRs passed CI, but please continue
> > > holding
> > > > > > off on
> > > > > > > > > > docs and CI edits. Unless there are any objections, I'd
> > like
> > > to
> > > > > > launch
> > > > > > > > > > the new website today.
> > > > > > > > > >
> > > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > > > > aaron.s.markham@gmail.com>
> > > > > > > > > wrote:
> > > > > > > > > > >
> > > > > > > > > > > Hi everyone,
> > > > > > > > > > > The last two PRs [1][2] for the new website and docs
> have
> > > > > passed
> > > > > > CI
> > > > > > > > > > > (finally). Please do not make changes to /docs or /ci
> > until
> > > > we
> > > > > > get
> > > > > > > > > > > these approved and merged. Every time there's a merge
> > > > conflict
> > > > > > it has
> > > > > > > > > > > set us back a day or two while shepherding the PRs
> > through
> > > CI
> > > > > > again.
> > > > > > > > > > > Unless there are catastrophic issues discovered in a
> > > review,
> > > > I
> > > > > > > > > > > recommend that we hold any patches or updates to the
> PRs
> > to
> > > > > > follow-up
> > > > > > > > > > > PRs.
> > > > > > > > > > >
> > > > > > > > > > > There are four steps to launch:
> > > > > > > > > > > 1. Once the PRs are approved, the plan is to merge
> 15885
> > to
> > > > > > delete
> > > > > > > > the
> > > > > > > > > > > old content first.
> > > > > > > > > > > 2. Then immediately merge 15883 to add in the new CI
> > flows
> > > > and
> > > > > > > > updates
> > > > > > > > > > > to the content Thomas and I have already had merged in
> > > 15884
> > > > > [3].
> > > > > > > > > > > 3. I will change the website validation Jenkins
> pipeline
> > to
> > > > > > point to
> > > > > > > > > > > the new pipeline.
> > > > > > > > > > > 4. I will change the website publishing Jenkins
> pipeline
> > to
> > > > > > point to
> > > > > > > > > > > its new pipeline as well. Once triggered, the old site
> > will
> > > > be
> > > > > > > > > > > replaced with the new one.
> > > > > > > > > > >
> > > > > > > > > > > Post launch we'll need to update the DNS for
> > beta.mxnet.io
> > > > to
> > > > > > point
> > > > > > > > to
> > > > > > > > > > > production, and there will likely be some
> > > redirect/.htaccess
> > > > > > updates
> > > > > > > > > > > needed next week to assist with any deep linking and
> 404
> > > > issues
> > > > > > that
> > > > > > > > > > > pop up.
> > > > > > > > > > >
> > > > > > > > > > > Cheers,
> > > > > > > > > > > Aaron
> > > > > > > > > > >
> > > > > > > > > > > [1]
> https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > > > > [2]
> https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > > > > [3]
> https://github.com/apache/incubator-mxnet/pull/15884
> > > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > > >
> > > > > --
> > > > > *Chaitanya Prakash Bapat*
> > > > > *+1 (973) 953-6299*
> > > > >
> > > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > > > <https://github.com/ChaiBapchya>[image:
> > > > https://www.facebook.com/chaibapat
> > > > > ]
> > > > > <https://www.facebook.com/chaibapchya>[image:
> > > > > https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya
> > > > >[image:
> > > > > https://www.linkedin.com//in/chaibapat25]
> > > > > <https://www.linkedin.com//in/chaibapchya/>
> > > > >
> > > >
> > >
> >
>

Re: new website, docs code freeze

[Haibin Lin <ha...@gmail.com>]

Another issue I found with the current website: the Sphinx object inventory
<https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html>
file https://mxnet.apache.org/objects.inv is missing. GluonNLP relies on
this file to link document across projects. Shall we add it back?

Best,
Haibin

On Sun, Sep 22, 2019 at 2:04 AM Lieven Govaerts <lg...@mobsol.be> wrote:

> Hi,
>
>
> On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL <th...@gmail.com>
> wrote:
>
> > Thanks all for the feedback,
> >
> > We'll send an email next week with the list of missing features, content
> > and bugs that we plan to fix.
> > We took the option of releasing early, with some features missing, rather
> > than trying to be at feature parity with the old website before launching
> > the website.
> > The reason why we decided to do that is two-fold:
> > - playing catch-up with docs in master introduce daily conflicts that
> need
> > to be resolved and introduce opportunity for errors
> > - by releasing early, we can take advantage of the community
> contributions
> > in modifying whatever the community feels like a better way of doing
> > things.
> >
> > One of the goals of the new website was to disentangle the main website,
> > now called "static_site" to the auto-generated docs. Now the overall site
> > is made of a main static site, with easy to modify content and easy to
> > understand architecture for anybody familiar with basic html, and a
> > collection of mini-websites for each language bindings that can be built
> in
> > isolation and that are self-contained. Actually the new CI jobs builds
> all
> > of them in parallel independently.
> >
> > There is PLENTY of room for improvement, it would be great if the
> community
> > can help contribute to bring the new website at the same level of content
> > richness as the old one, and then even further.
> >
> > Missing features:
> > - As pointed by Haibin, the API docs do not have the full list of
> operators
> > and classes. There is a mix of auto-generated docs based on packages, and
> > some docs that are spelled out manually to improve the logical
> organization
> > of the package where there is a need. The drawback with manually listed
> > classes in a package is that it's very easy to miss some. If someone
> wanted
> > to build a sanity check that would automatically detect which classes are
> > not in the documentation, or if someone knew how to enable that with
> > sphinx, that would be a great addition to the python docs
> > - There is missing content in the python tutorials, and the
> discoverability
> > could be improved. Some old tutorials have not been migrated just yet.
> > - The nightly tests on tutorials have been disabled for now
> > - There is no "Download jupyter notebook" for tutorials just yet.
> > - Non-python tutorials might benefit from a blurb description and a
> better
> > content organization.
> > - Python tutorials could be better organized, have a picture accompanying
> > their description
> > - There is no site-wide search, this is not an easy problem to solve to
> be
> > fair given the static nature of the website, but maybe an external plugin
> > might be able to give a half-way solution
> > - There is no version selector for the docs
> > - There is bug in search box of the python docs, but this is just a small
> > JS bug that can be fixed easily (on my list for next week)
> > - Most old links have not had a redirect put in place.
> >
> >
> I noticed on the Ubuntu home page in the Developer dropdown that the link
> MXNet on Ubuntu <https://mxnet.incubator.apache.org/install/index.html
> >with
> Nvidia
> <
> https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/mxnet/
> >
> doesn't work anymore, it points to:
> https://mxnet.incubator.apache.org/install/index.html
>
> Also, on the MXNet 'getting started' page
> https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
> Installation Guide" at the bottom doesn't work either, it points to:
> https://mxnet.incubator.apache.org/ubuntu_setup.html
>
>
> I suggest you do a scan of the new website to find these dangling links.
>
> regards,
>
> Lieven
>
>
>
> > We'll formalize this in github issues next week, but they are all fairly
> > small and helping out on these would be a great way of familiarizing
> > yourself with the new website build system and website architecture.
> >
> >  Thanks all for the feedback, please keep it coming!
> >
> > Thomas Delteil
> >
> > Le sam. 21 sept. 2019 à 09:53, Haibin Lin <ha...@gmail.com> a
> > écrit :
> >
> > > It looks like my previous email did not go through. Re-sending:
> > >
> > > Hi Aaron,
> > >
> > > The website looks cool. Thanks for pushing this to production. A few
> > > questions:
> > >
> > > - I was looking for the API doc for mx.sym.dot, but I find that most
> > > operators under mx.sym.* are missing. Is this expected?
> > > - I was also checking the search functionality, searching the keyword
> > > "ndarray" only returns one result "mxnet.ndarray.NDArray", which
> doesn't
> > > seem right. There animation keeps going (Searching. -> Searching.. ->
> > > Searching ...) and gives me an impression that the search is never
> > > completely done(?).
> > >
> > > Best,
> > > Haibin
> > >
> > >
> > > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <ch...@gmail.com>
> > > wrote:
> > >
> > > > Thanks Aaron and the team for launching new website!
> > > >
> > > > 1. There's no search button anywhere on the landing page.
> > > > 2. I wasn't able to find FAQ (and without search button I dont have
> > > option
> > > > but to go manually on each menu). Only when I go to Docs&Tutorials ->
> > FAQ
> > > > -> Extend and Cotribute (that I got what I wanted).
> > > >
> > > > Suggestions
> > > > Might want to make this searchable and pop FAQ on the main page (or
> > > > somewhere prominent)
> > > >
> > > > Thanks,
> > > > Chai
> > > >
> > > >
> > > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <pt...@apache.org>
> > > > wrote:
> > > >
> > > > > There seems to be a problem with (at least Python, did not check
> > > others)
> > > > > APIs. For example this page:
> > > > >
> > > > >
> > > >
> > >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html
> > > > >
> > > > > says that it is a convenience method for argmax (with a link), but
> > > > > clicking that link just points to the same website (and so user has
> > no
> > > > way
> > > > > of getting to the docs of the actual operator).
> > > > >
> > > > > When I tried to manually remove Symbol from the URL to get to
> > > > > mxnet.symbol.argmax.html, I got a "Not found" webpage which I guess
> > > also
> > > > > should not happen (ignoring the fact that this should exist, going
> to
> > > > > random URL under the website should redirect to the main page I
> > think).
> > > > >
> > > > > Przemek
> > > > >
> > > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > > > > Looks very neat. Thank you Aaron and many others for launching
> > this!
> > > > > >
> > > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <
> carinmeier@gmail.com>
> > > > > wrote:
> > > > > >
> > > > > > > Nice!!! Congrats everyone!
> > > > > > >
> > > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > > > aaron.s.markham@gmail.com>
> > > > > > > wrote:
> > > > > > >
> > > > > > > > Alrighty! The new site is launched. You might need to clear
> > your
> > > > > cache.
> > > > > > > >
> > > > > > > > Cheers,
> > > > > > > > Aaron
> > > > > > > >
> > > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > > > aaron.s.markham@gmail.com
> > > > > > > >
> > > > > > > > wrote:
> > > > > > > > >
> > > > > > > > > Thanks everyone. The PRs passed CI, but please continue
> > holding
> > > > > off on
> > > > > > > > > docs and CI edits. Unless there are any objections, I'd
> like
> > to
> > > > > launch
> > > > > > > > > the new website today.
> > > > > > > > >
> > > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > > > aaron.s.markham@gmail.com>
> > > > > > > > wrote:
> > > > > > > > > >
> > > > > > > > > > Hi everyone,
> > > > > > > > > > The last two PRs [1][2] for the new website and docs have
> > > > passed
> > > > > CI
> > > > > > > > > > (finally). Please do not make changes to /docs or /ci
> until
> > > we
> > > > > get
> > > > > > > > > > these approved and merged. Every time there's a merge
> > > conflict
> > > > > it has
> > > > > > > > > > set us back a day or two while shepherding the PRs
> through
> > CI
> > > > > again.
> > > > > > > > > > Unless there are catastrophic issues discovered in a
> > review,
> > > I
> > > > > > > > > > recommend that we hold any patches or updates to the PRs
> to
> > > > > follow-up
> > > > > > > > > > PRs.
> > > > > > > > > >
> > > > > > > > > > There are four steps to launch:
> > > > > > > > > > 1. Once the PRs are approved, the plan is to merge 15885
> to
> > > > > delete
> > > > > > > the
> > > > > > > > > > old content first.
> > > > > > > > > > 2. Then immediately merge 15883 to add in the new CI
> flows
> > > and
> > > > > > > updates
> > > > > > > > > > to the content Thomas and I have already had merged in
> > 15884
> > > > [3].
> > > > > > > > > > 3. I will change the website validation Jenkins pipeline
> to
> > > > > point to
> > > > > > > > > > the new pipeline.
> > > > > > > > > > 4. I will change the website publishing Jenkins pipeline
> to
> > > > > point to
> > > > > > > > > > its new pipeline as well. Once triggered, the old site
> will
> > > be
> > > > > > > > > > replaced with the new one.
> > > > > > > > > >
> > > > > > > > > > Post launch we'll need to update the DNS for
> beta.mxnet.io
> > > to
> > > > > point
> > > > > > > to
> > > > > > > > > > production, and there will likely be some
> > redirect/.htaccess
> > > > > updates
> > > > > > > > > > needed next week to assist with any deep linking and 404
> > > issues
> > > > > that
> > > > > > > > > > pop up.
> > > > > > > > > >
> > > > > > > > > > Cheers,
> > > > > > > > > > Aaron
> > > > > > > > > >
> > > > > > > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > > >
> > > > --
> > > > *Chaitanya Prakash Bapat*
> > > > *+1 (973) 953-6299*
> > > >
> > > > [image: https://www.linkedin.com//in/chaibapat25]
> > > > <https://github.com/ChaiBapchya>[image:
> > > https://www.facebook.com/chaibapat
> > > > ]
> > > > <https://www.facebook.com/chaibapchya>[image:
> > > > https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya
> > > >[image:
> > > > https://www.linkedin.com//in/chaibapat25]
> > > > <https://www.linkedin.com//in/chaibapchya/>
> > > >
> > >
> >
>

Re: new website, docs code freeze

[Lieven Govaerts <lg...@mobsol.be>]

Hi,


On Sat, 21 Sep 2019 at 06:28, Thomas DELTEIL <th...@gmail.com>
wrote:

> Thanks all for the feedback,
>
> We'll send an email next week with the list of missing features, content
> and bugs that we plan to fix.
> We took the option of releasing early, with some features missing, rather
> than trying to be at feature parity with the old website before launching
> the website.
> The reason why we decided to do that is two-fold:
> - playing catch-up with docs in master introduce daily conflicts that need
> to be resolved and introduce opportunity for errors
> - by releasing early, we can take advantage of the community contributions
> in modifying whatever the community feels like a better way of doing
> things.
>
> One of the goals of the new website was to disentangle the main website,
> now called "static_site" to the auto-generated docs. Now the overall site
> is made of a main static site, with easy to modify content and easy to
> understand architecture for anybody familiar with basic html, and a
> collection of mini-websites for each language bindings that can be built in
> isolation and that are self-contained. Actually the new CI jobs builds all
> of them in parallel independently.
>
> There is PLENTY of room for improvement, it would be great if the community
> can help contribute to bring the new website at the same level of content
> richness as the old one, and then even further.
>
> Missing features:
> - As pointed by Haibin, the API docs do not have the full list of operators
> and classes. There is a mix of auto-generated docs based on packages, and
> some docs that are spelled out manually to improve the logical organization
> of the package where there is a need. The drawback with manually listed
> classes in a package is that it's very easy to miss some. If someone wanted
> to build a sanity check that would automatically detect which classes are
> not in the documentation, or if someone knew how to enable that with
> sphinx, that would be a great addition to the python docs
> - There is missing content in the python tutorials, and the discoverability
> could be improved. Some old tutorials have not been migrated just yet.
> - The nightly tests on tutorials have been disabled for now
> - There is no "Download jupyter notebook" for tutorials just yet.
> - Non-python tutorials might benefit from a blurb description and a better
> content organization.
> - Python tutorials could be better organized, have a picture accompanying
> their description
> - There is no site-wide search, this is not an easy problem to solve to be
> fair given the static nature of the website, but maybe an external plugin
> might be able to give a half-way solution
> - There is no version selector for the docs
> - There is bug in search box of the python docs, but this is just a small
> JS bug that can be fixed easily (on my list for next week)
> - Most old links have not had a redirect put in place.
>
>
I noticed on the Ubuntu home page in the Developer dropdown that the link
MXNet on Ubuntu <https://mxnet.incubator.apache.org/install/index.html>with
Nvidia
<https://www.nvidia.com/en-us/data-center/gpu-accelerated-applications/mxnet/>
doesn't work anymore, it points to:
https://mxnet.incubator.apache.org/install/index.html

Also, on the MXNet 'getting started' page
https://mxnet.incubator.apache.org/get_started , the link "Ubuntu
Installation Guide" at the bottom doesn't work either, it points to:
https://mxnet.incubator.apache.org/ubuntu_setup.html


I suggest you do a scan of the new website to find these dangling links.

regards,

Lieven



> We'll formalize this in github issues next week, but they are all fairly
> small and helping out on these would be a great way of familiarizing
> yourself with the new website build system and website architecture.
>
>  Thanks all for the feedback, please keep it coming!
>
> Thomas Delteil
>
> Le sam. 21 sept. 2019 à 09:53, Haibin Lin <ha...@gmail.com> a
> écrit :
>
> > It looks like my previous email did not go through. Re-sending:
> >
> > Hi Aaron,
> >
> > The website looks cool. Thanks for pushing this to production. A few
> > questions:
> >
> > - I was looking for the API doc for mx.sym.dot, but I find that most
> > operators under mx.sym.* are missing. Is this expected?
> > - I was also checking the search functionality, searching the keyword
> > "ndarray" only returns one result "mxnet.ndarray.NDArray", which doesn't
> > seem right. There animation keeps going (Searching. -> Searching.. ->
> > Searching ...) and gives me an impression that the search is never
> > completely done(?).
> >
> > Best,
> > Haibin
> >
> >
> > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <ch...@gmail.com>
> > wrote:
> >
> > > Thanks Aaron and the team for launching new website!
> > >
> > > 1. There's no search button anywhere on the landing page.
> > > 2. I wasn't able to find FAQ (and without search button I dont have
> > option
> > > but to go manually on each menu). Only when I go to Docs&Tutorials ->
> FAQ
> > > -> Extend and Cotribute (that I got what I wanted).
> > >
> > > Suggestions
> > > Might want to make this searchable and pop FAQ on the main page (or
> > > somewhere prominent)
> > >
> > > Thanks,
> > > Chai
> > >
> > >
> > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <pt...@apache.org>
> > > wrote:
> > >
> > > > There seems to be a problem with (at least Python, did not check
> > others)
> > > > APIs. For example this page:
> > > >
> > > >
> > >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html
> > > >
> > > > says that it is a convenience method for argmax (with a link), but
> > > > clicking that link just points to the same website (and so user has
> no
> > > way
> > > > of getting to the docs of the actual operator).
> > > >
> > > > When I tried to manually remove Symbol from the URL to get to
> > > > mxnet.symbol.argmax.html, I got a "Not found" webpage which I guess
> > also
> > > > should not happen (ignoring the fact that this should exist, going to
> > > > random URL under the website should redirect to the main page I
> think).
> > > >
> > > > Przemek
> > > >
> > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > > > Looks very neat. Thank you Aaron and many others for launching
> this!
> > > > >
> > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <ca...@gmail.com>
> > > > wrote:
> > > > >
> > > > > > Nice!!! Congrats everyone!
> > > > > >
> > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > > aaron.s.markham@gmail.com>
> > > > > > wrote:
> > > > > >
> > > > > > > Alrighty! The new site is launched. You might need to clear
> your
> > > > cache.
> > > > > > >
> > > > > > > Cheers,
> > > > > > > Aaron
> > > > > > >
> > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > > aaron.s.markham@gmail.com
> > > > > > >
> > > > > > > wrote:
> > > > > > > >
> > > > > > > > Thanks everyone. The PRs passed CI, but please continue
> holding
> > > > off on
> > > > > > > > docs and CI edits. Unless there are any objections, I'd like
> to
> > > > launch
> > > > > > > > the new website today.
> > > > > > > >
> > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > > aaron.s.markham@gmail.com>
> > > > > > > wrote:
> > > > > > > > >
> > > > > > > > > Hi everyone,
> > > > > > > > > The last two PRs [1][2] for the new website and docs have
> > > passed
> > > > CI
> > > > > > > > > (finally). Please do not make changes to /docs or /ci until
> > we
> > > > get
> > > > > > > > > these approved and merged. Every time there's a merge
> > conflict
> > > > it has
> > > > > > > > > set us back a day or two while shepherding the PRs through
> CI
> > > > again.
> > > > > > > > > Unless there are catastrophic issues discovered in a
> review,
> > I
> > > > > > > > > recommend that we hold any patches or updates to the PRs to
> > > > follow-up
> > > > > > > > > PRs.
> > > > > > > > >
> > > > > > > > > There are four steps to launch:
> > > > > > > > > 1. Once the PRs are approved, the plan is to merge 15885 to
> > > > delete
> > > > > > the
> > > > > > > > > old content first.
> > > > > > > > > 2. Then immediately merge 15883 to add in the new CI flows
> > and
> > > > > > updates
> > > > > > > > > to the content Thomas and I have already had merged in
> 15884
> > > [3].
> > > > > > > > > 3. I will change the website validation Jenkins pipeline to
> > > > point to
> > > > > > > > > the new pipeline.
> > > > > > > > > 4. I will change the website publishing Jenkins pipeline to
> > > > point to
> > > > > > > > > its new pipeline as well. Once triggered, the old site will
> > be
> > > > > > > > > replaced with the new one.
> > > > > > > > >
> > > > > > > > > Post launch we'll need to update the DNS for beta.mxnet.io
> > to
> > > > point
> > > > > > to
> > > > > > > > > production, and there will likely be some
> redirect/.htaccess
> > > > updates
> > > > > > > > > needed next week to assist with any deep linking and 404
> > issues
> > > > that
> > > > > > > > > pop up.
> > > > > > > > >
> > > > > > > > > Cheers,
> > > > > > > > > Aaron
> > > > > > > > >
> > > > > > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> > >
> > > --
> > > *Chaitanya Prakash Bapat*
> > > *+1 (973) 953-6299*
> > >
> > > [image: https://www.linkedin.com//in/chaibapat25]
> > > <https://github.com/ChaiBapchya>[image:
> > https://www.facebook.com/chaibapat
> > > ]
> > > <https://www.facebook.com/chaibapchya>[image:
> > > https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya
> > >[image:
> > > https://www.linkedin.com//in/chaibapat25]
> > > <https://www.linkedin.com//in/chaibapchya/>
> > >
> >
>

RE: new website, docs code freeze

["Zhao, Patric" <pa...@intel.com>]

Minor suggestion:

I think we can add more in features page to attract the user and also highlight the differentiation of MXNet.
Something like quantization, faster inference and training, horovod supporting, AMP, automatic fusion in the fly... 
http://mxnet.incubator.apache.org/features

Thanks,

--Patric


> -----Original Message-----
> From: Thomas DELTEIL <th...@gmail.com>
> Sent: Saturday, September 21, 2019 12:29 PM
> To: dev@mxnet.incubator.apache.org
> Subject: Re: new website, docs code freeze
> 
> Thanks all for the feedback,
> 
> We'll send an email next week with the list of missing features, content and
> bugs that we plan to fix.
> We took the option of releasing early, with some features missing, rather
> than trying to be at feature parity with the old website before launching the
> website.
> The reason why we decided to do that is two-fold:
> - playing catch-up with docs in master introduce daily conflicts that need to
> be resolved and introduce opportunity for errors
> - by releasing early, we can take advantage of the community contributions
> in modifying whatever the community feels like a better way of doing things.
> 
> One of the goals of the new website was to disentangle the main website,
> now called "static_site" to the auto-generated docs. Now the overall site is
> made of a main static site, with easy to modify content and easy to
> understand architecture for anybody familiar with basic html, and a collection
> of mini-websites for each language bindings that can be built in isolation and
> that are self-contained. Actually the new CI jobs builds all of them in parallel
> independently.
> 
> There is PLENTY of room for improvement, it would be great if the
> community can help contribute to bring the new website at the same level of
> content richness as the old one, and then even further.
> 
> Missing features:
> - As pointed by Haibin, the API docs do not have the full list of operators and
> classes. There is a mix of auto-generated docs based on packages, and some
> docs that are spelled out manually to improve the logical organization of the
> package where there is a need. The drawback with manually listed classes in
> a package is that it's very easy to miss some. If someone wanted to build a
> sanity check that would automatically detect which classes are not in the
> documentation, or if someone knew how to enable that with sphinx, that
> would be a great addition to the python docs
> - There is missing content in the python tutorials, and the discoverability
> could be improved. Some old tutorials have not been migrated just yet.
> - The nightly tests on tutorials have been disabled for now
> - There is no "Download jupyter notebook" for tutorials just yet.
> - Non-python tutorials might benefit from a blurb description and a better
> content organization.
> - Python tutorials could be better organized, have a picture accompanying
> their description
> - There is no site-wide search, this is not an easy problem to solve to be fair
> given the static nature of the website, but maybe an external plugin might be
> able to give a half-way solution
> - There is no version selector for the docs
> - There is bug in search box of the python docs, but this is just a small JS bug
> that can be fixed easily (on my list for next week)
> - Most old links have not had a redirect put in place.
> 
> We'll formalize this in github issues next week, but they are all fairly small and
> helping out on these would be a great way of familiarizing yourself with the
> new website build system and website architecture.
> 
>  Thanks all for the feedback, please keep it coming!
> 
> Thomas Delteil
> 
> Le sam. 21 sept. 2019 à 09:53, Haibin Lin <ha...@gmail.com> a écrit :
> 
> > It looks like my previous email did not go through. Re-sending:
> >
> > Hi Aaron,
> >
> > The website looks cool. Thanks for pushing this to production. A few
> > questions:
> >
> > - I was looking for the API doc for mx.sym.dot, but I find that most
> > operators under mx.sym.* are missing. Is this expected?
> > - I was also checking the search functionality, searching the keyword
> > "ndarray" only returns one result "mxnet.ndarray.NDArray", which
> > doesn't seem right. There animation keeps going (Searching. ->
> > Searching.. -> Searching ...) and gives me an impression that the
> > search is never completely done(?).
> >
> > Best,
> > Haibin
> >
> >
> > On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <ch...@gmail.com>
> > wrote:
> >
> > > Thanks Aaron and the team for launching new website!
> > >
> > > 1. There's no search button anywhere on the landing page.
> > > 2. I wasn't able to find FAQ (and without search button I dont have
> > option
> > > but to go manually on each menu). Only when I go to Docs&Tutorials
> > > -> FAQ
> > > -> Extend and Cotribute (that I got what I wanted).
> > >
> > > Suggestions
> > > Might want to make this searchable and pop FAQ on the main page (or
> > > somewhere prominent)
> > >
> > > Thanks,
> > > Chai
> > >
> > >
> > > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <pt...@apache.org>
> > > wrote:
> > >
> > > > There seems to be a problem with (at least Python, did not check
> > others)
> > > > APIs. For example this page:
> > > >
> > > >
> > >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen
> > /mxnet.symbol.Symbol.argmax.html
> > > >
> > > > says that it is a convenience method for argmax (with a link), but
> > > > clicking that link just points to the same website (and so user
> > > > has no
> > > way
> > > > of getting to the docs of the actual operator).
> > > >
> > > > When I tried to manually remove Symbol from the URL to get to
> > > > mxnet.symbol.argmax.html, I got a "Not found" webpage which I
> > > > guess
> > also
> > > > should not happen (ignoring the fact that this should exist, going
> > > > to random URL under the website should redirect to the main page I
> think).
> > > >
> > > > Przemek
> > > >
> > > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > > > Looks very neat. Thank you Aaron and many others for launching this!
> > > > >
> > > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier
> > > > > <ca...@gmail.com>
> > > > wrote:
> > > > >
> > > > > > Nice!!! Congrats everyone!
> > > > > >
> > > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > > aaron.s.markham@gmail.com>
> > > > > > wrote:
> > > > > >
> > > > > > > Alrighty! The new site is launched. You might need to clear
> > > > > > > your
> > > > cache.
> > > > > > >
> > > > > > > Cheers,
> > > > > > > Aaron
> > > > > > >
> > > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > > aaron.s.markham@gmail.com
> > > > > > >
> > > > > > > wrote:
> > > > > > > >
> > > > > > > > Thanks everyone. The PRs passed CI, but please continue
> > > > > > > > holding
> > > > off on
> > > > > > > > docs and CI edits. Unless there are any objections, I'd
> > > > > > > > like to
> > > > launch
> > > > > > > > the new website today.
> > > > > > > >
> > > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > > aaron.s.markham@gmail.com>
> > > > > > > wrote:
> > > > > > > > >
> > > > > > > > > Hi everyone,
> > > > > > > > > The last two PRs [1][2] for the new website and docs
> > > > > > > > > have
> > > passed
> > > > CI
> > > > > > > > > (finally). Please do not make changes to /docs or /ci
> > > > > > > > > until
> > we
> > > > get
> > > > > > > > > these approved and merged. Every time there's a merge
> > conflict
> > > > it has
> > > > > > > > > set us back a day or two while shepherding the PRs
> > > > > > > > > through CI
> > > > again.
> > > > > > > > > Unless there are catastrophic issues discovered in a
> > > > > > > > > review,
> > I
> > > > > > > > > recommend that we hold any patches or updates to the PRs
> > > > > > > > > to
> > > > follow-up
> > > > > > > > > PRs.
> > > > > > > > >
> > > > > > > > > There are four steps to launch:
> > > > > > > > > 1. Once the PRs are approved, the plan is to merge 15885
> > > > > > > > > to
> > > > delete
> > > > > > the
> > > > > > > > > old content first.
> > > > > > > > > 2. Then immediately merge 15883 to add in the new CI
> > > > > > > > > flows
> > and
> > > > > > updates
> > > > > > > > > to the content Thomas and I have already had merged in
> > > > > > > > > 15884
> > > [3].
> > > > > > > > > 3. I will change the website validation Jenkins pipeline
> > > > > > > > > to
> > > > point to
> > > > > > > > > the new pipeline.
> > > > > > > > > 4. I will change the website publishing Jenkins pipeline
> > > > > > > > > to
> > > > point to
> > > > > > > > > its new pipeline as well. Once triggered, the old site
> > > > > > > > > will
> > be
> > > > > > > > > replaced with the new one.
> > > > > > > > >
> > > > > > > > > Post launch we'll need to update the DNS for
> > > > > > > > > beta.mxnet.io
> > to
> > > > point
> > > > > > to
> > > > > > > > > production, and there will likely be some
> > > > > > > > > redirect/.htaccess
> > > > updates
> > > > > > > > > needed next week to assist with any deep linking and 404
> > issues
> > > > that
> > > > > > > > > pop up.
> > > > > > > > >
> > > > > > > > > Cheers,
> > > > > > > > > Aaron
> > > > > > > > >
> > > > > > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > > > > > >
> > > > > >
> > > > >
> > > >
> > >
> > >
> > > --
> > > *Chaitanya Prakash Bapat*
> > > *+1 (973) 953-6299*
> > >
> > > [image: https://www.linkedin.com//in/chaibapat25]
> > > <https://github.com/ChaiBapchya>[image:
> > https://www.facebook.com/chaibapat
> > > ]
> > > <https://www.facebook.com/chaibapchya>[image:
> > > https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya
> > >[image:
> > > https://www.linkedin.com//in/chaibapat25]
> > > <https://www.linkedin.com//in/chaibapchya/>
> > >
> >

Re: new website, docs code freeze

[Thomas DELTEIL <th...@gmail.com>]

Thanks all for the feedback,

We'll send an email next week with the list of missing features, content
and bugs that we plan to fix.
We took the option of releasing early, with some features missing, rather
than trying to be at feature parity with the old website before launching
the website.
The reason why we decided to do that is two-fold:
- playing catch-up with docs in master introduce daily conflicts that need
to be resolved and introduce opportunity for errors
- by releasing early, we can take advantage of the community contributions
in modifying whatever the community feels like a better way of doing things.

One of the goals of the new website was to disentangle the main website,
now called "static_site" to the auto-generated docs. Now the overall site
is made of a main static site, with easy to modify content and easy to
understand architecture for anybody familiar with basic html, and a
collection of mini-websites for each language bindings that can be built in
isolation and that are self-contained. Actually the new CI jobs builds all
of them in parallel independently.

There is PLENTY of room for improvement, it would be great if the community
can help contribute to bring the new website at the same level of content
richness as the old one, and then even further.

Missing features:
- As pointed by Haibin, the API docs do not have the full list of operators
and classes. There is a mix of auto-generated docs based on packages, and
some docs that are spelled out manually to improve the logical organization
of the package where there is a need. The drawback with manually listed
classes in a package is that it's very easy to miss some. If someone wanted
to build a sanity check that would automatically detect which classes are
not in the documentation, or if someone knew how to enable that with
sphinx, that would be a great addition to the python docs
- There is missing content in the python tutorials, and the discoverability
could be improved. Some old tutorials have not been migrated just yet.
- The nightly tests on tutorials have been disabled for now
- There is no "Download jupyter notebook" for tutorials just yet.
- Non-python tutorials might benefit from a blurb description and a better
content organization.
- Python tutorials could be better organized, have a picture accompanying
their description
- There is no site-wide search, this is not an easy problem to solve to be
fair given the static nature of the website, but maybe an external plugin
might be able to give a half-way solution
- There is no version selector for the docs
- There is bug in search box of the python docs, but this is just a small
JS bug that can be fixed easily (on my list for next week)
- Most old links have not had a redirect put in place.

We'll formalize this in github issues next week, but they are all fairly
small and helping out on these would be a great way of familiarizing
yourself with the new website build system and website architecture.

 Thanks all for the feedback, please keep it coming!

Thomas Delteil

Le sam. 21 sept. 2019 à 09:53, Haibin Lin <ha...@gmail.com> a
écrit :

> It looks like my previous email did not go through. Re-sending:
>
> Hi Aaron,
>
> The website looks cool. Thanks for pushing this to production. A few
> questions:
>
> - I was looking for the API doc for mx.sym.dot, but I find that most
> operators under mx.sym.* are missing. Is this expected?
> - I was also checking the search functionality, searching the keyword
> "ndarray" only returns one result "mxnet.ndarray.NDArray", which doesn't
> seem right. There animation keeps going (Searching. -> Searching.. ->
> Searching ...) and gives me an impression that the search is never
> completely done(?).
>
> Best,
> Haibin
>
>
> On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <ch...@gmail.com>
> wrote:
>
> > Thanks Aaron and the team for launching new website!
> >
> > 1. There's no search button anywhere on the landing page.
> > 2. I wasn't able to find FAQ (and without search button I dont have
> option
> > but to go manually on each menu). Only when I go to Docs&Tutorials -> FAQ
> > -> Extend and Cotribute (that I got what I wanted).
> >
> > Suggestions
> > Might want to make this searchable and pop FAQ on the main page (or
> > somewhere prominent)
> >
> > Thanks,
> > Chai
> >
> >
> > On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <pt...@apache.org>
> > wrote:
> >
> > > There seems to be a problem with (at least Python, did not check
> others)
> > > APIs. For example this page:
> > >
> > >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html
> > >
> > > says that it is a convenience method for argmax (with a link), but
> > > clicking that link just points to the same website (and so user has no
> > way
> > > of getting to the docs of the actual operator).
> > >
> > > When I tried to manually remove Symbol from the URL to get to
> > > mxnet.symbol.argmax.html, I got a "Not found" webpage which I guess
> also
> > > should not happen (ignoring the fact that this should exist, going to
> > > random URL under the website should redirect to the main page I think).
> > >
> > > Przemek
> > >
> > > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > > Looks very neat. Thank you Aaron and many others for launching this!
> > > >
> > > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <ca...@gmail.com>
> > > wrote:
> > > >
> > > > > Nice!!! Congrats everyone!
> > > > >
> > > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > > aaron.s.markham@gmail.com>
> > > > > wrote:
> > > > >
> > > > > > Alrighty! The new site is launched. You might need to clear your
> > > cache.
> > > > > >
> > > > > > Cheers,
> > > > > > Aaron
> > > > > >
> > > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > > aaron.s.markham@gmail.com
> > > > > >
> > > > > > wrote:
> > > > > > >
> > > > > > > Thanks everyone. The PRs passed CI, but please continue holding
> > > off on
> > > > > > > docs and CI edits. Unless there are any objections, I'd like to
> > > launch
> > > > > > > the new website today.
> > > > > > >
> > > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > > aaron.s.markham@gmail.com>
> > > > > > wrote:
> > > > > > > >
> > > > > > > > Hi everyone,
> > > > > > > > The last two PRs [1][2] for the new website and docs have
> > passed
> > > CI
> > > > > > > > (finally). Please do not make changes to /docs or /ci until
> we
> > > get
> > > > > > > > these approved and merged. Every time there's a merge
> conflict
> > > it has
> > > > > > > > set us back a day or two while shepherding the PRs through CI
> > > again.
> > > > > > > > Unless there are catastrophic issues discovered in a review,
> I
> > > > > > > > recommend that we hold any patches or updates to the PRs to
> > > follow-up
> > > > > > > > PRs.
> > > > > > > >
> > > > > > > > There are four steps to launch:
> > > > > > > > 1. Once the PRs are approved, the plan is to merge 15885 to
> > > delete
> > > > > the
> > > > > > > > old content first.
> > > > > > > > 2. Then immediately merge 15883 to add in the new CI flows
> and
> > > > > updates
> > > > > > > > to the content Thomas and I have already had merged in 15884
> > [3].
> > > > > > > > 3. I will change the website validation Jenkins pipeline to
> > > point to
> > > > > > > > the new pipeline.
> > > > > > > > 4. I will change the website publishing Jenkins pipeline to
> > > point to
> > > > > > > > its new pipeline as well. Once triggered, the old site will
> be
> > > > > > > > replaced with the new one.
> > > > > > > >
> > > > > > > > Post launch we'll need to update the DNS for beta.mxnet.io
> to
> > > point
> > > > > to
> > > > > > > > production, and there will likely be some redirect/.htaccess
> > > updates
> > > > > > > > needed next week to assist with any deep linking and 404
> issues
> > > that
> > > > > > > > pop up.
> > > > > > > >
> > > > > > > > Cheers,
> > > > > > > > Aaron
> > > > > > > >
> > > > > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > > > > >
> > > > >
> > > >
> > >
> >
> >
> > --
> > *Chaitanya Prakash Bapat*
> > *+1 (973) 953-6299*
> >
> > [image: https://www.linkedin.com//in/chaibapat25]
> > <https://github.com/ChaiBapchya>[image:
> https://www.facebook.com/chaibapat
> > ]
> > <https://www.facebook.com/chaibapchya>[image:
> > https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya
> >[image:
> > https://www.linkedin.com//in/chaibapat25]
> > <https://www.linkedin.com//in/chaibapchya/>
> >
>

Re: new website, docs code freeze

[Haibin Lin <ha...@gmail.com>]

It looks like my previous email did not go through. Re-sending:

Hi Aaron,

The website looks cool. Thanks for pushing this to production. A few
questions:

- I was looking for the API doc for mx.sym.dot, but I find that most
operators under mx.sym.* are missing. Is this expected?
- I was also checking the search functionality, searching the keyword
"ndarray" only returns one result "mxnet.ndarray.NDArray", which doesn't
seem right. There animation keeps going (Searching. -> Searching.. ->
Searching ...) and gives me an impression that the search is never
completely done(?).

Best,
Haibin


On Fri, Sep 20, 2019 at 4:50 PM Chaitanya Bapat <ch...@gmail.com>
wrote:

> Thanks Aaron and the team for launching new website!
>
> 1. There's no search button anywhere on the landing page.
> 2. I wasn't able to find FAQ (and without search button I dont have option
> but to go manually on each menu). Only when I go to Docs&Tutorials -> FAQ
> -> Extend and Cotribute (that I got what I wanted).
>
> Suggestions
> Might want to make this searchable and pop FAQ on the main page (or
> somewhere prominent)
>
> Thanks,
> Chai
>
>
> On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <pt...@apache.org>
> wrote:
>
> > There seems to be a problem with (at least Python, did not check others)
> > APIs. For example this page:
> >
> >
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html
> >
> > says that it is a convenience method for argmax (with a link), but
> > clicking that link just points to the same website (and so user has no
> way
> > of getting to the docs of the actual operator).
> >
> > When I tried to manually remove Symbol from the URL to get to
> > mxnet.symbol.argmax.html, I got a "Not found" webpage which I guess also
> > should not happen (ignoring the fact that this should exist, going to
> > random URL under the website should redirect to the main page I think).
> >
> > Przemek
> >
> > On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > > Looks very neat. Thank you Aaron and many others for launching this!
> > >
> > > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <ca...@gmail.com>
> > wrote:
> > >
> > > > Nice!!! Congrats everyone!
> > > >
> > > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> > aaron.s.markham@gmail.com>
> > > > wrote:
> > > >
> > > > > Alrighty! The new site is launched. You might need to clear your
> > cache.
> > > > >
> > > > > Cheers,
> > > > > Aaron
> > > > >
> > > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> > aaron.s.markham@gmail.com
> > > > >
> > > > > wrote:
> > > > > >
> > > > > > Thanks everyone. The PRs passed CI, but please continue holding
> > off on
> > > > > > docs and CI edits. Unless there are any objections, I'd like to
> > launch
> > > > > > the new website today.
> > > > > >
> > > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > > aaron.s.markham@gmail.com>
> > > > > wrote:
> > > > > > >
> > > > > > > Hi everyone,
> > > > > > > The last two PRs [1][2] for the new website and docs have
> passed
> > CI
> > > > > > > (finally). Please do not make changes to /docs or /ci until we
> > get
> > > > > > > these approved and merged. Every time there's a merge conflict
> > it has
> > > > > > > set us back a day or two while shepherding the PRs through CI
> > again.
> > > > > > > Unless there are catastrophic issues discovered in a review, I
> > > > > > > recommend that we hold any patches or updates to the PRs to
> > follow-up
> > > > > > > PRs.
> > > > > > >
> > > > > > > There are four steps to launch:
> > > > > > > 1. Once the PRs are approved, the plan is to merge 15885 to
> > delete
> > > > the
> > > > > > > old content first.
> > > > > > > 2. Then immediately merge 15883 to add in the new CI flows and
> > > > updates
> > > > > > > to the content Thomas and I have already had merged in 15884
> [3].
> > > > > > > 3. I will change the website validation Jenkins pipeline to
> > point to
> > > > > > > the new pipeline.
> > > > > > > 4. I will change the website publishing Jenkins pipeline to
> > point to
> > > > > > > its new pipeline as well. Once triggered, the old site will be
> > > > > > > replaced with the new one.
> > > > > > >
> > > > > > > Post launch we'll need to update the DNS for beta.mxnet.io to
> > point
> > > > to
> > > > > > > production, and there will likely be some redirect/.htaccess
> > updates
> > > > > > > needed next week to assist with any deep linking and 404 issues
> > that
> > > > > > > pop up.
> > > > > > >
> > > > > > > Cheers,
> > > > > > > Aaron
> > > > > > >
> > > > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > > > >
> > > >
> > >
> >
>
>
> --
> *Chaitanya Prakash Bapat*
> *+1 (973) 953-6299*
>
> [image: https://www.linkedin.com//in/chaibapat25]
> <https://github.com/ChaiBapchya>[image: https://www.facebook.com/chaibapat
> ]
> <https://www.facebook.com/chaibapchya>[image:
> https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya>[image:
> https://www.linkedin.com//in/chaibapat25]
> <https://www.linkedin.com//in/chaibapchya/>
>

Re: new website, docs code freeze

[Chaitanya Bapat <ch...@gmail.com>]

Thanks Aaron and the team for launching new website!

1. There's no search button anywhere on the landing page.
2. I wasn't able to find FAQ (and without search button I dont have option
but to go manually on each menu). Only when I go to Docs&Tutorials -> FAQ
-> Extend and Cotribute (that I got what I wanted).

Suggestions
Might want to make this searchable and pop FAQ on the main page (or
somewhere prominent)

Thanks,
Chai


On Fri, 20 Sep 2019 at 14:58, Przemysław Trędak <pt...@apache.org> wrote:

> There seems to be a problem with (at least Python, did not check others)
> APIs. For example this page:
>
> https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html
>
> says that it is a convenience method for argmax (with a link), but
> clicking that link just points to the same website (and so user has no way
> of getting to the docs of the actual operator).
>
> When I tried to manually remove Symbol from the URL to get to
> mxnet.symbol.argmax.html, I got a "Not found" webpage which I guess also
> should not happen (ignoring the fact that this should exist, going to
> random URL under the website should redirect to the main page I think).
>
> Przemek
>
> On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote:
> > Looks very neat. Thank you Aaron and many others for launching this!
> >
> > On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <ca...@gmail.com>
> wrote:
> >
> > > Nice!!! Congrats everyone!
> > >
> > > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <
> aaron.s.markham@gmail.com>
> > > wrote:
> > >
> > > > Alrighty! The new site is launched. You might need to clear your
> cache.
> > > >
> > > > Cheers,
> > > > Aaron
> > > >
> > > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <
> aaron.s.markham@gmail.com
> > > >
> > > > wrote:
> > > > >
> > > > > Thanks everyone. The PRs passed CI, but please continue holding
> off on
> > > > > docs and CI edits. Unless there are any objections, I'd like to
> launch
> > > > > the new website today.
> > > > >
> > > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > > aaron.s.markham@gmail.com>
> > > > wrote:
> > > > > >
> > > > > > Hi everyone,
> > > > > > The last two PRs [1][2] for the new website and docs have passed
> CI
> > > > > > (finally). Please do not make changes to /docs or /ci until we
> get
> > > > > > these approved and merged. Every time there's a merge conflict
> it has
> > > > > > set us back a day or two while shepherding the PRs through CI
> again.
> > > > > > Unless there are catastrophic issues discovered in a review, I
> > > > > > recommend that we hold any patches or updates to the PRs to
> follow-up
> > > > > > PRs.
> > > > > >
> > > > > > There are four steps to launch:
> > > > > > 1. Once the PRs are approved, the plan is to merge 15885 to
> delete
> > > the
> > > > > > old content first.
> > > > > > 2. Then immediately merge 15883 to add in the new CI flows and
> > > updates
> > > > > > to the content Thomas and I have already had merged in 15884 [3].
> > > > > > 3. I will change the website validation Jenkins pipeline to
> point to
> > > > > > the new pipeline.
> > > > > > 4. I will change the website publishing Jenkins pipeline to
> point to
> > > > > > its new pipeline as well. Once triggered, the old site will be
> > > > > > replaced with the new one.
> > > > > >
> > > > > > Post launch we'll need to update the DNS for beta.mxnet.io to
> point
> > > to
> > > > > > production, and there will likely be some redirect/.htaccess
> updates
> > > > > > needed next week to assist with any deep linking and 404 issues
> that
> > > > > > pop up.
> > > > > >
> > > > > > Cheers,
> > > > > > Aaron
> > > > > >
> > > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > > >
> > >
> >
>


-- 
*Chaitanya Prakash Bapat*
*+1 (973) 953-6299*

[image: https://www.linkedin.com//in/chaibapat25]
<https://github.com/ChaiBapchya>[image: https://www.facebook.com/chaibapat]
<https://www.facebook.com/chaibapchya>[image:
https://twitter.com/ChaiBapchya] <https://twitter.com/ChaiBapchya>[image:
https://www.linkedin.com//in/chaibapat25]
<https://www.linkedin.com//in/chaibapchya/>

Re: new website, docs code freeze

[Przemys��aw Tr��dak <pt...@apache.org>]

There seems to be a problem with (at least Python, did not check others) APIs. For example this page:
https://mxnet.incubator.apache.org/api/python/docs/api/symbol/_autogen/mxnet.symbol.Symbol.argmax.html

says that it is a convenience method for argmax (with a link), but clicking that link just points to the same website (and so user has no way of getting to the docs of the actual operator).

When I tried to manually remove Symbol from the URL to get to mxnet.symbol.argmax.html, I got a "Not found" webpage which I guess also should not happen (ignoring the fact that this should exist, going to random URL under the website should redirect to the main page I think).

Przemek

On 2019/09/20 16:41:28, Lin Yuan <ap...@gmail.com> wrote: 
> Looks very neat. Thank you Aaron and many others for launching this!
> 
> On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <ca...@gmail.com> wrote:
> 
> > Nice!!! Congrats everyone!
> >
> > On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <aa...@gmail.com>
> > wrote:
> >
> > > Alrighty! The new site is launched. You might need to clear your cache.
> > >
> > > Cheers,
> > > Aaron
> > >
> > > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <aaron.s.markham@gmail.com
> > >
> > > wrote:
> > > >
> > > > Thanks everyone. The PRs passed CI, but please continue holding off on
> > > > docs and CI edits. Unless there are any objections, I'd like to launch
> > > > the new website today.
> > > >
> > > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> > aaron.s.markham@gmail.com>
> > > wrote:
> > > > >
> > > > > Hi everyone,
> > > > > The last two PRs [1][2] for the new website and docs have passed CI
> > > > > (finally). Please do not make changes to /docs or /ci until we get
> > > > > these approved and merged. Every time there's a merge conflict it has
> > > > > set us back a day or two while shepherding the PRs through CI again.
> > > > > Unless there are catastrophic issues discovered in a review, I
> > > > > recommend that we hold any patches or updates to the PRs to follow-up
> > > > > PRs.
> > > > >
> > > > > There are four steps to launch:
> > > > > 1. Once the PRs are approved, the plan is to merge 15885 to delete
> > the
> > > > > old content first.
> > > > > 2. Then immediately merge 15883 to add in the new CI flows and
> > updates
> > > > > to the content Thomas and I have already had merged in 15884 [3].
> > > > > 3. I will change the website validation Jenkins pipeline to point to
> > > > > the new pipeline.
> > > > > 4. I will change the website publishing Jenkins pipeline to point to
> > > > > its new pipeline as well. Once triggered, the old site will be
> > > > > replaced with the new one.
> > > > >
> > > > > Post launch we'll need to update the DNS for beta.mxnet.io to point
> > to
> > > > > production, and there will likely be some redirect/.htaccess updates
> > > > > needed next week to assist with any deep linking and 404 issues that
> > > > > pop up.
> > > > >
> > > > > Cheers,
> > > > > Aaron
> > > > >
> > > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> > >
> >
> 

Re: new website, docs code freeze

[Lin Yuan <ap...@gmail.com>]

Looks very neat. Thank you Aaron and many others for launching this!

On Fri, Sep 20, 2019 at 7:31 AM Carin Meier <ca...@gmail.com> wrote:

> Nice!!! Congrats everyone!
>
> On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <aa...@gmail.com>
> wrote:
>
> > Alrighty! The new site is launched. You might need to clear your cache.
> >
> > Cheers,
> > Aaron
> >
> > On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <aaron.s.markham@gmail.com
> >
> > wrote:
> > >
> > > Thanks everyone. The PRs passed CI, but please continue holding off on
> > > docs and CI edits. Unless there are any objections, I'd like to launch
> > > the new website today.
> > >
> > > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <
> aaron.s.markham@gmail.com>
> > wrote:
> > > >
> > > > Hi everyone,
> > > > The last two PRs [1][2] for the new website and docs have passed CI
> > > > (finally). Please do not make changes to /docs or /ci until we get
> > > > these approved and merged. Every time there's a merge conflict it has
> > > > set us back a day or two while shepherding the PRs through CI again.
> > > > Unless there are catastrophic issues discovered in a review, I
> > > > recommend that we hold any patches or updates to the PRs to follow-up
> > > > PRs.
> > > >
> > > > There are four steps to launch:
> > > > 1. Once the PRs are approved, the plan is to merge 15885 to delete
> the
> > > > old content first.
> > > > 2. Then immediately merge 15883 to add in the new CI flows and
> updates
> > > > to the content Thomas and I have already had merged in 15884 [3].
> > > > 3. I will change the website validation Jenkins pipeline to point to
> > > > the new pipeline.
> > > > 4. I will change the website publishing Jenkins pipeline to point to
> > > > its new pipeline as well. Once triggered, the old site will be
> > > > replaced with the new one.
> > > >
> > > > Post launch we'll need to update the DNS for beta.mxnet.io to point
> to
> > > > production, and there will likely be some redirect/.htaccess updates
> > > > needed next week to assist with any deep linking and 404 issues that
> > > > pop up.
> > > >
> > > > Cheers,
> > > > Aaron
> > > >
> > > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > > [3] https://github.com/apache/incubator-mxnet/pull/15884
> >
>

Re: new website, docs code freeze

[Carin Meier <ca...@gmail.com>]

Nice!!! Congrats everyone!

On Fri, Sep 20, 2019 at 10:28 AM Aaron Markham <aa...@gmail.com>
wrote:

> Alrighty! The new site is launched. You might need to clear your cache.
>
> Cheers,
> Aaron
>
> On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <aa...@gmail.com>
> wrote:
> >
> > Thanks everyone. The PRs passed CI, but please continue holding off on
> > docs and CI edits. Unless there are any objections, I'd like to launch
> > the new website today.
> >
> > On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <aa...@gmail.com>
> wrote:
> > >
> > > Hi everyone,
> > > The last two PRs [1][2] for the new website and docs have passed CI
> > > (finally). Please do not make changes to /docs or /ci until we get
> > > these approved and merged. Every time there's a merge conflict it has
> > > set us back a day or two while shepherding the PRs through CI again.
> > > Unless there are catastrophic issues discovered in a review, I
> > > recommend that we hold any patches or updates to the PRs to follow-up
> > > PRs.
> > >
> > > There are four steps to launch:
> > > 1. Once the PRs are approved, the plan is to merge 15885 to delete the
> > > old content first.
> > > 2. Then immediately merge 15883 to add in the new CI flows and updates
> > > to the content Thomas and I have already had merged in 15884 [3].
> > > 3. I will change the website validation Jenkins pipeline to point to
> > > the new pipeline.
> > > 4. I will change the website publishing Jenkins pipeline to point to
> > > its new pipeline as well. Once triggered, the old site will be
> > > replaced with the new one.
> > >
> > > Post launch we'll need to update the DNS for beta.mxnet.io to point to
> > > production, and there will likely be some redirect/.htaccess updates
> > > needed next week to assist with any deep linking and 404 issues that
> > > pop up.
> > >
> > > Cheers,
> > > Aaron
> > >
> > > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > > [3] https://github.com/apache/incubator-mxnet/pull/15884
>

Re: new website, docs code freeze

[Aaron Markham <aa...@gmail.com>]

Alrighty! The new site is launched. You might need to clear your cache.

Cheers,
Aaron

On Thu, Sep 19, 2019 at 3:33 PM Aaron Markham <aa...@gmail.com> wrote:
>
> Thanks everyone. The PRs passed CI, but please continue holding off on
> docs and CI edits. Unless there are any objections, I'd like to launch
> the new website today.
>
> On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <aa...@gmail.com> wrote:
> >
> > Hi everyone,
> > The last two PRs [1][2] for the new website and docs have passed CI
> > (finally). Please do not make changes to /docs or /ci until we get
> > these approved and merged. Every time there's a merge conflict it has
> > set us back a day or two while shepherding the PRs through CI again.
> > Unless there are catastrophic issues discovered in a review, I
> > recommend that we hold any patches or updates to the PRs to follow-up
> > PRs.
> >
> > There are four steps to launch:
> > 1. Once the PRs are approved, the plan is to merge 15885 to delete the
> > old content first.
> > 2. Then immediately merge 15883 to add in the new CI flows and updates
> > to the content Thomas and I have already had merged in 15884 [3].
> > 3. I will change the website validation Jenkins pipeline to point to
> > the new pipeline.
> > 4. I will change the website publishing Jenkins pipeline to point to
> > its new pipeline as well. Once triggered, the old site will be
> > replaced with the new one.
> >
> > Post launch we'll need to update the DNS for beta.mxnet.io to point to
> > production, and there will likely be some redirect/.htaccess updates
> > needed next week to assist with any deep linking and 404 issues that
> > pop up.
> >
> > Cheers,
> > Aaron
> >
> > [1] https://github.com/apache/incubator-mxnet/pull/15885
> > [2] https://github.com/apache/incubator-mxnet/pull/15883
> > [3] https://github.com/apache/incubator-mxnet/pull/15884

Re: new website, docs code freeze

[Aaron Markham <aa...@gmail.com>]

Thanks everyone. The PRs passed CI, but please continue holding off on
docs and CI edits. Unless there are any objections, I'd like to launch
the new website today.

On Wed, Sep 18, 2019 at 7:46 AM Aaron Markham <aa...@gmail.com> wrote:
>
> Hi everyone,
> The last two PRs [1][2] for the new website and docs have passed CI
> (finally). Please do not make changes to /docs or /ci until we get
> these approved and merged. Every time there's a merge conflict it has
> set us back a day or two while shepherding the PRs through CI again.
> Unless there are catastrophic issues discovered in a review, I
> recommend that we hold any patches or updates to the PRs to follow-up
> PRs.
>
> There are four steps to launch:
> 1. Once the PRs are approved, the plan is to merge 15885 to delete the
> old content first.
> 2. Then immediately merge 15883 to add in the new CI flows and updates
> to the content Thomas and I have already had merged in 15884 [3].
> 3. I will change the website validation Jenkins pipeline to point to
> the new pipeline.
> 4. I will change the website publishing Jenkins pipeline to point to
> its new pipeline as well. Once triggered, the old site will be
> replaced with the new one.
>
> Post launch we'll need to update the DNS for beta.mxnet.io to point to
> production, and there will likely be some redirect/.htaccess updates
> needed next week to assist with any deep linking and 404 issues that
> pop up.
>
> Cheers,
> Aaron
>
> [1] https://github.com/apache/incubator-mxnet/pull/15885
> [2] https://github.com/apache/incubator-mxnet/pull/15883
> [3] https://github.com/apache/incubator-mxnet/pull/15884