[Issue 18022] DDoc: reduce ddoc has UT between documentation

d-bugmail at puremagic.com d-bugmail at puremagic.com
Mon Dec 4 12:51:07 UTC 2017


https://issues.dlang.org/show_bug.cgi?id=18022

--- Comment #2 from John Hall <john.michael.hall at gmail.com> ---
(In reply to RazvanN from comment #1)
> This is not a bug, but a documented unittest. Closing as invalid.

I'm not happy with this decision. 

I understand what a documented unittest is. The problem is the ordering. Right
now, for functions like reduce, it goes

1) some template-level documentation
2) unittests
3) the functions

I believe it should go

1) some template-level documentation
2) the functions
3) unittests

For other examples, I noticed it in mir-algorithm, which depends on ddoc. See
http://docs.algorithm.dlang.io/latest/mir_ndslice_topology.html#map
the actual map function where it has the returns is all the way at the end

--


More information about the Digitalmars-d-bugs mailing list