Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

📝 Docs: Standardize slogan as something without "simple" #5065

Open
3 tasks done
JoshuaKGoldberg opened this issue Dec 28, 2023 · 5 comments · May be fixed by #5246
Open
3 tasks done

📝 Docs: Standardize slogan as something without "simple" #5065

JoshuaKGoldberg opened this issue Dec 28, 2023 · 5 comments · May be fixed by #5246
Assignees
Labels
area: documentation anything involving docs or mochajs.org type: feature enhancement proposal

Comments

@JoshuaKGoldberg
Copy link
Member

Documentation Request Checklist

Overview

Words like "easy" and "simple" are often used in writing to convey that something doesn't require extra complications or tooling. But they also mean in English that something should be literally "easy" or "simple" - which often isn't the case for devs new to a technology. It's good writing practice to use more precise adjectives instead.

Right now the Mocha slogan is "Simple, flexible, fun JavaScript test framework for Node.js & The Browser":

<p align="center">☕️ Simple, flexible, fun JavaScript test framework for Node.js & The Browser ☕️</p>

Let's use a slogan that doesn't say "simple". Maybe just "flexible and fun" is enough?

Additional Info

https://justsimply.dev is a good resource that goes into more detail and has examples.

@JoshuaKGoldberg JoshuaKGoldberg added type: feature enhancement proposal area: documentation anything involving docs or mochajs.org labels Dec 28, 2023
@JoshuaKGoldberg JoshuaKGoldberg added the status: in triage a maintainer should (re-)triage (review) this issue label Feb 9, 2024
@JoshuaKGoldberg
Copy link
Member Author

Food for thought, folks occasionally express a need for cross-JS-runtime tests. Example from https://twitter.com/_nicojs/status/1762508703863894472:

Nicholas C. Zakas @slicknet
What I want: To write JavaScript tests once and be able to run them across Node.js, Bun, and Deno.
Problem: Bun and Deno have built-in test runners you have to import from to run tests. I use Mocha. This doesn't work.
Solution: ???

@voxpelli
Copy link
Member

Maybe:

Classic reliable spec-style JavaScript test framework for Node.js & The Browser ☕️

Or more cheeky:

The classic spec-style JavaScript test framework for Node.js & The Browser ☕️

Simple, flexible, fun were all mantras in the beginning, now I think the focus should be more on being a reliable, trusted, no-thrills classic spec-style test runner – to maintain what works, not to push the boundaries.

@JoshuaKGoldberg
Copy link
Member Author

JoshuaKGoldberg commented Jul 20, 2024

I like the idea on focusing on reliable and trusted. Maybe both of those can become part of the mantra?

"spec-style" is -1 from me because many devs these don't know or care about assertion styles. This isn't a phrase many newer devs know of.

How about:

The classic reliable and trusted JavaScript test framework for Node.js & the Browser ☕

Or with commas:

The classic, reliable, and trusted JavaScript test framework for Node.js & the Browser ☕

@JoshuaKGoldberg
Copy link
Member Author

JoshuaKGoldberg commented Oct 8, 2024

Coming back to this, my vote is on:

The classic, reliable, trusted JavaScript test framework for Node.js & the Browser. ☕

cc @mochajs/maintenance-crew

Edit: oh, and once Bun & Deno are supported per #5108 down the road:

The classic, cross-runtime, reliable JavaScript test framework for browsers, Node.js, and more. ☕

@JoshuaKGoldberg JoshuaKGoldberg self-assigned this Oct 8, 2024
@JoshuaKGoldberg JoshuaKGoldberg removed the status: in triage a maintainer should (re-)triage (review) this issue label Oct 8, 2024
@JoshuaKGoldberg JoshuaKGoldberg linked a pull request Nov 6, 2024 that will close this issue
15 tasks
@mark-wiemer
Copy link
Contributor

Maybe instead of cross-runtime, you could use runtime-agnostic? Though I guess agnostic is more syllables!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: documentation anything involving docs or mochajs.org type: feature enhancement proposal
Projects
Status: In Progress
Development

Successfully merging a pull request may close this issue.

3 participants