Skip to content
This repository was archived by the owner on Nov 19, 2024. It is now read-only.

Commit ed1dfe3

Browse files
Apply suggestions from code review
Added all suggestions to a batch. Tiny typo on line 72 "thr" instead of "the" Co-authored-by: Shrie Spangler <sspangler@magento.com>
1 parent af95f3c commit ed1dfe3

File tree

1 file changed

+30
-33
lines changed

1 file changed

+30
-33
lines changed

src/marketplace/sellers/marketing-review-guidelines.md

Lines changed: 30 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -11,72 +11,69 @@ We have made an investment in the presentation of Magento Marketplace. In return
1111

1212
* Your product must have a professional presentation with clear descriptions, images, and screenshots.
1313
* The product name must indicate the purpose of the extension or theme.
14-
* The product description should be well-written, and provide an overview of the features and benefits.
14+
* The product description must be well-written and provide an overview of the features and benefits.
1515
* Use only high-quality screenshots, images, and video to accompany the listing.
1616

1717
## Extension title
1818

1919
The extension title should fulfill the following guidelines:
2020

21-
* Choose a title that is descriptive and concise. The extension title can be up to five words long and must be in English.
21+
* Choose a title that is descriptive and concise. The extension title can be up to five words in length and must be in English.
2222
* Do not include the version number, developer name, or any reference to Magento in the title.
23-
* Do not use _"Magento"_ or _"M2"_.
23+
* Do not use _Magento_ or _M2_.
2424
* Do not include the words _"Extension"_, _"Module"_ or _"Plugin"_.
25-
* However, the words, _"Connector"_ and _"Integration"_ can be used if applicable.
26-
* Use _"&"_, instead of _"And"_. (_"Order & Save"_, not _"Order and Save"_)
27-
* First letter of each word capitalized. (_"Mass Order Export"_, not _"Mass order export"_)
28-
* Do not use All Caps.
29-
* No punctuation unless it’s part of the actual company name. (_"InstantSearch+"_, _"Yahoo!"_)
25+
* The words, _Connector_ and _Integration_ can be used if applicable.
26+
* Use _&_ instead of _And_, such as in _Order & Save_ (not _Order and Save_).
27+
* Capitalize the first letter of each word, such as _Mass Order Export_ (not _Mass order export_).
28+
* Do not use all capital letters.
29+
* Do not use punctuation unless it’s part of the actual company name. (_"InstantSearch+"_, _"Yahoo!"_)
3030
* _"/"_ and _"-"_ are acceptable in certain circumstances. (_"Two-Factor"_, _"Import / Export"_)
31-
* Not formatted like package name with underscores between words. (_"Extension_Title"_)
32-
* No Developer Name in the title. (_"Print Order PDF"_, not _"Fooman Print Order PDF"_)
33-
* EXCEPTION: Integration. If the developer is the same name as the service being integrated. For instance, if Visa submits an integration, they SHOULD include _"Visa"_ since it’s the name of the service.
34-
* Allowed to add Magento version _"(2.3)"_ if two separate extensions must be on the store.
31+
* Do not add underscores between words in the package name, such as (_Extension_Title_).
32+
* Do not use the Developer Name in the title, such as _Print Order PDF_ (not _Fooman Print Order PDF_).
33+
* If the developer is the same name as the service being integrated, you may use the develop name in the title. For instance, if Visa submits an integration, they should include _Visa_ since it’s the name of the service.
34+
* You can add the Magento version, such as 2.3, if two separate extensions must be on the store.
3535

3636
## Extension icon
3737

3838
The extension icon should fulfill the following guidelines:
3939

40-
* The extension icon must reflect the extension with words and/or images.
41-
Text is not required, but an extension title can be added to the icon.
42-
* If the extension title added to the icon, it should exactly match the extension title.
40+
* The extension icon must reflect the extension with words and/or images. Text is not required, but an extension title can be added to the icon.
41+
* If the extension title is added to the icon, it should exactly match the extension title.
4342
* No slogans or features.
44-
* Do not use _"Magento"_ or _"M2"_.
45-
* Do not use Magento Logo.
46-
* Do not use the developer logo here instead of the extension icon.
43+
* Do not use _Magento_ or _M2_.
44+
* Do not use the Magento Logo.
45+
* Do not use the developer logo instead of the extension icon.
4746
* Do not specify the extension version.
48-
* Limited use of _"Pro"_.
49-
* Less is more. Tiny, intricate details are not easy to make out, try to avoid them.
50-
* For the 1st party companies, we recommend using the same image, as you are using on Twitter, LinkedIn, etc.
47+
* Limit the use of the word _Pro_.
48+
* Less is more. Avoid minute detail that is hard to understand.
49+
* For 1st party companies, we recommend using the same image you use on Twitter, LinkedIn, etc.
5150

5251
## Long description
5352

5453
For guides and examples of long descriptions, see [Product Descriptions]({{ site.baseurl }}/marketplace/sellers/product-descriptions.html).
5554

56-
## User guide, reference manual or installation guide
55+
## User guide, reference manual, or installation guide
5756

5857
Extension documentation should fulfill the following guidelines:
5958

60-
* Extension documentation must cover all features of the extension.
61-
* Extension documentation must not direct users to make purchases on sites other than Marketplace.
62-
* If an extension title added into documentation, it must not include _"Magento"_ in it. Use _"For Magento"_ after the title, if needed.
59+
* Must cover all features of the extension.
60+
* Must not direct users to make purchases on sites other than Marketplace.
61+
* If an extension title is added into the documentation, it must not include _Magento_. Use _For Magento_ after the title if needed.
6362
* Use of the Magento logo is prohibited. To learn more, see our [branding guidelines]({{ site.baseurl }}/marketplace/sellers/branding.html).
6463
* Partners can use their Magento partner badge.
65-
* At least one piece of uploaded documentation must be in English
64+
* At least one piece of uploaded documentation must be in English.
6665
* Do not upload duplicates of the documents.
6766

6867
## Pricing: Provide clear pricing information
6968

7069
The price of your extension is included as part of the marketing information. To learn more, see [Enter Pricing Information]({{ site.baseurl }}/marketplace/sellers/submit-for-marketing-review.html).
7170

72-
* Items listed on Magento Marketplace can be offered for free, or sold as a commercial products.
73-
* The price of items offered for sale on Magento Marketplace can range anywhere from $25.00 to $999,999.00, and must reflect fair market value.
71+
* Items listed on thr Magento Marketplace can be offered for free or sold as commercial products.
72+
* The price of items offered for sale on the Magento Marketplace can range anywhere from $25.00 to $999,999.00, and must reflect fair market value.
7473
* All purchases are paid for in US currency.
75-
* Items sold on Magento Marketplace are subject to a revenue sharing fee that is paid by the developer.
76-
* Any additional fees or subscription pricing — including fees charged by a third-party company for integrated services — must be included in the opening paragraph of the Long Description with bold formatting.
77-
* Magento recommends the following extension pricing:<br />
78-
Open Source - $99<br />
79-
Commerce - $199
74+
* Items sold on the Magento Marketplace are subject to a revenue-sharing fee that is paid by the developer.
75+
* Any additional fees or subscription pricing—including fees charged by a third-party company for integrated services—must be included in the opening paragraph of the Long Description with bold formatting.
76+
* Magento recommends $99 for Open Source and $199 for Commerce extension pricing.
8077

8178
## Content: Complete the product profile
8279

0 commit comments

Comments
 (0)