Version 81 (modified by 9 years ago) (diff) | ,
---|
Task list for updating the docs and specs on the website. This is roughly in the same order as the protocol stack http://www.i2p2.i2p/protocols , but upside down.
Getting Started
- Install Monotone (see http://www.i2p2.i2p/newdevelopers.html)
- Check out the i2p.www branch.
- Pick a task below (and your name to the Who column).
Need help? Ask in #i2p-dev on IRC
General guidelines:
- Remove obsolete information
- Verify information accuracy by checking java source
- Remove blog-style history and evolution and discussion, or move to separate discussion pages
- Add links to references, particularly docs on freehaven.net http://freehaven.net/anonbib/topic.html
- Remove dead links to i2p.net
- Improve readability, navigation
Unclaimed / Help needed
Page or Protocol | Status | Who | Notes |
A Gentle Introduction to I2P http://www.i2p2.i2p/how_intro | smeghead | http://trac.i2p2.i2p/wiki/intro Non-technical intro, see More Notes below. Rename to gentle_introduction.html and link to it from index.html, and remove from how.html (which is for technical docs, not end-user docs) | |
I2P Technical Introduction http://www.i2p2.i2p/techintro.html | Mathiasdm | Technical intro, see More Notes below | |
AES256/CBC Transport Encryption http://www.i2p2.i2p/techintro.html#op.crypto | |||
NTCP http://www.i2p2.i2p/ntcp | zzz did initial tweaks and moved discussion to new http://www.i2p2.i2p/ntcp_discussion . Now needs a crypto person to document the NTCP handshake and crypto (only a crappy picture on there now) | ||
AES256/CBC Tunnel Message Encryption http://www.i2p2.i2p/techintro.html#op.crypto | Mathiasdm | ||
Tunnels http://www.i2p2.i2p/tunnel-alt | Needs lots of work esp. on crypto - why does it say things are decrypted first and then encrypted at the end??? Very confusing - Moved discussion and alternatives to new http://www.i2p2.i2p/tunnel_discussion | ||
Tunnel Routing http://www.i2p2.i2p/how_tunnelrouting | Looks very old, should it be combined with the newer tunnel docs? | ||
Garlic Routing http://www.i2p2.i2p/how_garlicrouting | Looks very old, and this is a confusing term. We were challenged by the Tor guys on whether we actually do strictly what the references define as 'garlic routing'. Needs to be analyzed and either fixed, merged with other docs, or nuked. Should we use this term at all, anywhere? | ||
Garlic Encryption ElGamal?/AES + Session Tag http://www.i2p2.i2p/how_elgamalaes | welt | ||
Tunnel Building circles-and-arrows (picture) | new | ||
Floodfill circles and arrows | new | ||
I2CP http://www.i2p2.i2p/i2cp | Port messages spec from 2003 PDF - Make new i2cp_spec.html page, use same format as http://www.i2p2.i2p/i2np_spec | ||
Streaming http://www.i2p2.i2p/streaming | |||
SAM http://www.i2p2.i2p/sam http://www.i2p2.i2p/samv2 http://www.i2p2.i2p/samv3 | |||
Javadocs http://docs.i2p2.i2p/ | welt | Needs regeneration, add router, streaming lib, SAM and BOB docs | |
API http://www.i2p2.i2p/api | Just linked to http://www.i2p2.i2p/how for now, should we remove link from menu? | ||
All German technical pages | Either update after English page is updated, or put a note at the top saying it is out of date | ||
Development guide http://www.i2p2.i2p/applications | Improve the guide add more info on 'developing using the I2P api'. |
Review needed
Page or Protocol | Status | Who | Notes |
BOB http://www.i2p2.i2p/bob.html | new | sponge | Done! Please review for spelling and grammar. |
Index of technical docs http://www.i2p2.i2p/how.html | 1st pass done, pls review | zzz | See More Notes below. Should probably rename from how.html to something like technical_index.html |
Low-level crypto http://www.i2p2.i2p/how_cryptography | 1st pass done and reviewed (add your name if you've reviewed) | zzz, Mathiasdm | |
Transport Overview http://www.i2p2.i2p/transport | new - 1st pass done, pls review | zzz | Transport bids, priorities, selection, interaction |
SSU http://www.i2p2.i2p/udp | 2nd pass done, pls review | zzz | Formal spec moved to new http://www.i2p2.i2p/udp_spec |
Tunnel Messages http://www.i2p2.i2p/tunnel_message_spec (formerly in http://www.i2p2.i2p/tunnel-alt.html#tunnel.preprocessing ) | new - 1st pass done, pls review | zzz | Moving tunnel-alt section 2.1 to new http://www.i2p2.i2p/tunnel_message_spec |
Tunnel build details http://www.i2p2.i2p/tunnel-alt-creation | 1st pass done, pls review | zzz | |
Common Data Structures http://www.i2p2.i2p/common_structures_spec | 1st pass done, pls review | welt (zzz reviewing) | new - Port from 2003 PDF |
I2NP http://www.i2p2.i2p/i2np http://www.i2p2.i2p/i2np_spec | 1st pass done, pls review | welt (zzz reviewing) | spec page is new - Port messages spec from 2003 PDF |
Floodfill / netdb http://www.i2p2.i2p/how_networkdatabase.html | 1st pass done, pls review | zzz | Major rewrite done, old discussion and history moved to new page http://www.i2p2.i2p/netdb_discussion which can remain somewhat obsolete if we want |
Datagrams http://www.i2p2.i2p/datagrams | 1st pass done, pls review | zzz | |
Plugins http://www.i2p2.i2p/plugins http://www.i2p2.i2p/plugin_spec | new - 1st pass done, pls review | zzz | Mostly copied from http://zzz.i2p/i2p/plugins/ and the spec was copied over pretty much as-is |
Naming / addressbook http://www.i2p2.i2p/naming | 1st pass done, pls review | duck | Moved discussion and alternatives to separate page |
Peer selection and profiling http://www.i2p2.i2p/how_peerselection | 1st pass done, pls review | zzz | |
German index page http://www.i2p2.i2p/how_de.html | 2nd pass done, pls correct&review | HungryHobo?,SqueezeIt? | checked spelling,grammar and links; broken links are: Java-Dokumentation zur Streaming-Bibliothek (englisch), Java-Dokumentation zu I2NP (englisch), Überblick über die Transportschicht (englisch), Java-Dokumentation zur Transportschicht (englisch), Java-Dokumentation zu NTCP (englisch), Java-Dokumentation zu SSU (englisch) |
In Progress
Page or Protocol | Status | Who | Notes |
Use Cases | new, in progress | smeghead | |
Supported Applications | new, in progress | smeghead | |
Monotone http://www.i2p2.i2p/monotone.html | in progress | smeghead | Needs HTML-ification |
Videos | new | xor, jaywalk, zzz, chrisk | Compile list of technical and instructional videos. Include kugg's talk, the HOPE talk, echelon's talk from last year, and everything telecomix has done. See http://pad.telecomix.org/video (current) and http://instruction.telecomix.org/ (older) |
Threat model http://www.i2p2.i2p/how_threatmodel | in progress | smeghead | This may be helpful - or not: http://l6nvqsqivhrunqvs.tor2web.com/index.php?do=topic&id=11566 |
I2PTunnel http://www.i2p2.i2p/i2ptunnel | in progress | duck | This is just awful. Needs a complete rewrite. |
MORE NOTES
<Mathiasdm> I'm not sure about the difference between 'How does it work?' and 'Tech intro'
<Mathiasdm> hm, perhaps the tech intro is the place for an RFC-style document on the core
<smeghead> Mathiasdm: "How does it work" should be a non-technical intro
<smeghead> Mathiasdm: for joe sixpack, not techies
<smeghead> Mathiasdm: that's why i think it should be renamed to something like "A Gentle Introduction to I2P", as implied here: http://duck.i2p/i2p2de-rewrite/site/
<Mathiasdm> okay, so perhaps 'Tech intro' should become 'Technical documentation' then
<smeghead> the current how.html should remain the index to the technical docs imo, and a proper technical high-level overview should be written
<Mathiasdm> I'd also want a more technical spec like Tor has: http://gitweb.torproject.org/tor.git?a=blob_plain;hb=HEAD;f=doc/spec/tor-spec.txt
…snip…
<smeghead> actually, i think it will be easier to move how_intro.html from the list in how.html and use it as the basis for gentle_introduction.html
<smeghead> and techintro.html should replace how_intro.html in how.html
<smeghead> that makes more sense