Re: [Tools-arch] Document Production Methods

Silvia Botros <silviamikhail@gmail.com> Wed, 02 September 2020 15:51 UTC

Return-Path: <silviamikhail@gmail.com>
X-Original-To: tools-arch@ietfa.amsl.com
Delivered-To: tools-arch@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 42CC13A11BF for <tools-arch@ietfa.amsl.com>; Wed, 2 Sep 2020 08:51:22 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.096
X-Spam-Level:
X-Spam-Status: No, score=-2.096 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_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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 ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id u_cizw5eVEDj for <tools-arch@ietfa.amsl.com>; Wed, 2 Sep 2020 08:51:20 -0700 (PDT)
Received: from mail-lj1-x231.google.com (mail-lj1-x231.google.com [IPv6:2a00:1450:4864:20::231]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 2FE513A1226 for <tools-arch@ietf.org>; Wed, 2 Sep 2020 08:51:17 -0700 (PDT)
Received: by mail-lj1-x231.google.com with SMTP id e11so6532119ljn.6 for <tools-arch@ietf.org>; Wed, 02 Sep 2020 08:51:17 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=8W+PYpUqqIPwjE+6GIBq7skZvnv2DVVZvKr5hVwDrMw=; b=AhOWjkKIIgRcqmt4jNhTC5mqpdyKt1MI/w6yL+HPfR0abunLj7kg10d8UNTcGMhkcE S8/QliMz4+7Mikt1p0WCCgi3ol7FRkqrj8zt4TOvbyfJfD72W+89AS3rBNF9polhuZZ4 CiBAFSUYKyW7FJ2LVfbhdCqGKiEoQJXjX/+CFcW545t9YjPn7neyzrdK8kyls2Qgla/S WTRwin6vQAW9VemCczFLfrA2EW0Qz1J9SOKh546taYrylKkqlEbQzGUyTwehGOFEK1F3 iCfE1WopytUTDwXNakb3cWeWrc/7tWQ520jOI9KLPvbdOnS4DgZ7BLvHDTeUPl1wkpOH YNBQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=8W+PYpUqqIPwjE+6GIBq7skZvnv2DVVZvKr5hVwDrMw=; b=fg012uml+6NVnA1tai/H9H2XiKXVcDj1gJeDsznfcaWYsVbTgYBLnMeOBJPxlhi8cE aToHHDvFyo5kHbL2ZnWdAsCltBZKRuecbhaqgevQNy7MSsVYcMTyyktG/M4RoQ+r2qk+ GE2glHnjZWK2ONFWfhaYZ8unfRxuZDd7WVoVKvsNlUCGnAAUurfernf7Azq1l5FhGLAW 7LL1mantoDXMP2RoJjfrVooC0ykk6+weAnnKfWQnHj/4lbGXkCoFUyjs/SIEi33A26vp f89u9eVF135hJKcDf0k24EbcAXxzO9jpngtdA12QS7fS7xCetd2zkuxKALLo3XQqpLxG 7P0A==
X-Gm-Message-State: AOAM532xH4gRL3LB7m4LjmDEFHRNvKSJEbveBber2LPCuaE+W+4TIvCp s9ifgvT/h1/tB7kIypGqnC7ALdJlSotf38QUOaZQ5+vlKus=
X-Google-Smtp-Source: ABdhPJy4R6hYUtSt7IKitvXz/J39+fshzMfacKxMSVU8jmgUJK3V09Mw5IvbmCgj42dHPVvTu26K3hJ4MKbdufBJGn8=
X-Received: by 2002:a2e:a483:: with SMTP id h3mr3604703lji.76.1599061875231; Wed, 02 Sep 2020 08:51:15 -0700 (PDT)
MIME-Version: 1.0
References: <20200902023617.66BA41F5F442@ary.qy> <88deacab-2966-4a7f-a28f-b7c19abe3a2f@www.fastmail.com>
In-Reply-To: <88deacab-2966-4a7f-a28f-b7c19abe3a2f@www.fastmail.com>
From: Silvia Botros <silviamikhail@gmail.com>
Date: Wed, 02 Sep 2020 08:51:04 -0700
Message-ID: <CA+tzEMB8Qj=b2dg-QoMtze7zWvHraxsAp=bGR-itEi_fU+Ly2A@mail.gmail.com>
To: Martin Thomson <mt@lowentropy.net>
Cc: John R Levine <johnl@taugh.com>, tools-arch@ietf.org
Content-Type: multipart/alternative; boundary="0000000000000c121a05ae569bd8"
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-arch/34gchycSCv4Urx2Gl6zHMvdWnn4>
Subject: Re: [Tools-arch] Document Production Methods
X-BeenThere: tools-arch@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Tools Architecture and Strategy Team <tools-arch.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-arch>, <mailto:tools-arch-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-arch/>
List-Post: <mailto:tools-arch@ietf.org>
List-Help: <mailto:tools-arch-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-arch>, <mailto:tools-arch-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 02 Sep 2020 15:51:22 -0000

should we consider in this conversation existing IDEs/editors people may
use to create these artifacts? it seems to me that Markdown editors are far
more on the rise than XML and that would be part of the equation for
someone about to start a document.

- SB


On Tue, Sep 1, 2020 at 8:57 PM Martin Thomson <mt@lowentropy.net> wrote:

>
>
> On Wed, Sep 2, 2020, at 12:36, John Levine wrote:
> > I think we underestimated how hard it is to do automated typsetting
> > that produces good looking results so we ended up with a whole lot of
> > very complex tagging to let people say in great detail how they want
> > things to look. We also put in a lot of semantic tags, e.g., this is a
> > picture, that is sourcecode, this other thing is someone's name, which
> > may be useful for future automated processing but we don't know yet.
>
> I guess what I'm challenging here is the inherent value of those
> annotations.
>
> For the typesetting stuff, as that is tied to a very specific instance,
> attempting to preserve those as text is subsequently changed might be
> counterproductive.
>
> For the semantic stuff, as they are not the product of any
> negotiation/consensus process, it is unlikely that they have any special
> status.  As such, I suggest that they exist on much the same level as other
> unofficial markings.  Useful or not, they aren't representative of the
> artifact we are looking to preserve.  They are only useful to the extent
> that they allow us to better communicate about that artifact, to which you
> next point might be the most salient in this regard...
>
> > One of the few things that XML makes simple is to tell what is a tag
> > and what is text.
>
> That unfortunately isn't always respected, as I recently learned.  But
> that's a tooling issue that is easily rectified.
>
> --
> Tools-arch mailing list
> Tools-arch@ietf.org
> https://www.ietf.org/mailman/listinfo/tools-arch
>