Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions site/scripts/percentage-worked-examples.test.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
import test from "node:test";
import assert from "node:assert/strict";
import { readFileSync } from "node:fs";

const read = (locale) => JSON.parse(readFileSync(
new URL(`../src/tools/percentage-calculator/messages/${locale}.json`, import.meta.url), "utf8"
));
const en = read("en");
const ja = read("ja");

test("english and Japanese percentage calculator articles both contain four useful sections", () => {
assert.equal(en.article.sections.length, 4);
assert.equal(ja.article.sections.length, 4);
assert.ok(en.article.sections.every((s) => s.heading && s.paragraphs.length >= 2));
assert.ok(en.metaDescription.length <= 160);
});

test("worked example results agree with percentage math", () => {
assert.equal(3480 * 0.15, 522);
assert.equal(3480 - (3480 * 0.15), 2958);
assert.equal((42 / 56) * 100, 75);
assert.equal(((1380 - 1150) / 1150) * 100, 20);
assert.ok(Math.abs(((1150 - 1380) / 1380) * 100 - (-16.6667)) < 0.01);
});

test("worked examples contain correct values and matching tool modes", () => {
const copy = en.article.sections.at(-1).paragraphs.join(" ");
for (const s of ["3,480", "522", "2,958", "42", "56", "75%", "1,150", "1,380", "20%", "16.67%", "Subtract X% from Y", "Change from A to B"]) {
assert.ok(copy.includes(s), `English worked example missing ${s}`);
}
assert.match(ja.article.sections.at(-1).heading, /計算例/);
});

