mxnet-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Iblis Lin <ib...@hs.ntnu.edu.tw>
Subject Re: demise of dmlc.ml domain & new Julia docs hosting
Date Fri, 05 Jul 2019 03:08:49 GMT
Hi,

I will add +1 to the micro-site approach.
Since I have tried to take the generated MD outputs from
Julia's doc system, but the syntax is incompatible with
the MD plugin of Sphinx.

Iblis Lin
林峻頤

On 7/4/19 12:12 PM, Aaron Markham wrote:
> Hi dev@,
> In case you missed the issues with the dmlc.ml domain, it was let go
> or sniped and now goes to a malware site. [1] Several assets like
> models and the Julia documentation were hosted there.
> 
> I made some progress getting the Julia docs generated as part of the
> regular website build flow. [2] It'll work as long as you have Julia
> installed and configured with MXNet. I don't imagine you can use it to
> build the website natively on your mac or windows box at this point
> because all of the CI and related instructions appear to be only for
> Ubuntu. That being said, I added an option to dev_menu.py so you can
> build the Julia docs with docker on whatever host you're on.
> 
> I tried to bring in the markdown files and have the website theme
> applied to them. Many things were then broken - in large part due to
> some bugs in the website code related to post processing and injection
> of dom elements. This would require a rewrite of the Julia docs to
> workaround the existing website bugs. Rather than do this, I just took
> the Julia site output, which has its own look and feel and nested in
> Julia's API directory. This is much like how the scala docs and the
> java docs are - using their own look and feel as a micro-site. I feel
> that this is the better approach for now.
> 
> The PR for the Julia docs is here:
> https://github.com/apache/incubator-mxnet/pull/15454
> 
> Ivy and I created several new issues to cover the broken links that
> will need fixing. Models that need to be recovered or recreated and
> uploaded to a new location. I have an s3 bucket that I've been using
> for some public assets like this, but I can't make progress on fixing
> those links when the models just don't exist. And I don't have the
> bandwidth to regenerate the model zoo and validate the models.
> 
> Any thoughts or suggestions are appreciated.
> Happy 4th of July!
> 
> [1] https://github.com/apache/incubator-mxnet/issues/15410
> [2] https://github.com/apache/incubator-mxnet/pull/15454
> 

Mime
View raw message