Open working brief / Edition 04
Build the next
study with care.
For authors, designers and AI agents contributing to The Edible Atlas. These are the project’s public editorial expectations, not permission to publish or change its governance.
The brief.
Help a curious person understand a food, tea or named material. Begin with particular cultures and uses, explain the biology and nourishment, then give a practical judgement about including it and what deserves care.
Read the founding study- Recover the purpose. Serve adults and mixed-age families. Keep the learning experience useful without a purchase or sign-up.
- Research the actual food. Confirm the scientific name, edible part and preparation. For the deeper edition, use documented food traditions, botany, agricultural science, original food experiments and preparation-specific composition data. Medical-industry and clinicians’ benefit summaries are outside its explanatory brief; retain necessary care notices separately.
- Write about the food. Researcher, institution and producer names belong in the numbered end references. The main text explains the topic in natural language, rather than summarising who published what. Do not invent a cultural belief or imply every tradition has been proved.
- Preserve the units. Store nutrient values per 100 g with their dataset identifier. Scale them visibly for the selected portion. Do not turn that portion into a recommended medical dose.
- Separate evidence types. A community account, food-composition measurement, laboratory experiment and editorial interpretation are different. Name limits and uncertainty where a reader encounters the claim.
- Draw honestly. Label schematic illustrations. Show meaningful structures and avoid visual details that suggest false anatomical precision.
- Make interaction teach. Every control should reveal something. Provide a static reading route and visible feedback. Explain errors without blaming the reader.
- Verify the rendered result. Exercise the actual page across sizes and input methods. Test calculations, transitions, sources, print and reading without JavaScript.
- Record the handoff truthfully. Distinguish local checks, editorial approval and publication. A local build is not evidence that a live site has changed.
A study’s minimum ingredients
Identity. Explanation.
Evidence. Experience.
The food record
Stable identifier and aliases, source organism or material, part and preparation, applicable composition basis, claim sources and review date.
The learning experience
A useful visual or comparison, readable explanations, practical context and a path into further learning. Show only the modules supported for this material.
The acceptance record
What was checked, what failed, what changed, what still needs review and whether publication has actually occurred.
Follow the material.
Keep its context.
A source organism, a material and a preparation answer different questions. Papaya fruit, leaf and seed share a plant; they do not share a nutrition table or a safety conclusion. Collections help readers compare them without merging their identities.
Publish the material knowledge. Keep personal observations, family context and recovered conversation records in a separate private layer. A historical question does not establish a present preference.
Record the observer and evidence type in the source metadata and end references: sensory description, analytical measurement, traditional account, human research, laboratory research or safety notice. A published review must not be labelled an original experiment. Traditional terms belong to their named source and preparation; they are not interchangeable with biomedical mechanisms.
Let the material determine the page. Ordinary food begins in the kitchen. A consequential medicinal caution comes before use. A tea guide separates processing from origin, cultivar and batch. Unknown products wait for their actual label.
Preserve existing licensed photographs when adding chapters. Use a correctly identified and licensed image when one is available, with credit and scope at the end. Inspect the actual picture so its caption describes what is visible. A source-plant photograph does not authenticate a purchased powder, extract or batch.
Keep the limits
as clear as the claims.
Do not invent founder quotations, endorsements, testimonials, health outcomes or product packages. Do not promote a draft to an approved fact.
Do not collect children’s personal information, add tracking, purchase services, change access or publish without the project owner’s explicit scope.
Use British English. Call ginger in hot water an infusion. Reserve “tea” for Camellia sinensis.
Return to the editorial standards