Skip to content
Closed
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
3 changes: 2 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -270,7 +270,8 @@
"icon": "book-open",
"pages": [
"guides/index",
"what-is-mintlify"
"what-is-mintlify",
"guides/cows"
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Demo page visible in production docs navigation

Medium Severity

The cow-themed demo page is added to the production docs navigation alongside real pages like "what-is-mintlify" in the Guides > Overview group, making it visible to all documentation users. Since this is explicitly a demo for customer showcases (the Tip callout says so), it likely belongs as a hidden: true page — a feature this very docs site documents — so it's accessible by direct URL for demos without appearing in the public navigation.

Additional Locations (1)
Fix in Cursor Fix in Web

]
},
{
Expand Down
91 changes: 91 additions & 0 deletions guides/cows.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: "Cows"
description: "Everything you need to know about cows for your documentation demo."
keywords: ["cows", "demo", "cattle", "livestock"]
---

<Tip>
This is a demo page used to showcase documentation capabilities to customers.
</Tip>

Cows are domesticated bovines that have been integral to human agriculture for thousands of years. This page demonstrates how Mintlify renders rich documentation content using a fun, non-technical topic.

Check warning on line 11 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L11

In general, use active voice instead of passive voice ('are domesticated').

## Breeds

Here are some popular cow breeds and their primary uses:

| Breed | Origin | Primary use |
|:------|:-------|:------------|
| Holstein | Netherlands | Dairy |
| Angus | Scotland | Beef |
| Jersey | Jersey Island | Dairy |
| Hereford | England | Beef |
| Highland | Scotland | Beef |
| Brown Swiss | Switzerland | Dairy |

## Quick facts

<CardGroup cols={2}>
<Card title="Lifespan" icon="heart">
Cows typically live 18–22 years.
</Card>
<Card title="Daily output" icon="glass-water">
A dairy cow produces around 25–30 liters of milk per day.
</Card>
<Card title="Digestion" icon="repeat">
Cows have four stomach compartments and chew their cud up to 8 hours a day.
</Card>
<Card title="Social animals" icon="users">
Cows form close bonds and can recognize over 100 other cows.
</Card>
</CardGroup>

## Anatomy of a cow

<Steps>
<Step title="Four-chambered stomach">
The rumen, reticulum, omasum, and abomasum work together to break down tough plant fibers through fermentation and digestion.
</Step>
<Step title="Hooves">
Each hoof is split into two toes, giving cows stable footing on uneven terrain.

Check warning on line 50 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L50

In general, use active voice instead of passive voice ('is split').
</Step>
<Step title="Teeth">
Cows have no upper front teeth. They use a tough dental pad and their lower incisors to tear grass.
</Step>
</Steps>

## Component showcase

This section demonstrates various Mintlify components using cow-themed content.

<Accordion title="Why do cows moo?">
Cows moo to communicate with each other. They use different vocalizations to signal hunger, distress, or to locate their calves. Research suggests each cow has a distinct voice that other cows can recognize.
</Accordion>

<Note>
A group of cows is called a herd. A group of twelve or more cows is called a "flink."

Check warning on line 66 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L66

In general, use active voice instead of passive voice ('is called').

Check warning on line 66 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L66

In general, use active voice instead of passive voice ('is called').

Check warning on line 66 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L66

Did you really mean 'flink'?
</Note>

<Warning>
Never approach an unfamiliar cow from behind. Always let them see you coming.
</Warning>

<Tabs>
<Tab title="Dairy">
Dairy cows are bred for milk production. Top breeds include Holstein, Jersey, and Brown Swiss. A single Holstein can produce over 9,000 liters of milk per year.

Check warning on line 75 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L75

In general, use active voice instead of passive voice ('are bred').
</Tab>
<Tab title="Beef">
Beef cattle are raised for meat production. Popular breeds include Angus, Hereford, and Charolais. Angus beef is particularly prized for its marbling.

Check warning on line 78 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L78

In general, use active voice instead of passive voice ('are raised').
</Tab>
<Tab title="Dual-purpose">
Some breeds like Simmental and Shorthorn are raised for both milk and meat, making them versatile choices for smaller farms.

Check warning on line 81 in guides/cows.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/cows.mdx#L81

In general, use active voice instead of passive voice ('are raised').
</Tab>
</Tabs>

## Fun cow facts

1. Cows can smell something up to 10 kilometers away
2. The average cow drinks 100–150 liters of water per day
3. Cows spend about 10 hours a day lying down
4. There are approximately 1 billion cows in the world
5. Cows can see almost 360 degrees with minimal head movement
Loading