Changes between Version 35 and Version 36 of specs


Ignore:
Timestamp:
Jul 29, 2010 11:10:04 AM (9 years ago)
Author:
smeghead
Comment:

Make 'More Notes' readable

Legend:

Unmodified
Added
Removed
Modified
  • specs

    v35 v36  
    6060-----------
    6161
    62 <Mathiasdm> I'm not sure about the difference between 'How does it work?' and 'Tech intro'
    63 <Mathiasdm> hm, perhaps the tech intro is the place for an RFC-style document on the core
    64 <smeghead> Mathiasdm: "How does it work" should be a non-technical intro
    65 <smeghead> Mathiasdm: for joe sixpack, not techies
    66 <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/
    67 <Mathiasdm> okay, so perhaps 'Tech intro' should become 'Technical documentation' then
    68 <smeghead> the current how.html should remain the index to the technical docs imo, and a proper technical high-level overview should be written
    69 <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
     62<Mathiasdm> I'm not sure about the difference between 'How does it work?' and 'Tech intro'[[BR]]
     63<Mathiasdm> hm, perhaps the tech intro is the place for an RFC-style document on the core[[BR]]
     64<smeghead> Mathiasdm: "How does it work" should be a non-technical intro[[BR]]
     65<smeghead> Mathiasdm: for joe sixpack, not techies[[BR]]
     66<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/ [[BR]]
     67<Mathiasdm> okay, so perhaps 'Tech intro' should become 'Technical documentation' then[[BR]]
     68<smeghead> the current how.html should remain the index to the technical docs imo, and a proper technical high-level overview should be written[[BR]]
     69<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 [[BR]]