On Friday, January 22, 2016 at 9:16:59 AM UTC-5, jean-pierre.muench wrote:
>
> Hey Everyone, 
>
> I just wanted to let everybody know that our FAQ[1] is mostly broken or 
> out-of-date. 
>
> ...
> It's broken insofar that (almost) none of the actual FAQs can be 
> retrieved as they point to specific resources on the website which are 
> no longer available. 
>

Crypto++ is a community effort. Feel free to make changes and fix things. 
You don't even need to announce them.

My approach is this: keep things moving forward, and discuss what is 
needed. A small tweak needs little discussion, a big tweak needs more 
discussion. Turn to the community when possible for solutions.

Secondary documentation, like the FAQ and Wiki, needs no discussion because 
the crowd eventually converges on the correct answer. To me, its a puzzling 
and confounding property of the crowd. That is, how do X non-SME's 
eventually converge upon the correct answer after Y iterations. I've been 
looking for an academic treatment of the subject.

Sometimes, there are unintended consequences, so you have to discuss things 
after moving forward. I think this is OK because some things can be 
endlessly debated and discussed. You enter into the proverbial "diminishing 
returns" area. Don't let perfection be the enemy of the good.

Sometimes things gets broken and you have to discuss it more to understand 
how to fix it more completely. In this case, you have to be proactive about 
detecting breaks. That's why cryptest.sh is so large, and its why its 
multiple times a day on different platforms. Users don't see most of the 
little problems it detects before and after a change.

Finally, its not enough to complain. Be sure you have a proposed solution 
when you complain. Complaining without a solution is just needless chatter. 
In the case of a bug report, be ready for me to ask for the pull request 
with the proposed changes. Crypto++ is a community effort, so I expect the 
community to have proposed fixes.

Jeff 

-- 
-- 
You received this message because you are subscribed to the "Crypto++ Users" 
Google Group.
To unsubscribe, send an email to [email protected].
More information about Crypto++ and this group is available at 
http://www.cryptopp.com.
--- 
You received this message because you are subscribed to the Google Groups 
"Crypto++ Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.
  • FAQ Jean-Pierre Münch
    • Re: FAQ Jeffrey Walton

Reply via email to