Skip to content
CookCalcs

Editorial Policy & Methodology

CookCalcs is a utility site that applies mathematical formulas to published reference data. This page explains how calculators are developed, how ingredient data is sourced, and how content quality is maintained.

How Calculators Are Developed

Every calculator on CookCalcs follows a structured development process with multiple verification stages. The process is designed to catch errors before publication and to ensure that every tool produces reliable, source-backed results.

Stage 1: Formula Research and Citation

The development of each calculator begins with identifying the underlying formula or conversion method. Formulas are sourced from established culinary references, food science literature, or standards bodies. The specific source is recorded in a formulaSourcefield in the calculator's data file and is displayed on the calculator page. Every source is verified to exist and to cover the claimed formula before publication.

Stage 2: Implementation and Testing

The formula is implemented in TypeScript and wrapped in a dedicated calculation function. Each calculator is required to have at minimum one primary scenario test (covering all outputs with verified values) and one variant or edge case test. Test values are derived from the cited formula source or from independent cross-reference, not from the calculator's own output. A calculator that has not passed its known-value tests is not published.

Stage 3: Worked Example Verification

Every calculator includes at least two worked examples — realistic scenarios that walk through the calculation step by step. Each worked example has four parts: a context that sets the scene, the calculation with actual numbers and intermediate values, an interpretation of what the result means in practical terms, and an actionable takeaway. Every worked example's input values are run through the calculator's implementation, and all intermediate and final values in the narrative are verified to match.

Stage 4: Source Link Verification

All external source links cited on a calculator page are checked for availability before publication. Broken links are replaced with current alternatives. Formula sources are web-searched to confirm they exist and cover the claimed formula. This verification is repeated during periodic content reviews.

Ingredient Density Database

The core data asset behind CookCalcs's baking converters is a curated database of ingredient densities. This section describes how density values are sourced and what limitations apply.

Data Sources

Ingredient density values are drawn from three sources, listed in order of preference:

  1. FAO Density Database v2.0 — the primary reference for ingredient weight-per-volume measurements, compiled from international food composition data.
  2. USDA FoodData Central — the US government's food composition database, used for ingredients not covered by the FAO database or as a cross-reference.
  3. Manufacturer data — used only when FAO and USDA values are unavailable for a specific product (e.g., proprietary flour blends), and cited with the manufacturer name and product reference.

Each ingredient entry records which source provided the data and includes a specific document or page reference. The source is displayed alongside the ingredient in the converter interface.

What the Database Records

For each ingredient, the database stores:

  • Weight per US cup (236.59 mL)
  • Weight per metric cup (250 mL)
  • Weight per tablespoon and teaspoon
  • Density in grams per millilitre
  • Alternative names and regional aliases
  • Preparation notes where relevant (e.g., “packed”, “sifted”, “melted”)

Regional Measurement Differences

Cup measurements vary by region. A US cup is 236.59 mL, a metric cup (used in Australia and some international recipes) is 250 mL, and a UK imperial cup is 284 mL. CookCalcsuses the US cup as the primary unit and provides a metric cup toggle on conversion calculators. Imperial cups are not supported because they are rarely used in modern recipes. Where cup size affects a calculation, the distinction is noted in the calculator's educational content.

Content Quality Standards

Every content page on CookCalcs meets minimum word count thresholds based on content type. Calculator pages with high complexity require at least 1,200 words of educational content; medium-complexity tools require 800 words; simpler converters require 600 words. Blog posts require a minimum of 1,500 words for standard articles and 2,500 for cornerstone content.

Structural variety is enforced across pages within the same pillar. No two consecutive calculator pages in a pillar use the same heading pattern, section order, or structural approach. Each page must include at least one distinctive structural device such as a comparison table, a decision tree, a troubleshooting flow, historical context, or a regional variation comparison.

Content Review Process

Every content page has a contentReviewDate field that records when the content was last verified for accuracy. Reviews include re-checking formula sources, re-verifying worked example arithmetic, testing source links, and updating any cost data that has an expiry date. Cost data (where applicable) is valid for six months from the verification date before mandatory re-review.

Content that meaningfully changes receives an updated lastUpdated date, which is displayed on the page and included in the structured data (JSON-LD dateModified). Minor corrections (typos, formatting) do not trigger a date change.

Limitations and Accuracy Boundaries

All calculator results are approximations. The primary sources of variance are:

  • Ingredient variability: The same ingredient from different brands can have different densities. A cup of King Arthur all-purpose flour may weigh differently from a cup of a supermarket own-brand flour.
  • Measurement technique: The weight of a cup of flour varies significantly depending on whether it is spooned and levelled, dipped and swept, or scooped directly from the bag. The database values assume the spooned-and-levelled method unless noted otherwise.
  • Environmental factors: Humidity, altitude, and ambient temperature affect both ingredient density and cooking outcomes. The database values represent standard conditions.
  • Rounding: Volume results are rounded to cooking-friendly fractions (1/8, 1/4, 1/3, 1/2, 2/3, 3/4). These rounded values are close enough for practical cooking but are not exact.

For the most accurate baking results, using a digital kitchen scale to measure ingredients by weight is consistently more reliable than volume measurements, regardless of which conversion tool is used.

Reporting Errors

If you find an error in a calculation, a broken source link, an incorrect density value, or any other inaccuracy, please report it via the feedback form. Include the calculator name and, if possible, the specific value or step that appears incorrect. Reports are reviewed and, where confirmed, corrected with an updated lastUpdated date.