[Tools-discuss] Using Martin's tools and GH workflows (was Request to retain kramdown compiler and author stats)

"STARK, BARBARA H" <bs7652@att.com> Fri, 30 April 2021 17:43 UTC

From: "STARK, BARBARA H" <bs7652@att.com>
To: 'Martin Thomson' <mt@lowentropy.net>, "'tools-discuss@ietf.org'" <tools-discuss@ietf.org>
Thread-Topic: Using Martin's tools and GH workflows (was Request to retain kramdown compiler and author stats)
Thread-Index: Adc96BHwH/vgWSTpS3iNzw4f41Lptg==
Date: Fri, 30 Apr 2021 17:42:45 +0000
Message-ID: <DM6PR02MB6924729BCDF41530455481CDC35E9@DM6PR02MB6924.namprd02.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 8f5521f1-1107-4caa-c2f4-08d90bff5d11
X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Apr 2021 17:42:45.3745 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: e741d71c-c6b6-47b0-803c-0f3b32b07556
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: nZAIJznejzz2xfo6VbjykVxR/cviaGkSkGROEWySeBDC70wWes8DmR+DPt3Y9vRL
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR02MB6921
X-OriginatorOrg: att.com
X-TM-SNTS-SMTP: 6B62221FFBED651BC2A4FEB499202812E39939C0F3B65238DB076B0C0F4915042
X-Proofpoint-ORIG-GUID: tgwW63nTZRUwo5D3nlqs476buHazoEDV
X-Proofpoint-GUID: tgwW63nTZRUwo5D3nlqs476buHazoEDV
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.391, 18.0.761 definitions=2021-04-30_11:2021-04-30, 2021-04-30 signatures=0
X-Proofpoint-Spam-Details: rule=outbound_policy_notspam policy=outbound_policy score=0 priorityscore=1501 bulkscore=0 phishscore=0 adultscore=0 spamscore=0 mlxscore=0 lowpriorityscore=0 suspectscore=0 malwarescore=0 impostorscore=0 mlxlogscore=999 clxscore=1011 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2104060000 definitions=main-2104300116
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/-_X7nkKHkGaeTYi-02E6nKOzn2c>
Subject: [Tools-discuss] Using Martin's tools and GH workflows (was Request to retain kramdown compiler and author stats)
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 30 Apr 2021 17:43:09 -0000

> On Thu, Mar 11, 2021, at 02:07, STARK, BARBARA H wrote:
> > I found the instructions for how to set this up to be something I
> > couldn't figure out. They seem to assume a level of knowledge I don't
> > currently possess.
> 
> Happy to walk anyone through what it might take to get started here.  I would
> take that as an opportunity to improve the documentation, which I will concede
> does assume a degree of familiarity with some of the tools.

It's been a while since this discussion, but I thought I'd provide an update. I was starting a new ID so I decided to try all this afresh.
My experience was delightful (really). Everything worked perfectly. I'm very happy.
The one thing I would suggest is it might be useful to recommend people update all their installed "necessary software" whenever creating a new repo. And provide the syntax to do this.
E.g.,
sudo apt-get update; sudo apt-get upgrade
sudo pip3 install --upgrade xml2rfc
sudo gem update kramdown-rfc2629

I did think to do this, but had to look up the syntax for pip and gem updates. Which means some people probably wouldn't think to do this.
Thx,
Barbara

[Tools-discuss] Using Martin's tools and GH workf… STARK, BARBARA H