The review of std.hash package

[Johannes Pfau]

Am Wed, 29 Aug 2012 04:57:32 +0200
schrieb "Jesse Phillips" <jessekphillips+D at gmail.com>:

> All this discussion on the use of auto in the docs made me notice 
> something else about the docs I missed.
> 
> I like how ranges are documented and think digest could do the 
> same. Instead of an ExampleDigest, just write the details under 
> isDigest.

I had a look at how std.range documents the range interfaces, but the
std.digest API forces more details on the implementation
(@trusted, exact parameter types for put, return type of finish,...)
so I think simply writing a text paragraph could get confusing.

But if someone posts a pull request which replaces the ExampleDigest
with something else I'm all for it.
> 
> I don't see a need for template the constraint example (D idiom).
> 
> This would require changing examples which use ExampleDigest, but 
> maybe that should happen anyway since it doesn't exist.

Yes, I'll change the examples (this also makes them runnable in theory.
Although I have not found any documentation about making examples
runnable on dlang.org)
> 
> I don't see a reason to change my vote because of this, its all 
> documentation.