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鈥檒l 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 · 1 comment
Open
3 tasks done
Labels
area: documentation anything involving docs or mochajs.org status: in triage a maintainer should (re-)triage (review) this issue 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: ???

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 status: in triage a maintainer should (re-)triage (review) this issue type: feature enhancement proposal
Projects
Status: Backlog
Development

No branches or pull requests

1 participant