graphql-engine/docs/wiki/docusaurus-mdx-guide/admonitions.mdx
Rob Dominguez 712d3e4a9d Docs: Reorganize guides, tutorials, resources section
PR-URL: https://github.com/hasura/graphql-engine-mono/pull/5273
Co-authored-by: Rikin Kachhia <54616969+rikinsk@users.noreply.github.com>
GitOrigin-RevId: c6b7bdaba648d49f37c315a5dd53497f42b6cbd6
2022-10-28 14:00:51 +00:00

72 lines
1.8 KiB
Plaintext

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
# Admonitions
Call-out admonitions allow you to highlight parts of the documentation which require special attention or which
don't fit in the usual flow of content.
```markdown
:::note
**This** is an example of a call-out admonition. For more info please get in touch with us on [Discord]
(https://discord.gg/vBPpJkS).
:::
```
```markdown
:::note Additional Resources
Data Federation with Hasura - [Watch Webinar](https://hasura.io/events/webinar/data-federation-hasura-graphql/).
:::
```
:::caution Please note the empty lines
Please ensure to leave empty lines in the start and the end (first and last lines). This to avoid prettier messing
up the formatting in this Docusaurus special syntax.
Read about it on the [Docusaurus Docs](https://docusaurus.io/docs/markdown-features/admonitions#usage-with-prettier)
:::
```diff {1,3,5,7}
+
:::info Note
+
Make sure to place the note/admonition in a place where the user will see it at the appropriate time.
+
:::
+
```
which would render as below
:::note
**Adding an additional layer on top of the Hasura GraphQL engine significantly impacts the performance provided by it
out of the box** (_by as much as 4x_). If you need any help with remodeling these kinds of use cases to use the built-in
remote schemas feature, please get in touch with us on [Discord](https://discord.gg/vBPpJkS).
:::
:::note Additionl Resources
Data Federation with Hasura - [Watch Webinar](https://hasura.io/events/webinar/data-federation-hasura-graphql/).
:::
<hr />
Please prefer `:::info Note` over `:::note` for a decent blue colored note.
:::info Note
For further syntax and usage reference please check docusaurus
[Admonitions docs](https://docusaurus.io/docs/markdown-features/admonitions)
:::