This documentation is archived and is not being maintained.

Documentation Element (SSDL)

The Documentation element in store schema definition language (SSDL) can be used to provide information about an object that is defined in a parent element.

The Documentation element can have the following child elements (in the order listed):

  • Summary: A brief description of the parent element. (zero or one element)

  • LongDescription: An extensive description of the parent element. (zero or one element)

Applicable Attributes

Any number of annotation attributes (custom XML attributes) may be applied to the Documentation element. However, custom attributes may not belong to any XML namespace that is reserved for CSDL. The fully-qualified names for any two custom attributes cannot be the same.


The following example shows the Documentation element as a child element of an EntityType element.

<EntityType Name="Customers">
    <Summary>Summary here.</Summary>
    <LongDescription>Long description here.</LongDescription>
    <PropertyRef Name="CustomerId" />
  <Property Name="CustomerId" Type="int" Nullable="false" />
  <Property Name="Name" Type="nvarchar(max)" Nullable="false" />

See Also