IETF Logo Mail Archive

Re: [Tools-discuss] RESTful API style guide

Carsten Bormann <cabo@tzi.org> Wed, 19 June 2013 16:47 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8AC2D21F9948 for <tools-discuss@ietfa.amsl.com>; Wed, 19 Jun 2013 09:47:55 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -106.202
X-Spam-Level:
X-Spam-Status: No, score=-106.202 tagged_above=-999 required=5 tests=[AWL=0.047, BAYES_00=-2.599, HELO_EQ_DE=0.35, RCVD_IN_DNSWL_MED=-4, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Bpdim0bC7adj for <tools-discuss@ietfa.amsl.com>; Wed, 19 Jun 2013 09:47:50 -0700 (PDT)
Received: from informatik.uni-bremen.de (mailhost.informatik.uni-bremen.de [IPv6:2001:638:708:30c9::12]) by ietfa.amsl.com (Postfix) with ESMTP id 6DF0721F9D0F for <tools-discuss@ietf.org>; Wed, 19 Jun 2013 09:47:50 -0700 (PDT)
X-Virus-Scanned: amavisd-new at informatik.uni-bremen.de
Received: from smtp-fb3.informatik.uni-bremen.de (smtp-fb3.informatik.uni-bremen.de [134.102.224.120]) by informatik.uni-bremen.de (8.14.4/8.14.4) with ESMTP id r5JGlg2l020402; Wed, 19 Jun 2013 18:47:42 +0200 (CEST)
Received: from [192.168.217.105] (p54893A31.dip0.t-ipconnect.de [84.137.58.49]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by smtp-fb3.informatik.uni-bremen.de (Postfix) with ESMTPSA id 9BBCB3C2A; Wed, 19 Jun 2013 18:47:42 +0200 (CEST)
Mime-Version: 1.0 (Mac OS X Mail 6.5 \(1508\))
Content-Type: text/plain; charset="iso-8859-1"
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <21266.1371520672@sandelman.ca>
Date: Wed, 19 Jun 2013 18:47:41 +0200
Content-Transfer-Encoding: quoted-printable
Message-Id: <A83AFB5B-9563-4E71-A45E-7A9F10DAA5FF@tzi.org>
References: <21266.1371520672@sandelman.ca>
To: Michael Richardson <mcr+ietf@sandelman.ca>
X-Mailer: Apple Mail (2.1508)
Cc: tools-discuss@ietf.org
Subject: Re: [Tools-discuss] RESTful API style guide
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.12
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: <http://www.ietf.org/mail-archive/web/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: Wed, 19 Jun 2013 16:47:55 -0000

On Jun 18, 2013, at 03:57, Michael Richardson <mcr+ietf@sandelman.ca> wrote:

> I'm writing it in markdown, although I found that neither the perl nor python
> markdown converter seems to deal properly with code samples indented by 4
> spaces.  Any suggestions on a better tool chain?

I generally use a tool called kramdown for my markdown needs.
(Including https://github.com/cabo/kramdown-rfc2629 -- but I gather this is not becoming an Internet-Draft?)

Grüße, Carsten

v2.23.0 | Report a Bug | By Email