Opened 21 months ago

Last modified 6 months ago

#29200 assigned defect

Make more accessible Core Tor documentation

Reported by: juga Owned by:
Priority: Medium Milestone: website redesign
Component: Webpages/Website Version:
Severity: Normal Keywords: documentation, GSoD
Cc: antonela, gaba, ahf, pili Actual Points:
Parent ID: #24132 Points:
Reviewer: Sponsor:


There's Core Tor documentation distributed in three (at least) sources. Even if it's documentation intended for developers, it'd be great that it would be more accessible by providing the HTML version online and using some subdomain or path or links.
The sources are:

I can provide scripts to generate/convert the documentation automatically.
We would need to decide where to put it, maybe get subdomain and get access to the server where it would live.

Child Tickets

Change History (15)

comment:1 Changed 21 months ago by gaba

Cc: gaba added
Keywords: documentation added

comment:2 Changed 21 months ago by gaba

Cc: ahf added

There was some discussion of maybe converting what we have to send it to

comment:3 Changed 21 months ago by juga

Sphinx ( is the tool to generate html from markdown or restructured text and python docstrings. is a service that automatically publish the html from the source documentation.
As ahf pointed out, can be used to format doxygen documentation as sphinx html.

comment:4 Changed 19 months ago by antonela is another option for our docs and is free for non-profits

comment:5 Changed 19 months ago by antonela

Cc: pili added
Component: UX- Select a component
Keywords: ux-team added

comment:6 Changed 19 months ago by gk

Component: - Select a componentCore Tor

It seems this does not belong under the UX component, but having the component in limbo is not good either. Moving tentatively, to core tor. Please, move this to a different component if it fits there better.

comment:7 Changed 19 months ago by juga

Component: Core TorWebpages/Website
Milestone: website redesign
Parent ID: #24132

It probably belongs to Webpages/Website, parent #24132 and milestone website redesign.

comment:8 Changed 19 months ago by juga

I configured torguts and tor to use Sphinx for the markdown documentation.
The branches:

To see how it looks like:

Note the comments on creating a Sphinx theme for Tor. I think it would be easy basing it on the Sphinx bootstrap theme.

I tried to build the doxygen documentation also with Sphinx using breathe, and i managed to get all in one package (left the branch in, but it'd require still more work and i'm not sure it's worth. Doxygen itself could be configured to use templates and custom css, maybe that require less work.

I can remove those readthedocs domains once it's decided what to do.
The documentation could live in readthedocs and have a torproject subdomain that point to it, or it could be deployed in torproject infraestructure having a simple script that pull the repositories every X time and run make html in the documentation directory.

comment:9 Changed 19 months ago by antonela

Owner: changed from antonela to pili
Status: newassigned

comment:10 Changed 19 months ago by gaba

Nice! Thanks!

comment:11 Changed 18 months ago by gaba

We will be participating in google season of docs this year. The project from this ticket will be one of the proposals for people that may apply to it. Let us know if any of you want to help/mentor this project.

comment:12 Changed 18 months ago by pili

Keywords: GSoD added

comment:13 Changed 14 months ago by pili

Keywords: ux-team removed

comment:14 Changed 6 months ago by gaba

Status: assignednew

comment:15 Changed 6 months ago by gaba

Owner: pili deleted
Status: newassigned
Note: See TracTickets for help on using tickets.