What is this?
This is OONI Spec, the repository where OONI openly specifies its testing methodology: the experiments (nettests) it runs, the backend components used for testing, and the data formats for the results.
This is OONI Spec, the repository where OONI openly specifies its testing methodology: the experiments (nettests) it runs, the backend components used for testing, and the data formats for the results.Is this a program I can run, or written documentation?Written documentation: a set of specification documents maintained through a process similar to the internet RFC process, not software you install or execute.
Written documentation: a set of specification documents maintained through a process similar to the internet RFC process, not software you install or execute.Where should I start reading?With the README, then the separate introduction describing how OONI operates from the OONI Probe point of view; that is the entry point the README gives newcomers.
With the README, then the separate introduction describing how OONI operates from the OONI Probe point of view; that is the entry point the README gives newcomers.Who are these specs written for?Primarily new OONI developers, who are advised to read them for context, plus anyone who wants to implement OONI's tests on their own.
Primarily new OONI developers, who are advised to read them for context, plus anyone who wants to implement OONI's tests on their own.What is a nettest?Nettests (also called experiments) are network experiments that deliver results meaningful to end users; they are what OONI Probe actually runs when it tests a connection.
Nettests (also called experiments) are network experiments that deliver results meaningful to end users; they are what OONI Probe actually runs when it tests a connection.What is inside the repository?Specs are grouped into five areas: nettests (the experiments), probe (the user-facing testing software), techniques (implementation strategies, hypotheses and per-platform details), data-formats (how results are presented to users and analysts) and backends (core infrastructure that carries out the experiments).
Specs are grouped into five areas: nettests (the experiments), probe (the user-facing testing software), techniques (implementation strategies, hypotheses and per-platform details), data-formats (how results are presented to users and analysts) and backends (core infrastructure that carries out the experiments).Why does OONI write formal specifications instead of just shipping code?The RFC-style process is meant to give a deep understanding of how each test works, make the assumptions explicit, and allow anyone to build independent implementations of the methodology.
The RFC-style process is meant to give a deep understanding of how each test works, make the assumptions explicit, and allow anyone to build independent implementations of the methodology.What is OONI Probe itself?It is the software that users run to perform the nettests; the probe directory here specifies it, and OONI publishes separate user-facing documentation for installing and using it.
It is the software that users run to perform the nettests; the probe directory here specifies it, and OONI publishes separate user-facing documentation for installing and using it.What are similar projects?rfcs, spec, nostr, EIPs, FreeRDP, design, language-server-protocol, shadowsocks
rfcs, spec, nostr, EIPs, FreeRDP, design, language-server-protocol, shadowsocksWhich topics is it in?transparency, standards, censorship, specification, protocol, bsd, reference, documentation, networking, research, privacy, security
transparency, standards, censorship, specification, protocol, bsd, reference, documentation, networking, research, privacy, security