[Teas-ns-dt] Management of documents related to NS-DT work

Shunsuke Homma <s.homma0718@gmail.com> Fri, 07 February 2020 07:38 UTC

Return-Path: <s.homma0718@gmail.com>
X-Original-To: teas-ns-dt@ietfa.amsl.com
Delivered-To: teas-ns-dt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 3D4E21200F5 for <teas-ns-dt@ietfa.amsl.com>; Thu, 6 Feb 2020 23:38:24 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.748
X-Spam-Level:
X-Spam-Status: No, score=-1.748 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=no 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 wUbA8nj3_KhV for <teas-ns-dt@ietfa.amsl.com>; Thu, 6 Feb 2020 23:38:23 -0800 (PST)
Received: from mail-io1-xd33.google.com (mail-io1-xd33.google.com [IPv6:2607:f8b0:4864:20::d33]) (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 1F72512003E for <teas-ns-dt@ietf.org>; Thu, 6 Feb 2020 23:38:23 -0800 (PST)
Received: by mail-io1-xd33.google.com with SMTP id h8so1187859iob.2 for <teas-ns-dt@ietf.org>; Thu, 06 Feb 2020 23:38:23 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=3pww1JQkhjRj77Wz6dN1cVlD5yaiBx83ZvuvXWB61VM=; b=nlTU9L62E4QOQwHxIU1JK2SvuVdTCBN+vaqTpW+aOGnfUe7yTmMVZdONmswD7fL/nv Rf6AggjM3ccRv7C4VosDL3eHR2jRheu16+74+Kmcod7bYGWl8c4r5Sg3QAKwonNqL0oZ LeYpfF4fMjnUlFkND6M92AoIgA9puMA1CxZJCXGwtBSWiKKsn1pETgJlwV0UCwncEMCh KxbsNHn7cw47DVjtgpbOd/hHS0HyyR5rMLd8Si346pjLt15mjV0qKKdddtWxqhuMTk0S oUBEVxtSxP0Yn2eU4wfuQ72a8A6w9KI29O/tREyICaY31znfFWIWq/MVt3SmkYqXGUkS ovmg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=3pww1JQkhjRj77Wz6dN1cVlD5yaiBx83ZvuvXWB61VM=; b=OUeOQ5rB1bHpeA0tWIlVKp4sFLHl8MhZlv+0VjoDQjGBaQ+lq4JEbF7j1H+Batttnt vHwhF5aU4pWy7x34LZHISlRybvBlOo31SsaC9RPZPSYVoqHZ6xWZcqblQUFCL49Cer1b e76t/G27L3oJ32QRTrn19mkQA+GoLp/CxQ0fsfjQV6fvu/HpNHYhxALgPtmPhjh1C8CD pBElRo1mNVFg2GdVL9PmCmWVHrNS/IXfyghH8TKfpUpRtZDis2e/yEWMmuNt8IF1M5FS ULblVxGaUn7s6j36EdJzza8rt0AzLCsE98EJSKkum40NGVlgLqDSZIlXslQzuqink6Bz vN+w==
X-Gm-Message-State: APjAAAXqmFFQuqS5zehD9Y1zPctJL3K+rRskcQGT4CwKUWfCTVr47Ypc GGaQBcHzBxEpVXbt+7GZojTMcRMG0C7+PNuxxSYYrsKZ
X-Google-Smtp-Source: APXvYqyqPpef+3aKwp83GN7FLWE/mncGwKCgaR0TuoHxrtxId7H1p33jT5eaHARrXGyXX5uA8xGnJxUk/0xwDyXg038=
X-Received: by 2002:a5e:8e4b:: with SMTP id r11mr2057077ioo.167.1581061102352; Thu, 06 Feb 2020 23:38:22 -0800 (PST)
MIME-Version: 1.0
From: Shunsuke Homma <s.homma0718@gmail.com>
Date: Fri, 07 Feb 2020 16:38:10 +0900
Message-ID: <CAGU6MPc2LZr620-vypEU9VFxdqPZqiZkTq6VM6b7LVMYGS5j=A@mail.gmail.com>
To: teas-ns-dt@ietf.org
Content-Type: multipart/alternative; boundary="0000000000005fbcc5059df7792c"
Archived-At: <https://mailarchive.ietf.org/arch/msg/teas-ns-dt/JdPGQhgeCNRCSVGI02KZ97CXUz0>
Subject: [Teas-ns-dt] Management of documents related to NS-DT work
X-BeenThere: teas-ns-dt@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: TEAS Network Slicing Design Team <teas-ns-dt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/teas-ns-dt>, <mailto:teas-ns-dt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/teas-ns-dt/>
List-Post: <mailto:teas-ns-dt@ietf.org>
List-Help: <mailto:teas-ns-dt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/teas-ns-dt>, <mailto:teas-ns-dt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 07 Feb 2020 07:38:24 -0000

Hi,

I'd like to ask your opinions on management of docs related to NS-DT
work(i.e., definition, framework and others).
They have been uploaded on github of NS-DT repo, but I have some concerns
on editing the files there directly from the following reasons:
- access rights are limited (need to be added your account to collaborators
to edit or upload files on NS-DT repo)
- editing multiple docs in parallel may cause complexity (e.g., making
branches on each doc may cause conflict on merging)
 - too frequent  updates will cause declining of readability. (e.g., you
can't see all of diffs in the same github history page if small changes are
provided frequently. )
# I'm not so familiar with treat of github, and please point out if my
understanding wrong.


Currently, regarding to the definition draft, authors are editing the file
on my individual github repo, and I'm pushing the changes to NS-DT repo
with certain leveled updates.

Of course, I understand there are advantages on management of the docs on
the same repo. For example, you can always grasp the latest status on the
docs.

So, which is better to work on NS-DT repo or on individual repos for each
docs?

Regards,

Shunsuke