a2ecec5332
* adds semantic brs and contentFilter * renames ContentFilter to HistoryContentFilter * removes optional qualifiers * fixes a minor notational issue * adds the change log * adds link to protobuf v3 * combines two lines * Apply suggestions from code review Co-authored-by: Franck Royer <franck@royer.one> * review comments * replaces waku store with WAKU2-STORE * refines changelog structure * includes "added" section in the changelog * Apply suggestions from code review Co-authored-by: Oskar Thorén <ot@oskarthoren.com> * adds store ID * adds protocol ID * explains the use of an empty contentFilters field * rephrases the result of empty content filters * explains the use of pubsubTopic field, also updates the field numbers * adds link to waku relay * minor rewording * reflects the current specs state into the changelog * rephrases some parts * rewords some parts * deletes the changelog Co-authored-by: Franck Royer <franck@royer.one> Co-authored-by: Oskar Thorén <ot@oskarthoren.com> |
||
---|---|---|
.github/ISSUE_TEMPLATE | ||
archetypes | ||
content | ||
example-content | ||
layouts/docs | ||
resources/_gen/assets/scss | ||
static | ||
themes | ||
.gitignore | ||
.gitmodules | ||
.pyspelling.yml | ||
.remarkrc | ||
.textlintrc | ||
README.md | ||
config.toml | ||
netifly.toml |
README.md
rfc.vac.dev
This repository contains the specs for vac, a modular peer-to-peer messaging stack, with a focus on secure messaging. A detailed explanation of the vac and its design goals can be found here.
See rfc.vac.dev.
Contributing
Please see 1/COSS for general guidelines and spec lifecycle.
Building locally
Ensure you have the Hugo extended edition
(https://gohugo.io/getting-started/installing/), then run hugo server
.
These protocols define various components of the vac stack.
Style guide
Sequence diagrams are generated using Mscgen like this: mscgen -T png -i input.msc -o output.png
. Both the source and generated image should be in source control. For ease of readability, the generated image is embedded inside the main spec document.
Alternatively, mscgenjs can be used to generate sequence diagrams (mscgenjs produces better quality figures especially concerning lines' spaces and figures' margins). Once installed, the following command can be used to generate the sequence diagrams mscgenjs -T png -i input.msc -o output.png
. More details on the installation and compilation are given in mscgenjs repository. You may try the online playground https://mscgen.js.org/ as well to get a sense of the output figures.
Meta
The keywords “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
Acknowledgement
Site layout and process inspired by https://rfc.zeromq.org/