From dev-return-6376-archive-asf-public=cust-asf.ponee.io@mxnet.incubator.apache.org Fri Jul 5 03:09:07 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 2D89B180595 for ; Fri, 5 Jul 2019 05:09:07 +0200 (CEST) Received: (qmail 2239 invoked by uid 500); 5 Jul 2019 03:09:06 -0000 Mailing-List: contact dev-help@mxnet.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@mxnet.incubator.apache.org Delivered-To: mailing list dev@mxnet.incubator.apache.org Received: (qmail 2228 invoked by uid 99); 5 Jul 2019 03:09:05 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd2-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 05 Jul 2019 03:09:05 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd2-us-west.apache.org (ASF Mail Server at spamd2-us-west.apache.org) with ESMTP id 3D8BC1A3335 for ; Fri, 5 Jul 2019 03:09:05 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd2-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 0.001 X-Spam-Level: X-Spam-Status: No, score=0.001 tagged_above=-999 required=6.31 tests=[SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=disabled Received: from mx1-he-de.apache.org ([10.40.0.8]) by localhost (spamd2-us-west.apache.org [10.40.0.9]) (amavisd-new, port 10024) with ESMTP id aZT_8YRqoELw for ; Fri, 5 Jul 2019 03:09:03 +0000 (UTC) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=140.131.149.3; helo=mail.hs.ntnu.edu.tw; envelope-from=iblis@hs.ntnu.edu.tw; receiver= Received: from mail.hs.ntnu.edu.tw (mail.hs.ntnu.edu.tw [140.131.149.3]) by mx1-he-de.apache.org (ASF Mail Server at mx1-he-de.apache.org) with ESMTPS id 371CD7E208 for ; Fri, 5 Jul 2019 03:09:01 +0000 (UTC) Received: by mail.hs.ntnu.edu.tw (Postfix, from userid 800) id 4C2AEB8006; Fri, 5 Jul 2019 11:08:51 +0800 (CST) Received: from [140.113.215.9] (IP-215-9.cs.nctu.edu.tw [140.113.215.9]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: iblis@hs.ntnu.edu.tw) by mail.hs.ntnu.edu.tw (Postfix) with ESMTPSA id 2D96CB8005 for ; Fri, 5 Jul 2019 11:08:50 +0800 (CST) Subject: Re: demise of dmlc.ml domain & new Julia docs hosting To: dev@mxnet.incubator.apache.org References: From: Iblis Lin Message-ID: <34d21f10-7f3e-863c-b8d8-b72c163d41e3@hs.ntnu.edu.tw> Date: Fri, 5 Jul 2019 11:08:49 +0800 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:60.0) Gecko/20100101 Thunderbird/60.7.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit X-Bogosity: Ham, tests=bogofilter, spamicity=0.499997, version=1.2.4 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 >