[Cryptech Tech] Updated README - and discussion on needed documentation

Randy Bush randy at psg.com
Tue Nov 18 06:19:19 UTC 2014


> Agreed, with the proviso that //somewhere// there needs to be overview
> documentation that explains how all the design objects {fit together |
> can be made to fit together | were intended to fit together} to do
> something useful.
> 
> Randy is no doubt laughing at this point, but keep in mind that in at
> least some cases, the person doing the build may not be the person who
> does the in-depth review of the security properties (etc) of all the
> pieces.  So we have to write doc not just for the wizard who's going
> to go over everything with a fine tooth comb but also for the code
> monkey who's been ordered to get the silly thing to build while the
> wizard flies off to another conference with fine lunches and dinners.

think quick start guide.  up front an overview and "impatient people
start here"

randy


More information about the Tech mailing list