[noise] spectemplate / spectools

Trevor Perrin trevp at trevp.net
Sun Nov 12 22:44:48 PST 2017

Hi all,

We have lots of ideas awaiting high-quality specifications:
 * NoiseSocket and things built on NoiseSocket
 * Hybrid forward-secrecy
 * Additional 0-RTT modes
 * Additional crypto options (and Disco, etc)

One barrier has been lack of a process for extension documents.  As a
step towards that, I'm proposing a toolchain and template for Noise

The 'spectemplate' repo contains a template Markdown file.  It also
contains a Makefile with commands to build PDF and HTML outputs using
pandoc.  By copying this directory you can quickly start writing
extension specs.

The Makefile assumes pandoc and pandoc-citeproc are installed, with a
SPECTOOLS environment variable pointing to a 'spectools' directory
that contains shared files.


I also started a 'rev34' branch of the Noise spec adapted to spectools:


Anyways, take a look and send feedback.  There's other issues around
document status, but I'll raise that separately.


More information about the Noise mailing list