[Cryptech Core] [Cryptech Tech] Doc, Markdown, and Wiki

[Joachim Strömbergson]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Aloha!

I'm totally in agreement. I don't think we can go overboard with amount
of documentation. I see it as a really critical issue. That I haven't
done much of it is one of my sore spots right now. There is only so much
time. Right now I'm trying to complete my Cryptech preso for tomorrows
FOSS event. Lots of slides. And will bring all boards etc to show.



Randy Bush wrote:
> my personal preference is the wiki.  but i think that how the docs
> are organized is more important than the format.  the format should 
> facilitate the organizaion, hence my liking a wiki.
> 
> for 'internal,' i.e. code contributor use, organizing by module
> makes sense.
> 
> but the front pages really need to be from the user pov.  how to
> build and test on novena, step by boring step.  how to build and test
> on terasic, step by step.  how the code and docs are organized to
> design and build your own.  ...
> 
> rob and i have been weak on this user view with the routing sec
> project. things grew from the source out and up, not leading to an
> easy to use docco set.
> 
> and you have seen rob and me beat our heads on the current wiki.  and
> i am not sure you, joachim, have a happy novena yet.
> 
> i guess my point is that one face of the wiki has to maximize the
> user's chances of easy success.  at the same time i agree that the
> code and hardware need solid docs.
> 
> randy


- -- 
Med vänlig hälsning, Yours

Joachim Strömbergson - Alltid i harmonisk svängning.
========================================================================
 Joachim Strömbergson          Secworks AB          joachim at secworks.se
========================================================================
-----BEGIN PGP SIGNATURE-----
Version: GnuPG/MacGPG2 v2.0.22 (Darwin)
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQIcBAEBCAAGBQJUTrRuAAoJEF3cfFQkIuyN5+UQANbeZtifikpz948bfzzGf4/4
jqWBKk7gnymKngS8YBzB70qgiVzJLBDdhbrRmia7Yq0mT9ML1T38z0Y5VvyhssPx
5BTxBz5ZkDU4tGdTJTieSEFbGnLNPOWvHw8ighakws9XTY3UMRgXXK4sXhSiVDes
S2uTb8qEJfeCg6zX7PaW9x9DyyWm+EekkVVlfg0C8Syb9bMB4Ij5DuSpA7sz+7wB
b4KKoqvEfdkxMIXkC6piYoUwrKIlZgYeboRoQFx8n3G6Qjlw+VtyL2QjZ+A3uwPI
N2uyV7wGlJdrNATM8uM+k3oCgItnzWMwRmrzw9KcC70rxImUK4PvO8GxlrhuHjZo
9YppkBCuIH1flVTx9dvsBqaXJJOy+Awp5aNZF7wQhieu3DBhENzlYOuTak1Z6zdd
vToXkKECG9pke2RttPv+Yx4cqQzaJScMM2/yQbmtwal4wSKjyUR0Hxe69qWtbSAA
K5wXu8c9CBnBEKqD0N5/T80br2QX0A+nhTvr0WLm1qkkU8afKxLYu/LSDcn2BR81
hGdUSXrAMeZ/IlzEeWWQFT040WDNx84SJmX60zfsQ0KWyvDQ+8iFRSdQipRz34BF
lztilu+pkSqD5d78NQuDLriE2jDoqv5Ui2cVzOFuRSebaC6ZUPm3jUsSeWOJaOWH
93zRmN9TXsGNu+dDfQGC
=bAQz
-----END PGP SIGNATURE-----