Opened 8 years ago

Closed 7 years ago

#7376 closed task (fixed)

Reorganize the documentation

Reported by: hellais Owned by: hellais
Priority: Very High Milestone:
Component: Archived/Ooni Version:
Severity: Keywords: ooni_documentation, SponsorH201212, quickfix
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:


Currently our documentation is a mess.

It is distributed across multiple different places and there is no central way of knowing which one is right.

Here is the list of all the current documentation locations:

We are currently using for the developer documentation

The reason for doing so is that it will automatically build the sphinx documentation for us and we don't have to worry about setting up anything on torproject machines to create these docs.

The documentation that is currently stored on the wiki should be moved to .rst files that are in:

Child Tickets

#7759closedhellaisAdd section for DataCollection to ooni websiteArchived/Ooni
#7760closedhellaisAdd installation instructions for OONI to the documentationArchived/Ooni
#7761closedhellaisAdd ThreatModel page to ooni documentationArchived/Ooni

Change History (8)

comment:1 Changed 8 years ago by hellais

Keywords: SponsorH201210 added

comment:2 Changed 8 years ago by hellais

Keywords: ooni_documentation added; documentation removed

comment:3 Changed 8 years ago by hellais

Keywords: SponsorH201208 added; SponsorH201210 removed

comment:4 Changed 8 years ago by hellais

Keywords: SponsorH201210 added; SponsorH201208 removed

Moving to third milestone

comment:5 Changed 8 years ago by aagbsn

Documentation is now located at
is not yet ported to
is now:
is now:
This needs to be more thoroughly documented and linked to the oonib documentation. For example, there should be a page describing the report format, and also link to the backend setup and use of ooni-probe with a collector. See also below:
is briefly mentioned here:
It should have its own page with sections for setting up the backend (similar to or taken from oonib/ and test helpers, and document what each test helper does.
This page points at the readthedocs site which in turn points to: (which displays the file). We should replace this link with a page generated from the file and host it on

comment:6 Changed 8 years ago by hellais

Keywords: quickfix added

comment:7 Changed 8 years ago by hellais

Keywords: SponsorH201212 added; SponsorH201210 removed

comment:8 Changed 7 years ago by hellais

Resolution: fixed
Status: newclosed

This is fixed.

Note: See TracTickets for help on using tickets.