Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 2C36C200CFA for ; Tue, 5 Sep 2017 10:48:22 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 2AC9716583C; Tue, 5 Sep 2017 08:48:22 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 70FF316583A for ; Tue, 5 Sep 2017 10:48:21 +0200 (CEST) Received: (qmail 56253 invoked by uid 500); 5 Sep 2017 08:48:19 -0000 Mailing-List: contact user-help@ignite.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: user@ignite.apache.org Delivered-To: mailing list user@ignite.apache.org Received: (qmail 56244 invoked by uid 99); 5 Sep 2017 08:48:19 -0000 Received: from mail-relay.apache.org (HELO mail-relay.apache.org) (140.211.11.15) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 05 Sep 2017 08:48:19 +0000 Received: from mail-oi0-f47.google.com (mail-oi0-f47.google.com [209.85.218.47]) by mail-relay.apache.org (ASF Mail Server at mail-relay.apache.org) with ESMTPSA id 3C5E21A02D9 for ; Tue, 5 Sep 2017 08:48:17 +0000 (UTC) Received: by mail-oi0-f47.google.com with SMTP id x184so20270033oia.0 for ; Tue, 05 Sep 2017 01:48:17 -0700 (PDT) X-Gm-Message-State: AHPjjUih/ylZ0qOXI/gIfNgITf4v2hgvmA7FXUnm4j8xxnz5iEPAmuok MlF59OLYEF1wNhKEz5KAez1ltsBc1khL X-Google-Smtp-Source: ADKCNb5XRIyV/PoY3293busviAPRR14Wl+YAXw9jeCmJhJQsolPeHLnNkGZQCGF6JZIR5qbzGoJG4NT8tR54pIVEELA= X-Received: by 10.202.253.8 with SMTP id b8mr2691628oii.71.1504601296216; Tue, 05 Sep 2017 01:48:16 -0700 (PDT) MIME-Version: 1.0 Received: by 10.157.63.182 with HTTP; Tue, 5 Sep 2017 01:47:45 -0700 (PDT) In-Reply-To: References: From: Pavel Tupitsyn Date: Tue, 5 Sep 2017 11:47:45 +0300 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: New API docs look for Ignite.NET To: dev@ignite.apache.org Cc: user@ignite.apache.org Content-Type: multipart/alternative; boundary="001a113d000eca3f7405586d49dc" archived-at: Tue, 05 Sep 2017 08:48:22 -0000 --001a113d000eca3f7405586d49dc Content-Type: text/plain; charset="UTF-8" DocFX takes around 30 seconds on my machine. > if you already tried that Yes, everything is done on my side, see JIRA ticket [4] and preview [5] above. On Tue, Sep 5, 2017 at 11:45 AM, Ilya Suntsov wrote: > Pavel, thanks! > It is the great news! > Looks like DocFX will save 30-40 min. > > 2017-09-05 11:16 GMT+03:00 Pavel Tupitsyn : > > > Igniters and users, > > > > Historically we've been using Doxygen [1] to generate .NET API > > documentation [2]. > > > > Recently it became very slow on our code base (more than 30 minutes to > > generate), and I could not find any solution or tweak to fix that. Other > > issues include outdated looks and limited customization possibilities. > > > > I propose to replace it with DocFX [3] [4]: > > - Popular .NET Foundation project > > - Good looks and usability out of the box > > - Easy to set up > > > > Our docs will look like this: [5] > > Let me know if you have any objections or suggestions. > > > > Pavel > > > > > > [1] http://www.stack.nl/~dimitri/doxygen/ > > [2] https://ignite.apache.org/releases/latest/dotnetdoc/index.html > > [3] https://dotnet.github.io/docfx/ > > [4] https://issues.apache.org/jira/browse/IGNITE-6253 > > [5] https://ptupitsyn.github.io/docfx-test/api/index.html > > > > > > -- > Ilya Suntsov > --001a113d000eca3f7405586d49dc Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
DocFX takes around 30 seconds on my machine.

<= /div>
>=C2=A0if you already tried t= hat
Yes, everything is do= ne on my side, see JIRA ticket [4] and preview [5]=C2=A0above.=

On Tu= e, Sep 5, 2017 at 11:45 AM, Ilya Suntsov <isuntsov@gridgain.com>= ; wrote:
Pavel, thanks!
It is the great news!
Looks like DocFX will save 30-40 min.

2017-09-05 11:16 GMT+03:00 Pavel Tupitsyn <ptupitsyn@apache.org>:

> Igniters and users,
>
> Historically we've been using Doxygen [1] to generate .NET API
> documentation [2].
>
> Recently it became very slow on our code base (more than 30 minutes to=
> generate), and I could not find any solution or tweak to fix that. Oth= er
> issues include outdated looks and limited customization possibilities.=
>
> I propose to replace it with DocFX [3] [4]:
> - Popular .NET Foundation project
> - Good looks and usability out of the box
> - Easy to set up
>
> Our docs will look like this: [5]
> Let me know if you have any objections or suggestions.
>
> Pavel
>
>
> [1] http://www.stack.nl/~dimitri/doxygen/
> [2] https://ignite.apache.org/releases/latest/dotnetdoc/index.html
> [3] https://dotnet.github.io/docfx/
> [4] https://issues.apache.org/jira/brows= e/IGNITE-6253
> [5] https://ptupitsyn.github.io/docfx= -test/api/index.html
>



--
Ilya Suntsov

--001a113d000eca3f7405586d49dc--