// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page qtcontacts-index.html
    \title Qt Contacts
    \brief Qt Contacts enable you to manage contact information, whether it is
    stored locally or remotely.

    A contact is the digital representation of a person, group, or entity that
    is stored in a platform-specific manner. A single contact may consist of
    details that are stored in several different datastores, and that are only
    relevant in different contexts.

    Developers can write platform-independent implementations of a contact
    manager engine, which may unify one or more platform-specific contact
    backends. This enables client applications to request contact data from
    local or remote backends in a platform-independent and datastore-agnostic
    manner.

    Client applications can retrieve, modify, or delete contacts, as well as
    sort or filter contacts and access them as a list. In addition, they can
    import and export contacts in vCard format.

    \section1 Getting Started

    To include the definitions of the module's classes, use the following
    directive:

    \snippet doc_src_qtcontacts.cpp include

    To use the C++ library in your application, add the following to your
    \c CMakeLists.txt file:

    \snippet snippets/CMakeLists.txt cmake_use

    To use the QML types in your application, add the following import statement
    to your \c .qml file:

    \snippet moduleimports.qml Contacts import

    \section1 Related Information

        \section2 Guides
        \list
        \li \l{Qt Contacts Overview}
        \li \l{Qt Contacts API Usage}
        \li \l{Qt Contacts Action API}
        \li \l{Qt Contacts Asynchronous API}
        \li \l{Qt Contacts Synchronous API}
        \li \l{Qt Contacts Manager Engines}
        \li \l{Qt Contacts C++ API} - overview of the C++ API
        \li \l{Qt Contacts QML API} - overview of the QML API
        \endlist
        \section2 References

        \list
        \li \l{Qt Contacts C++ Classes} - list of C++ classes
        \li \l{Qt Contacts QML Types} - list of QML types
        \endlist

        \section2 Examples
        \list
        \li \l{qmlcontactslistview}{Qt Quick Contacts List view}

            Import contact information from vCard files, select a backend for
            volatile memory or persistent storage, as well as list, add, edit,
            and remove contacts.
        \endlist
*/
