---
myst:
  html_meta:
    "description": "Why Social Media support for Plone works the way it does: settings on content, links, and networks."
    "property=og:description": "Why Social Media support for Plone works the way it does: settings on content, links, and networks."
    "property=og:title": "Concepts"
    "keywords": "Plone, plonegovbr.socialmedia, volto-social-media, concepts, explanation"
---

(concepts-index)=

# Concepts

This part of the documentation explains why the package works the way it does.
It is discursive rather than instructional; for directions toward a result, see {doc}`/how-to-guides/index`.

```{toctree}
:maxdepth: 1
:hidden: true

settings-on-content
links-and-networks
```

`````{grid} 1 1 2 2
:gutter: 3

````{grid-item-card} Settings that live on content
:link: settings-on-content
:link-type: doc

Why the settings are a behavior on the site root rather than a control panel, and what that costs.
+++
Start here.
````

````{grid-item-card} Links and networks
:link: links-and-networks
:link-type: doc

What a link stores, why networks are described in the frontend, and why the links are edited as a table.
````
`````

```{seealso}
The Diátaxis framework calls this class of documentation [explanation](https://diataxis.fr/explanation/).
```