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

          Issue ID: 24543
           Summary: The `@future` attribute is (almost) undocumented
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: major
          Priority: P1
         Component: dlang.org
          Assignee: nobody@puremagic.com
          Reporter: qs.il.paperinik@gmail.com

The only mention of the `@future` keyword is on the traits site (where it is not explained what it is).

It should be listed as a `AtAttribute` on Grammar.
It should be explained in Declarations, Functions, and/or Attributes.

The feature is live 7 years now.

--