test("existing English FAQ, title and search intent remain unchanged", () => {
assert.match(en.title, /Percentage Calculator/);
assert.ok(en.faq.length >= 6);
assert.ok(en.article.howTo.length >= 4);
});
76 changes: 63 additions & 13 deletions site/src/tools/percentage-calculator/messages/en.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,13 @@
"shortDescription": "Three percentage calculators in one: 'X% of Y', 'X is what % of Y', and percentage change between two values.",
"description": "Pick a mode, enter two numbers, and get the answer instantly. Handles 'percent of', 'what percent', and 'percent change' — the three operations behind almost every percentage question.",
"metaDescription": "Free percentage calculator: find X% of Y, what percent one number is of another, or the percent change between two values. Instant, in-browser.",
"keywords": ["percentage calculator", "percent of", "percentage change", "discount calculator", "increase decrease percent"],
"keywords": [
"percentage calculator",
"percent of",
"percentage change",
"discount calculator",
"increase decrease percent"
],
"empty": "Enter both values to see the result.",
"mode": {
"pct_of": {
Expand Down Expand Up @@ -59,23 +65,67 @@
"Percentage points vs percent. If a poll moves from 40% to 42%, that's a change of 2 percentage points but a 5% relative increase. The calculator's 'percent change' mode reports the relative change.",
"Discount stacking. A '20% off' coupon applied after a '20% off' sale is 36% off the original (0.8 × 0.8 = 0.64), not 40%. Run the calculator twice in 'percent of' mode to see this directly."
]
},
{
"heading": "Worked examples: discounts, grades and month-over-month change",
"paragraphs": [
"A 15% discount on a 3,480 purchase: 3,480 × 0.15 = 522 off, so the final price is 3,480 − 522 = 2,958. Choose “X% of Y”, enter X = 15 and Y = 3480 to see the discount amount; use “Subtract X% from Y” to see the final price directly.",
"42 correct answers out of 56 questions: 42 ÷ 56 × 100 = 75%. Choose “X is what % of Y”, enter X = 42 (correct answers) and Y = 56 (total questions).",
"A monthly bill rises from 1,150 to 1,380: (1,380 − 1,150) ÷ 1,150 × 100 = 20% increase. Choose “Change from A to B”, enter A = 1150 and B = 1380. If the bill falls from 1,380 to 1,150 instead, the change is about −16.67%; switching the old and new values changes the denominator."
]
}
],
"howTo": [
{ "name": "Pick a mode", "text": "Choose 'percent of', 'what percent', or 'percent change' depending on what you're trying to find." },
{ "name": "Enter the first number", "text": "The label tells you which value goes here for the chosen mode." },
{ "name": "Enter the second number", "text": "The result updates as you type." },
{ "name": "Read the answer", "text": "The result includes the appropriate unit (%, plain number) for the mode you chose." }
{
"name": "Pick a mode",
"text": "Choose 'percent of', 'what percent', or 'percent change' depending on what you're trying to find."
},
{
"name": "Enter the first number",
"text": "The label tells you which value goes here for the chosen mode."
},
{
"name": "Enter the second number",
"text": "The result updates as you type."
},
{
"name": "Read the answer",
"text": "The result includes the appropriate unit (%, plain number) for the mode you chose."
}
]
},
"faq": [
{ "q": "Is the calculation accurate to many decimals?", "a": "Yes — we use double-precision floating point and round display to four decimals. For very high-precision financial work, treat the result as approximate at the 16th significant digit." },
{ "q": "Why does percent change ask for old then new?", "a": "Because the formula divides by the old value. Swapping the two inputs flips the sign of the result." },
{ "q": "How do I calculate a discounted price?", "a": "Use 'percent of' with X = the discount percent and Y = the original price; subtract the result from the original. Or use percent-of with X = (100 − discount) and Y = price for the final price directly." },
{ "q": "How do I find percent off if I know both prices?", "a": "Use 'percent change' with A = original price and B = sale price. The negative number is your discount." },
{ "q": "What if I enter a negative number?", "a": "All three modes accept negatives. Percent change in particular is well-defined: change from −5 to 5 is −200% (the sign of the divisor flips the result)." },
{ "q": "Can I use this for tax calculations?", "a": "Yes — 'percent of' with X = tax rate and Y = pre-tax amount gives the tax. Add it to the original or use percent-of with X = (100 + tax)." },
{ "q": "Why doesn't 'increase by 50% then decrease by 50%' return the original?", "a": "Because percentages compound. 100 × 1.5 × 0.5 = 75, not 100. Run the percent-change mode end-to-end to see the net change is −25%." },
{ "q": "Does this work for grade calculations?", "a": "Yes. Use 'what percent' with X = points earned and Y = points possible to get your percentage grade." }
{
"q": "Is the calculation accurate to many decimals?",
"a": "Yes — we use double-precision floating point and round display to four decimals. For very high-precision financial work, treat the result as approximate at the 16th significant digit."
},
{
"q": "Why does percent change ask for old then new?",
"a": "Because the formula divides by the old value. Swapping the two inputs flips the sign of the result."
},
{
"q": "How do I calculate a discounted price?",
"a": "Use 'percent of' with X = the discount percent and Y = the original price; subtract the result from the original. Or use percent-of with X = (100 − discount) and Y = price for the final price directly."
},
{
"q": "How do I find percent off if I know both prices?",
"a": "Use 'percent change' with A = original price and B = sale price. The negative number is your discount."
},
{
"q": "What if I enter a negative number?",
"a": "All three modes accept negatives. Percent change in particular is well-defined: change from −5 to 5 is −200% (the sign of the divisor flips the result)."
},
{
"q": "Can I use this for tax calculations?",
"a": "Yes — 'percent of' with X = tax rate and Y = pre-tax amount gives the tax. Add it to the original or use percent-of with X = (100 + tax)."
},
{
"q": "Why doesn't 'increase by 50% then decrease by 50%' return the original?",
"a": "Because percentages compound. 100 × 1.5 × 0.5 = 75, not 100. Run the percent-change mode end-to-end to see the net change is −25%."
},
{
"q": "Does this work for grade calculations?",
"a": "Yes. Use 'what percent' with X = points earned and Y = points possible to get your percentage grade."
}
]
}
Loading