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

          Issue ID: 23432
           Summary: document when array capacity is zero and capacity
                    performance
           Product: D
           Version: D2
          Hardware: x86
                OS: Windows
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody@puremagic.com
          Reporter: nick@geany.org

The spec should document that reducing array length will set capacity to zero. (This was already reported as an invalid issue #11561).

The spec should warn that capacity needs a global lock and table lookup.

PR incoming.

--