IETF Logo Mail Archive

Re: Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages

David Schinazi <dschinazi.ietf@gmail.com> Thu, 22 September 2022 20:02 UTC

Return-Path: <dschinazi.ietf@gmail.com>
X-Original-To: wgchairs@ietfa.amsl.com
Delivered-To: wgchairs@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4890DC14CE21; Thu, 22 Sep 2022 13:02:50 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.105
X-Spam-Level:
X-Spam-Status: No, score=-2.105 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 4CQ2Q_3Mwf9F; Thu, 22 Sep 2022 13:02:46 -0700 (PDT)
Received: from mail-pg1-x52b.google.com (mail-pg1-x52b.google.com [IPv6:2607:f8b0:4864:20::52b]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8C1B8C14CF10; Thu, 22 Sep 2022 13:02:46 -0700 (PDT)
Received: by mail-pg1-x52b.google.com with SMTP id bh13so10248514pgb.4; Thu, 22 Sep 2022 13:02:46 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date; bh=1l6a+6ve0NPDY+eS7A6mKWACMhsISS2nbD9FOngVZKI=; b=aAENI8lwb7BC2+aVWEwJYI1O/ecNdcA0Mk/ECHcJ/MMUPNA1UD01wyplVDlHOzccNE ekhf8sxM91Zck8nihvoW2VN58LTexUhr8JGxPkiI608JFw3bPjp0oeAeynEQXmELjrek lSjO198QAlY8QzKelP5nxlkwmYaUeyF1X3osyjYfQ6YVvE+JOEQrZdlcgck1SIPAHzOv +tX2UZkz50WmY24uLob4SQjfumY3VScCPI9O9YPPYIObK3kpM28PQ313VCt8NsFR0qdQ +0SlhhZPdlRacJNFgIV4rJo5zViADCJhnIg4dYU580bOQKWQLSe5uorUWZfYG/lXNFMJ oQ7w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date; bh=1l6a+6ve0NPDY+eS7A6mKWACMhsISS2nbD9FOngVZKI=; b=VdUJe4nKMPw4ON0xmXj+2IjvVdBF3fwyaoegeD6Bh12QsOQ4cEOmFq+kLZ7T08qeQe Aw5DEve8lIDcdG2yr83zdk9cwJrPlrboz2tq6rddtw2C0fKaZh+7NxNO2zYnw/ytazeq ghg70ZIvHhTlhmRTyhduwQE8GFhETG88TAB+eyFgdMlWrVBs6kpDiCZqE9ZTDMJuyOPx 8nZUTDT6QMkrJOu+E4ed9D13wBx+R5qq2LnD9h4p+4oqlbtGAWv06GSuhmp/VhyVaOuy 5NOMnwhPZEMJJz9w81mQZl97nNlMUyYurylOtvqPd9SMF8eUtdY56a3OBc0RyjMYHGa5 9JxQ==
X-Gm-Message-State: ACrzQf1cYlwPUdZmo31GO3W4o2zudvfkXYWw4HO4EFWhYXafSy/ri1R/ 9D/yfCCPoVHCI6jyvg4U27LCrvZA/V0TCHSP3zieSp5k
X-Google-Smtp-Source: AMsMyM7YXpozPZUcCR8i+JgLZ6PiImBiuvHh5hJbhQjvTk3jzy5/dwNtcRc2ol0U1benmdEah/57wN4S1Cmoq0j/Bq8=
X-Received: by 2002:a63:2347:0:b0:43c:22db:dbae with SMTP id u7-20020a632347000000b0043c22dbdbaemr2454295pgm.579.1663876965495; Thu, 22 Sep 2022 13:02:45 -0700 (PDT)
MIME-Version: 1.0
References: <9085c285-1499-77c2-21a6-0f615286f31e@nostrum.com>
In-Reply-To: <9085c285-1499-77c2-21a6-0f615286f31e@nostrum.com>
From: David Schinazi <dschinazi.ietf@gmail.com>
Date: Thu, 22 Sep 2022 13:02:34 -0700
Message-ID: <CAPDSy+54SY3ZyeYG2HWa9yxWaqA1u3GLAZz41vjKO6Wat+73tw@mail.gmail.com>
Subject: Re: Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages
To: tools-discuss <tools-discuss@ietf.org>
Cc: ietf@ietf.org, Working Chairs <wgchairs@ietf.org>
Content-Type: multipart/alternative; boundary="0000000000007a764005e9498b49"
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/CBPValFcEq7q1In0zzqI8b8RVDM>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Working Group Chairs <wgchairs.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wgchairs/>
List-Post: <mailto:wgchairs@ietf.org>
List-Help: <mailto:wgchairs-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 22 Sep 2022 20:02:50 -0000

This looks absolutely amazing, thanks for doing it! I love that the table
of contents has proper links and that links like "Section X.Y of RFC ZZZZ"
now work properly.
David

On Thu, Sep 22, 2022 at 12:54 PM Robert Sparks <rjsparks@nostrum.com> wrote:

> We've set up https://sandbox-htmlize.ietf.org/ to help continue to get
> feedback on the htmlization changes a group led by Lars has been working
> towards.
>
> These changes will replace/enhance how pages at /doc/html/... are built.
>
> First - Many thanks to the tools-discuss participants who helped verify
> this temporary site's configuration, and have started providing feedback
> already on this thread:
>
> https://mailarchive.ietf.org/arch/browse/tools-discuss/?q=help%20check%20config
>
> Compare, for example:
>
> https://datatracker.ietf.org/doc/html/draft-ietf-v6ops-ipv6-deployment-07
>
> and
>
>
> https://sandbox-htmlize.ietf.org/doc/html/draft-ietf-v6ops-ipv6-deployment-07
>
> Please try the new site at
>
> Report issues and provide feedback either at tools-discuss@ietf.org or
> at the github datatracker repository. Please be clear in the feedback
> that you are talking about what's being served at sandbox-htmlize and
> not the production datatracker.
>
> If you spot something and want to contribute code, be sure your PR
> targets the feat/htmlize branch at
> https://github.com/ietf-tools/datatracker/tree/feat/htmlize.
>
> We plan to leave this running to collect feedback only for a short time,
> so please take a look and provide feedback as soon as you can.
>
> RjS
>
>

v2.23.0 | Report a Bug | By Email