[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
specs:

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.

https://github.com/noiseprotocol/spectemplate
https://github.com/noiseprotocol/spectools


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

https://github.com/noiseprotocol/noise_spec/tree/rev34


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


Trevor


More information about the Noise mailing list