Marketing page in Appendix I - Resources

_SUMMARY.md

@@ -267,6 +267,7 @@
 
 * [Glossary](appendix/glossary.md)
 * [Useful Links](appendix/resources/useful_links.md)
+* [Marketing](appendix/resources/marketing.md)
 * [Consulting](appendix/resources/consulting.md)
 
 ## Appendix II - API Changes

appendix/resources/marketing.md

@@ -0,0 +1,131 @@
+---
+title: Marketing
+---
+<!-- Copyright 2000-2020 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
+
+## Embeddable Widgets
+
+The Marketplace provides embeddable widgets that you can place on your website with a simple code snippet:
+
+- Embeddable Plugin Card - renders an information card with the plugin name, icon, description, last update, and downloads counter,
+- Embeddable "Install Plugin" Button - provides a button that allows installing your plugin right in the user's IDE, if it is currently open.
+
+For more details, please follow the [Embeddable Content](https://plugins.jetbrains.com/docs/marketplace/embeddable-content.html) section in the JetBrains Marketplace doc.
+
+
+## Readme Badges
+
+Adding badges to the README files to the open-source projects is common for providing additional information to the users.
+
+Below there are listed a few ones related to the IntelliJ SDK and plugins development provided by [shields.io](https://shields.io) and [espend.de](https://www.espend.de):
+
+> **NOTE** The following code snippets contain `:pluginId` and `:packageName` placeholders.
+>
+> `:pluginId` can be obtained from your plugin page URL, like: `https://plugins.jetbrains.com/plugin/6954-kotlin` - in this case, it's `6954`.
+>
+> `:pluginId` for shields.io also accepts a string ID that can be found in *Versions* tab, like `https://plugins.jetbrains.com/plugin/6954-kotlin/versions`.
+>
+> `:packageName` for ReSharper accepts only string ID.
+
+### Downloads
+
+**IntelliJ Plugins**
+
+![Downloads](https://img.shields.io/badge/downloads-10M-brightgreen)
+```
+![Downloads](https://img.shields.io/jetbrains/plugin/d/:pluginId)
+```
+
+![Downloads](https://img.shields.io/badge/downloads-10M-blue)
+```
+![Downloads](http://phpstorm.espend.de/badge/:pluginId/downloads)
+```
+
+![Downloads Last Month](https://img.shields.io/badge/downloads-10%20k%20last%20month-blue)
+```
+![Downloads Last Month](http://phpstorm.espend.de/badge/:pluginId/last-month)
+```
+
+**ReSharper Plugins**
+
+![Downloads](https://img.shields.io/badge/downloads-90k-brightgreen)
+```
+![Downloads](https://img.shields.io/resharper/dt/:packageName)
+```
+
+
+### Rating
+
+**IntelliJ Plugin Numeric Rating**
+
+![Rating](https://img.shields.io/badge/rating-4.5%2F5-brightgreen)
+```
+![Rating](https://img.shields.io/jetbrains/plugin/r/rating/:pluginId)
+```
+
+**IntelliJ Plugin Stars Rating**
+
+![Rating](https://img.shields.io/badge/rating-%E2%98%85%E2%98%85%E2%98%85%E2%98%85%C2%BD-brightgreen)
+```
+![Rating](https://img.shields.io/jetbrains/plugin/r/stars/:pluginId)
+```
+
+
+### Version
+
+**IntelliJ Plugins**
+
+![Version](https://img.shields.io/badge/jetbrains%20plugin-v1.7-blue)
+```
+![Version](https://img.shields.io/jetbrains/plugin/v/:pluginId)
+```
+
+![Version](https://img.shields.io/badge/version-v1.7-569AC7)
+```
+![Version](http://phpstorm.espend.de/badge/:pluginId/version)
+```
+
+**ReSharper Plugins**
+
+![Version](https://img.shields.io/badge/resharper-v2017.2.0-blue)
+```
+![Version](https://img.shields.io/resharper/v/:packageName)
+```
+
+**ReSharper Plugins (incl. pre-releases)**
+
+![Version](https://img.shields.io/badge/resharper-v2017.3.0--pre0001-yellow)
+```
+![Version](https://img.shields.io/resharper/v/:packageName?include_prereleases)
+```
+
+
+### Other Badges
+
+**GitHub Actions Workflow**
+
+![Build](https://github.com/JetBrains/intellij-sdk-docs/workflows/Build/badge.svg)
+```
+![Build](https://github.com/USERNAME/REPOSITORY_NAME/workflows/WORKFLOW_NAME/badge.svg)
+```
+
+**JetBrains IntelliJ Platform SDK Docs**
+
+[![JetBrains IntelliJ Platform SDK Docs](https://jb.gg/badges/docs.svg)](http://www.jetbrains.org/intellij/sdk/docs)
+```
+[![JetBrains IntelliJ Platform SDK Docs](https://jb.gg/badges/docs.svg)](http://www.jetbrains.org/intellij/sdk/docs)
+```
+
+**JetBrains Platform Slack**
+
+[![Slack](https://img.shields.io/badge/Slack-%23intellij--platform-blue)](https://plugins.jetbrains.com/slack)
+```
+[![Slack](https://img.shields.io/badge/Slack-%23intellij--platform-blue)](https://plugins.jetbrains.com/slack)
+```
+
+**@JBPlatform Twitter**
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/JBPlatform?style=flat)](https://twitter.com/JBPlatform)
+```
+[![Twitter Follow](https://img.shields.io/twitter/follow/JBPlatform?style=flat)](https://twitter.com/JBPlatform)
+```

appendix/resources/useful_links.md

@@ -29,4 +29,4 @@ The following links represent useful resources for working with the _IntelliJ Pl
 * [How We Built Comma, the Raku IDE, on the IntelliJ Platform](https://blog.jetbrains.com/platform/2020/01/webinar-recording-how-we-built-comma-the-raku-ide-on-the-intellij-platform/) Jonathan Worthington, 2020
 * [Building IntelliJ IDEA plugins in Scala](https://www.youtube.com/watch?v=IPO-cY_giNA) Igal Tabachnik, 2020
 * [Live Development of a PyCharm Plugin](https://blog.jetbrains.com/pycharm/2019/01/webinar-recording-live-development-of-a-pycharm-plugin-with-joachim-ansorg/) Joachim Ansorg, 2019
-* [Build Developer Tools On Top of IntelliJ Platform](https://www.youtube.com/watch?v=vQDzjGzkPFc) Dmitry Jemerov, 2013
+* [Build Developer Tools On Top of IntelliJ Platform](https://www.youtube.com/watch?v=vQDzjGzkPFc) Dmitry Jemerov, 2013

intro/welcome.md

@@ -20,6 +20,7 @@ Welcome to the _IntelliJ Platform_ SDK - the primary source of documentation for
 * [**Getting Help**](getting_help.md)
 * [**Creating Your First Plugin**](/basics/getting_started.md)
 * [**Useful Links**](/appendix/resources/useful_links.md)
+* [**Marketing**](/appendix/resources/marketing.md)
 
 ## Updates