Shaun McCance
shaunm@gnome.org 2008
Give credit where credit is due.

# Créditos

    mal_info_credit = element credit {
      attribute type { xsd:NMTOKENS } ?,
      attribute * - (mal:* | local:*) { text } *,

      (
        mal_info_name &
        mal_info_email ? &
        mal_info_years ? &
        mal_external *
      )
    }

Use the `credit` element to record who has contributed to the page or section. You can optionally use the `type` attribute to specify what types of contribution the person has made. The `credit` element also specifies copyright holders when used with the `years` element.

# Notas

The `credit` element contains a `name` element, an optional `>email` element, and an optional `years` element. The `credit` element can also contain elements from external namespaces. The order of the child elements does not matter.

The `credit` element can occur in any `info` element.

The optional `type` attribute can be used to specify what type of contribution the person has made. The `type` attribute contains a space-separated list of credit types. The following values are recommended:

`"author"` | somebody responsible for writing content
`"editor"` | somebody who has provided reviews or editorial corrections
`"copyright"` | a person or entity which holds copyright on the work
`"maintainer"` | the person or entity currently responsible for the work
`"collaborator"` | somebody who has provided extensive rough information
`"translator"` | somebody who has translated the work into another language
`"publisher"` | a person or entity who distributes formatted copies

The `credit` element can have attributes from external namespaces. See for more information on external-namespace attributes.

# Processing Expectations

There are no specific processing expectations for the `credit` element. As an informational element, it is not necessarily displayed. Some tools, however, may choose to display credits at the bottom of a page, on a separate information page, or in a dialog.

When processing the children of a `credit` element, tools should select the child elements they understand and ignore all other child content.

# Comparison to Other Formats

The `credit` element serves the purpose of the `author`, `collab`, `corpauthor`, `editor`, `othercredit`, and `publisher` elements in DocBook. DocBook does not have specific elements for maintainers and translators.

In DocBook, certain credit elements have highly structured content, whereas others allow simple inline text. In Mallard, all credits use simple structured content. While Mallard does not provide child elements for everything that can be recorded in DocBook, elements from external namespaces may be used for any additional information that is needed.

The `credit` element also records copyright information. In this capacity, it is similar to the `copyright` element in DocBook.