docs(crowdin-apps): add guidelines for writing effective app descriptions

Author: andrii-bodnar

src/content/docs/developer/crowdin-apps/publishing/publishing.mdx

@@ -196,6 +196,43 @@ The app type list:
 | File        | The custom file format. Should have Manifest.                                                                                                                                |
 | System      | The native Crowdin Integration or file extension.                                                                                                                            |
 
+### Writing Effective App Description
+
+The **Content** field is crucial for helping users understand your app's value. Here are some tips for creating compelling app descriptions that convert visitors into users.
+
+#### Structure Your Content
+
+A well-structured description helps users quickly understand what your app does:
+
+1. **Lead with value** - Start with the main benefit your app provides
+2. **Explain how it works** - Describe the key features and workflow
+3. **Include use cases** - Help users envision how they'd use your app
+4. **Add visuals** - Screenshots make your app more tangible
+
+#### Using Admonitions
+
+You can use admonitions to highlight important information in your app description. The following admonition types are supported:
+
+:::note
+Use notes to provide additional context or clarify important details about your app's functionality.
+:::
+
+:::tip[Pro Tip]
+Tips are great for sharing best practices or suggesting optimal ways to use your app.
+:::
+
+:::info
+Use info blocks to highlight key features or compatibility information.
+:::
+
+:::warning
+Warnings help users understand limitations, prerequisites, or potential issues they should be aware of before installation.
+:::
+
+:::danger
+Use danger admonitions sparingly to highlight critical information, such as actions that cannot be undone or potential data loss scenarios.
+:::
+
 ### App Pricing
 
 The pricing field describes the app's pricing model in JSON format. It is used only for rendering pricing info on an app page. You should also implement the behavior in your app.