michaelpick
commented
2 years ago @vinimotaa – sure! I'll work up a few options and aim to bring some consistency to the approach. I'll aim to drop those here on Monday if not sooner.
Closed vinimotaa closed 2 years ago
michaelpick
commented
2 years ago @vinimotaa – sure! I'll work up a few options and aim to bring some consistency to the approach. I'll aim to drop those here on Monday if not sooner.
vinimotaa
commented
2 years ago Thanks a lot @michaelpick!
michaelpick
commented
2 years ago Hey @vinimotaa 👋
I took a look at these and the related titles and labels in #65574.
To help us get to the consistency you mentioned, I came up with two different patterns that could be pretty easily captured in a light-weight Marketplace styleguide:
why > what > how patternIn this variation the subheadings run a little longer, the better to lead with an action-focused 'why' (I should care) and 'what' (it is), before pivoting into an explicit 'how' (it works). The benefit here is additional context – I am given:
This is at the expense of brevity.
The pattern goes like this:
{Outcome focused verb} {feature and benefit} by {gerund (-ing)} {concrete actions}
An illustrative example: 'Learn the piano and impress your friends by following these bite-sized interactive lessons.'
Ecommerce & Business Turn your site into a store by adding powerful, flexible ecommerce features.
Booking & Scheduling {{Note: research suggests it's better to use 'and' than ampersand for readability}} Turn site visitors into customers by adding advanced bookings and schedule management tools to your site.
Analytics Understand what's working and what isn't by digging deep into site visitor and performance insights.
Design Finesse every detail of your site's design by adding advanced customization tools to your site.
Search Engine Optimization Increase and maintain search visibility for your site by optimizing your metadata and content
Events Calendar Build buzz and attention by displaying and managing an events calendar on your site. ((Note: is this the intended purpose, or is it more of an internal calendar?))
Social Amplify the visibility of your content by connecting to your audience across social platforms.
Email Build a direct connection to your site visitors by capturing, integrating, and managing your email list. ((Note: is this the full scope of email plugins?))
Security Get added peace of mind by enhancing your site's security features.
Finance & Payments Make collecting, managing, and reporting on payments a breeze by adding these seamless tools and integrations.
Shipping & Delivery {{See previous note about ampersands. Better to use 'and'}} Create a seamless ordering experience for your customers by integrating and managing product shipping and delivery.
Marketing Make your site or business stand out by amplifying the reach and visibility of your projects and products.
Photo & Video {{Ampersand warning}} Elevate your site's visuals by creating, editing, and managing video and images with precision and flexibility.
CRM & Live Chat Build and maintain stronger relationships with your customers by putting advanced customer service tools to work for your business.
Crowdfunding Raise funding for your product, cause, or project by integrating crowdfunding tools directly into your site.
Learning Management Systems Teach, track, and promote courses and educational content by seamlessly integrating LMS tools into your site.
Widgets Take deeper control of your site's widgets by putting advanced customization and integrations to work.
Posts & Posting Take your publishing goals further by using advanced post content, planning, and scheduling tools.
Note: overall, I find this pattern a little bloated and somewhat awkward in some situations, but I'm open to being wrong. My gut says that the second pattern strikes a better balance. See what you think!
what/why patternIn this variation – my preference – our supporting subheads aim for a balance of:
This gives us greater concision and readability at the expense of a more explicit 'how'
The pattern:
{Outcome focused verb} {condensed feature/benefit/action}
Example: Bake an amazing cake for your chocolate-obsessed family
Ecommerce & Business Turn your site into a powerful online store.
((Style note: I don't think we need to explicitly call out WordPress or WordPress.com except where it makes a critical difference, such as 'Recommended by the WordPress.com team'. Thus, 'your site' replaces 'Your WordPress.com site'}}
Booking & Scheduling {{Note: research suggests it's better to use 'and' than ampersand for readability}} Take bookings and manage your availability right from your site.
Analytics Go deeper and learn faster with site visitor and performance insights.
Design Finesse {{every detail of)) your site's design with advanced customization tools.
Search Engine Optimization Fine-tune your site's content and metadata for search engine success.
Events Calendar Build buzz and set the scene with an on-site events calendar. ((Note: is this the intended purpose, or is it more of an internal calendar?))
Social Connect to your audience and amplify your content on social.
Email Forge a direct connection with your readers through email. ((Note: is this the full scope of email plugins?))
Security Take advanced control of your site's security.
Finance & Payments
Shipping & Delivery {{See previous note about ampersands. Better to use 'and'}} Create a seamless shipping experience with advanced delivery integrations.
Marketing
Photo & Video {{Ampersand warning}} Create, share, edit, and manage beautiful images and video {with added precision and flexibility.}
CRM & Live Chat
Crowdfunding Launch and run crowdfunding campaigns right from your site.
Learning Management Systems Create, run, and manage interactive courses and learning experiences.
Widgets Take widgets to the next level with advanced control and customization.
Posts & Posting Unlock advanced content planning, publishing, and scheduling features.
Happy to iterate on either pattern or propose alternatives.
I'll write up a few quick style inconsistencies and potential solutions in a separate comment.
michaelpick
commented
2 years ago We aren't consistently applying casing to headings and subheadings across the page. While it's open to being evolved, our style guide recommends the use of sentence casing for headings. Sentence case increases readability according to research, so I reckon we should implement this here unless there are any strong objections.
There are also a number of readability advantages to using 'and' rather than an ampersand. I'd recommend that we replace the 'X & Y' titles to 'X and Y'
We quite often drop extraneous 'WordPress' and 'WordPress.com' references into explanatory sentences. We should only really do this where there's a strong case for it, i.e.:
In other cases, we can achieve better concision and clarity – and avoid sounding too self-congratulatory – by cutting the superfluous reference. For example:
'Turn your WordPress.com site into a powerful store' could more concisely be expressed as 'Turn your site into a powerful store', with the fact that the user is on a WordPress.com page, reading about WordPress.com features, in a marketplace where they can only purchase plugins to use with WordPress.com somewhat filling in the blanks for us.
michaelpick
commented
2 years ago I've combined the above style notes with my personal favorite lines. Totally happy to use any of the others, or to iterate on any that don't quite hit the mark. I've also commented a couple for clarification of scope.
Turn your site into a powerful online store.
Take bookings and manage your availability right from your site.
Go deeper and learn faster with site visitor and performance insights.
Finesse your site's design with advanced customization tools.
Fine-tune your site's content and metadata for search engine success.
Build buzz and set the scene with an on-site events calendar. ((Note: is this the intended purpose, or is it more of an internal calendar? This also feels like a slightly uncannily specific category, maybe?))
Connect to your audience and amplify your content on social.
Forge a direct connection with your readers through email. ((Note: is this the full scope of email plugins?))
Take advanced control of your site's security.
Sell products, subscriptions, and services while keeping on top of every transaction.
Create a seamless shipping experience with advanced delivery integrations.
Bring in new business and shine a spotlight on your projects or products.
Create, share, edit, and manage beautiful images and video {with added precision and flexibility.}
Create stand-out customer service experiences for your site visitors.
Launch and run crowdfunding campaigns right from your site.
Create, run, and manage interactive courses and learning experiences.
Take widgets to the next level with advanced control and customization.
Unlock advanced content planning, publishing, and scheduling features.
vinimotaa
commented
2 years ago Hey @michaelpick, great work here mate. I loved the approach and consistency!
I'll work with the team to implement this ASAP.
Thank you a lot!
vinimotaa
commented
2 years ago @allilevine hey A.! Tagging you on this thread - @michaelpick helped us to put together the categories description for the Marketplace.
allilevine
commented
2 years ago @allilevine not sure if we should merge this thread with #67239?
@vinimotaa Can we keep this issue focused on the copy, and #67239 focused on any design (e.g. CSS) changes we need to make? Or do they need to happen simultaneously?
vinimotaa
commented
2 years ago @allilevine sure, we keep them as is :)
lsl
commented
2 years ago ((Note: is this the intended purpose, or is it more of an internal calendar? This also feels like a slightly uncannily specific category, maybe?))
Not sure about the origin of this but it is most likely the intended purpose for things like Events Calendar Pro being added soon. Definitely not an internal calendar, that would be a different category, "editorial [publishing] calendar" maybe - there are plugins for that too.
((Note: is this the full scope of email plugins?))
Anything tagged with "email". Suspected the main usecase for this category would be for building email lists, email newsletter signups, sending newsletters, etc.
Finance & Payments Sell products, subscriptions, and services while keeping on top of every transaction. ALT: Collect payments and keep on top of every transaction with advanced payment integrations.
Would prefer the alternate here, ecommerce / woo covers selling products.
Marketing Bring in new business and shine a spotlight on your projects or products. ALT: Amplify the reach and visibility of your site or business.
Prefer the alt here too. Shining a spotlight vs amplify reach, I'd prefer to amplify reach.
I'm creating this ticket for us to centralize, align and keep updating the Category descriptions (labels) as we get them.
These are the ones we already have:
Ecommerce & Business Everything you need to turn your WordPress site into a powerful online store.
Booking & Scheduling Add a fully functional booking system to your site.
Analytics Tools to help you better understand your site's visitors and performance.
Design A collection of tools that will give you more control over the design of your site.
We still need a description for these:
Search Engine Optimization Events Calendar Social Email Security Finance & Payments Shipping & Delivery Marketing Photo & Video CRM & Live Chat Crowdfunding Learning Management Systems Widgets Posts & Posting
@michaelpick any suggestions on these other categories? Another thing to consider is how to keep them consistent with each other.
Some initial descriptions that came from @SaxonF some time ago; https://github.com/Automattic/wp-calypso/issues/64055#issuecomment-1140626607