digitalmars.D - Actually document #wontfix
- monkyyy (19/21) Jul 28 As I keep telling people, dont trust the docs; they will
- Kapendev (5/8) Jul 28 Most people will find and use `indexOf` first when searching for
- not monkyyy (9/14) Jul 29 In case you need help with ddoc, have a look at the following
As I keep telling people, dont trust the docs; they will carefully craft a technically correct but worthless at explanation why your code will fail countUntil and isCallable are ones ive interacted with *NEITHER* have a clear explanation why its fundamentally badCounts elements in the given forward range until the given predicate is true for one of the given needles.Why that sounds like indexOf, herp derp, every user better go learn the hardway why it isnt named that. Its SO fun to have an off by one error when a user does some unicode while all your test cases in ascii work perfectly; every user should get that learning experience. The docs rants useless describing the horrible compromises inside the function; not clear descriptions of when it will break *which would actually help users* Bolded `#WONTFIX: countUntil does not provide indexs, and never can` `#WONTFIX: isCallable doesnt untangle templated functions` `#WONTFIX: delegates dont mix well with loops` etc etc etc Being technically correct while pretending it works is worthless.
Jul 28
Kapendev <alexandroskapretsos gmail.com> On Monday, 28 July 2025 at 19:27:24 UTC, monkyyy wrote:Why that sounds like indexOf, herp derp, every user better go learn the hardway why it isnt named that. Its SO fun to have an off by one error when a user does some unicodeMost people will find and use `indexOf` first when searching for string functions, so this avoids some confusion. A small comment on `countUntil` about unicode could be helpful though. Or maybe the description of algorithm could include a comment.
Jul 28
On Monday, 28 July 2025 at 19:27:24 UTC, monkyyy wrote:Bolded `#WONTFIX: countUntil does not provide indexs, and never can` `#WONTFIX: isCallable doesnt untangle templated functions` `#WONTFIX: delegates dont mix well with loops` etc etc etcIn case you need help with ddoc, have a look at the following page: https://dlang.org/spec/ddoc.html Check out the "Predefined Macros" sections for details on formatting. Once your changes are good to go, please submit a pull request: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request Looking forward to seeing your improvements! :)
Jul 29
On Tuesday, 29 July 2025 at 21:55:57 UTC, not monkyyy wrote:On Monday, 28 July 2025 at 19:27:24 UTC, monkyyy wrote: Looking forward to seeing your improvements! :)Cute.
Jul 29
On Tuesday, 29 July 2025 at 21:55:57 UTC, not monkyyy wrote:On Monday, 28 July 2025 at 19:27:24 UTC, monkyyy wrote:lolBolded `#WONTFIX: countUntil does not provide indexs, and never can` `#WONTFIX: isCallable doesnt untangle templated functions` `#WONTFIX: delegates dont mix well with loops` etc etc etcIn case you need help with ddoc, have a look at the following page: https://dlang.org/spec/ddoc.html Check out the "Predefined Macros" sections for details on formatting. Once your changes are good to go, please submit a pull request: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request Looking forward to seeing your improvements! :)
Jul 29
On Tuesday, 29 July 2025 at 21:55:57 UTC, not monkyyy wrote:On Monday, 28 July 2025 at 19:27:24 UTC, monkyyy wrote:At this time Im unwilling to work on learning a tool (that Im uninterested in) or tolerate upstreams devs; but heres more concrete and clearer report https://github.com/dlang/phobos/issues/10832 I believe this should be expanded into a policy changeBolded `#WONTFIX: countUntil does not provide indexs, and never can` `#WONTFIX: isCallable doesnt untangle templated functions` `#WONTFIX: delegates dont mix well with loops` etc etc etcIn case you need help with ddoc, have a look at the following page: https://dlang.org/spec/ddoc.html Check out the "Predefined Macros" sections for details on formatting. Once your changes are good to go, please submit a pull request: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request Looking forward to seeing your improvements! :)
Jul 30
On Wednesday, 30 July 2025 at 22:10:21 UTC, monkyyy wrote:On Tuesday, 29 July 2025 at 21:55:57 UTC, not monkyyy wrote:"Hey guys you should really stop what you're doing and work on this, however I totally hate you all and am unwilling to help."On Monday, 28 July 2025 at 19:27:24 UTC, monkyyy wrote:At this time Im unwilling to work on learning a tool (that Im uninterested in) or tolerate upstreams devs; but heres more concrete and clearer reportBolded `#WONTFIX: countUntil does not provide indexs, and never can` `#WONTFIX: isCallable doesnt untangle templated functions` `#WONTFIX: delegates dont mix well with loops` etc etc etcIn case you need help with ddoc, have a look at the following page: https://dlang.org/spec/ddoc.html Check out the "Predefined Macros" sections for details on formatting. Once your changes are good to go, please submit a pull request: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request Looking forward to seeing your improvements! :)
Jul 31
On Thursday, 31 July 2025 at 23:57:21 UTC, claptrap wrote:"Hey guys you should really stop what you're doing and work on this, however I totally hate you all and am unwilling to help."Hey guys you should really stop what you're doing and work on this, however I totally hate you all and am unwilling to help.
Jul 31
On Thursday, 31 July 2025 at 23:57:21 UTC, claptrap wrote:On Wednesday, 30 July 2025 at 22:10:21 UTC, monkyyy wrote:No need for that. Anyway, who wants to make a cool doc PR *wink wink* for [Parin](https://github.com/Kapendev/parin)?At this time Im unwilling to work on learning a tool (that Im uninterested in) or tolerate upstreams devs; but heres more concrete and clearer report"Hey guys you should really stop what you're doing and work on this, however I totally hate you all and am unwilling to help."
Jul 31