Documentation Element (SSDL)

The Documentation element in store schema definition language (SSDL) in the Entity Data Model (EDM) provides information for developers using the entities and associations declared in the schema. The documentation element has two child elements. The first is the Summary element, which provides a brief description of the type. The second is the LongDescription element, which is a more extensive text description.

All metadata types for EDM constructs like EntityType, ComplexType, EntityContainer, and so forth will support the Documentation element.

An empty Documentation element is valid, and both Summary and LongDescription are optional.

The following example shows the syntax of the Documentation element.

<?xml version="1.0" encoding="utf-8"?>
<Schema Namespace="Adventureworks.Store" Alias="Self" xmlns="https://schemas.microsoft.com/ado/2006/04/edm">
  <Documentation>
    <Summary>Adventureworks SSDL Schema</Summary>
    <LongDescription>This schema shows the SSDL schema for
      a large highly normalized database.</LongDescription>
  </Documentation>
  <EntityContainer Name="AdventureworksContext">
  <!-- Other entity sets-->

  </EntityContainer>
  <!-- Other entity types-->

</Schema>

See Also

Concepts

Documentation Element (CSDL)