Opened 3 weeks ago

Last modified 12 days ago

#32863 new defect

Put an up-to-date web version of the Tor manual somewhere

Reported by: arma Owned by:
Priority: Medium Milestone:
Component: Core Tor/Tor Version:
Severity: Normal Keywords:
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description

We used to publish
https://2019.www.torproject.org/docs/tor-manual.html.en
but that version of the Tor manual is now obsolete and for archival purposes.

I guess in the glorious future we will have a dev.torproject.org/tor/ that lists things like the Tor manual. Or maybe it should be on support.torproject.org because it is a resource for users (albeit advanced ones), not developers. Maybe it *is* on support.tpo right now, and I just couldn't find it?

In any case, here is a ticket for making progress on actually getting a web version of the manual onto a web page somewhere, ideally automatically kept up to date.

(Once it exists, there is a good argument for adding another htaccess rule to the 2019.www site, redirecting from the man page that nobody should look at it to the one that people should.)

This ticket motivated by discussion in #28526.

Child Tickets

Change History (3)

comment:1 Changed 13 days ago by pili

I think this should go on dev.torproject.org

We plan to kick of this project this month

comment:2 Changed 12 days ago by nickm

I thought that "dev" was for things of interest to developers... but the manual is of interest to both developers and "power users". Is "dev" for that kind of thing too?

comment:3 in reply to:  2 Changed 12 days ago by pili

Replying to nickm:

I thought that "dev" was for things of interest to developers... but the manual is of interest to both developers and "power users". Is "dev" for that kind of thing too?

I see dev as a place for "power users" also, I'm happy to discuss and change my mind :)

The developer portal should be "owned" by each development team at Tor Project so, apart from some standard content that we brainstormed would be useful to have for each development team at Tor Project, this is your space to host any useful information, documentation, etc... that you feel would help anyone to dive deeper into the work your team does.

Note: See TracTickets for help on using tickets.