This is likely to stay open for a long time. Feel free to create other bugs (either at function/type level or at module level) and make this depend upon them.
Having a good example for everything there is in the standard library would vault the quality of our documentation to the next level, and is a terrific way for new members to learn.
Comment #1 by greeenify — 2016-10-16T18:45:31Z
Something that is related to this and also very useful is increasing the code coverage. With the new CodeCov tool (or by directly running the tests locally), it's as easy as picking a module, looking up the uncovered lines and adding tests for those. As a reward one might even find hidden bugs ;-)
Comment #2 by greeenify — 2016-12-27T11:12:47Z
*** Issue 16990 has been marked as a duplicate of this issue. ***
Comment #3 by greeenify — 2016-12-27T11:14:54Z
There's now a helper tool in dlang/tools:
https://github.com/dlang/tools/blob/master/styles/has_public_example.d
it run with e.g. dub --root=../tools/styles -c has_public_example -i std
Moreover, there's an open PR to Phobos to enable it with a blacklist:
https://github.com/dlang/phobos/pull/4998
It will introduce this as `has_public_example` Makefile target, thus from the Phobos repo one can run the following to find functions without public examples:
make -f posix.mak has_public_example
Help to reduce the blacklist is very welcome!