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

          Issue ID: 23736
           Summary: Do not override the "docs" directory without a warning
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P1
         Component: dmd
          Assignee: nobody@puremagic.com
          Reporter: rempas@tutanota.com

I saved my documentation in a directory called "docs". When I tried to generate documentation, the compiler override this directory. Thank god, I hadn't written any serious documentation yet! Please, make it check if there is a directory and then warn to use the `-Dd` option and then abandon. I used `dub` with `ldc` btw but I suppose that this is a frontend thing.

And just to be safe and ahead of time, If someone tells me that "I should have known that and be careful", First, there is no info (at least I wasn't able to find it) about the default name of the directory that is created so I couldn't have known that. And second, we are humans and we do mistakes and forget things. And that's why we need tools that protect us.

--