Fishies 0.8.3

field-guide/en-GB/caring/fish-card.md

@@ -10,7 +10,7 @@ Every fish is born with a name and is female or male. Neither ever changes what
 
 ## What the card shows
 
-One row per thing worth knowing, and Details opens the rest. Each row is explained once, in the article it points to.
+Growth, food and health sit at the top of every card. Under them, three tabs: Overview for what it needs now, Quality for where its quality stands and why it is moving faster or slower, and Value for what it sells for. Each row is explained once, in the article it points to.
 
 - Growth and food: how long until it is grown, and when it gets hungry. See [Growing up](https://fishies.lol/wiki/mechanics/growth) and [Feeding & hunger](https://fishies.lol/wiki/mechanics/feeding).
 - Health: how well it is, and when it would run out without food. See [Quality, condition & breeding](https://fishies.lol/wiki/mechanics/quality).
@@ -27,7 +27,13 @@ Health only speaks when it crosses a line: 10%, 30%, 60%, 80%. A slow drain betw
 
 ## Sale price
 
-On a grown fish, Breakdown on its card splits the price into its parts, such as the species value, your level bonus and its generation. The rules behind the price are in [Selling fish & decorations](https://fishies.lol/wiki/mechanics/economy).
+On a grown fish, the Value tab splits the price into its parts, such as the species value, your level bonus and its generation. The rules behind the price are in [Selling fish & decorations](https://fishies.lol/wiki/mechanics/economy).
+
+## Adopting a fish
+
+Rather keep a grown fish than sell it? Open its card and choose Adopt. An adopted fish wears a heart badge and is never sold, and the net leaves it alone. Up to three adopted fish can live in one aquarium.
+
+Adopting can’t be undone. If you ever need its place, choose Release to the ocean on its card: it swims off into the open sea and you get no coins for it.
 
 ---
 

field-guide/en-GB/caring/quality.md

@@ -12,14 +12,16 @@ A fish below full health can take a Remedy: choose Feed, pick Remedy among the f
 
 ## Six tiers of quality
 
-Quality is what your care adds up to over a fish's whole life. Each meal is judged against that species' own hunger clock, so a three-minute goby and a three-day boxfish are measured by their own rhythm. A meal on time scores full marks, a late one less, and green glass takes a little off the top. A meal only counts for the time since the last one, so feeding the same fish again and again adds nothing: gold takes about six on-time meals' worth of care, from a day for the fastest fish to about eight days for the slowest.
+Quality is what your care adds up to over a fish's whole life. Each meal is judged against that species' own hunger clock, so a three-minute goby and a three-day boxfish are measured by their own rhythm. A meal on time scores full marks, a late one less, and green glass takes a little off the top. A meal counts for the time it kept the fish fed, so feeding the same fish again and again adds nothing, and pellets or brine shrimp, which keep a fish fed for longer, count for all of that time. Meals from an [auto-feeder](https://fishies.lol/wiki/mechanics/filters-and-feeders) count too. A growing fish stops at silver: gold is earned once it is grown, after at least one more full meal as an adult.
 
 [Water](https://fishies.lol/wiki/mechanics/water) sets a ceiling on top of that. Below 70% water, care can't lift a fish to gold, and below 50% not to silver either. Poor water never takes away a tier a fish already has; it only stops it climbing.
 
+Where a fish lives matters too. Every species has a home, reef, rock, sand, weed or wreck, and every decoration and plant belongs to one. With two or more pieces of its home in the aquarium a fish gains quality a fifth faster; with none, a little slower. A crowded aquarium, a fish in poor health or one just placed also gain more slowly. None of this ever takes away a tier a fish already has.
+
 - Plain · where every new fish starts.
 - Bronze · fed reasonably often.
 - Silver · fed on time, most of the time.
-- Gold · the highest tier care alone can reach.
+- Gold · the highest tier care alone can reach, earned once the fish is grown.
 - Diamond · sometimes born to two gold parents, then raised well.
 - Purple diamond · sometimes born to two diamond parents, then raised well.
 

field-guide/en-GB/economy/shop.md

@@ -4,7 +4,7 @@ _Buying eggs, plants and decorations, one at a time or all together._
 
 ## Finding things
 
-The shop has pages for Fish, Plants and Decor. Beside them, the Aquarium Studio button opens the [Aquarium Studio](https://fishies.lol/wiki/mechanics/aquarium-studio), for [filters and feeders](https://fishies.lol/wiki/mechanics/filters-and-feeders) and [more aquariums](https://fishies.lol/wiki/mechanics/aquariums), and the Owned button shows everything you own but haven't placed yet ([the stash](https://fishies.lol/wiki/mechanics/stash)). Everything on sale is listed in the order it unlocks, and you can search and sort each page. Things above your level stay visible and show the level they unlock at. Fish can also be sorted by profit per fish or per hour, by how fast they grow and by stars.
+The shop has pages for Fish, Plants and Decor. Beside them, the Aquarium Studio button opens the [Aquarium Studio](https://fishies.lol/wiki/mechanics/aquarium-studio), for [filters and feeders](https://fishies.lol/wiki/mechanics/filters-and-feeders) and [more aquariums](https://fishies.lol/wiki/mechanics/aquariums), and the Owned button shows everything you own but haven't placed yet ([the stash](https://fishies.lol/wiki/mechanics/stash)). Everything on sale is listed in the order it unlocks, and you can search and sort each page. Things above your level stay visible and show the level they unlock at. Fish can also be sorted by profit per fish or per hour, by how fast they grow and by stars. Each card shows its fish swimming in a small aquarium of its own, with how long it takes to grow, what it sells for and the experience it gives; pick a card to see everything about it beside the list, and the arrow at the bottom of the list scrolls to the next cards.
 
 Tap the heart on a species to add it to your favourites, up to 24, so it's quick to find again.
 

field-guide/en-GB/getting-started/reef-journal.md

@@ -4,16 +4,16 @@ _The in-game guide and its public twin: where to find it and what it holds._
 
 ## Where it is
 
-The Reef Journal sits in the dock beside the Shop (key 9 by default) and in the Keeper OS. It opens over your aquarium, your fish keep swimming, and Escape closes it.
+The Reef Journal is the notebook in the corner beside Aquariums and the Map (key 9 by default), and it is in the Keeper OS too. It opens over your aquarium, your fish keep swimming, and Escape closes it.
 
 It is the same guide as the one on the website at fishies.lol/wiki, written once and shown in both places, so the two cannot disagree. Every number in it is read from the game’s own rules.
 
 ## What is inside
 
-Search finds an article, a fish or a decoration by name. Without a search, browse by category.
+In the game the Reef Journal is a notebook with the Fishies cover on its front: it opens out of that cover, two pages open, a tab for each chapter along its edge, and the page turns as you go. Search finds an article, a fish or a decoration by name.
 
 - Articles: every part of the game, with each rule explained once. Links inside the book stay inside the book.
-- Fish: each species with its Latin name, its Stars and Care level, what sets it apart, and its growth and sale facts. In the game, a fish fills in once you have met it; on the website every species is listed. See [Stars](https://fishies.lol/wiki/mechanics/stars) and [Care level](https://fishies.lol/wiki/mechanics/care-level).
+- Fish: every species you have hatched gets a sticker; the rest are silhouettes until you meet them. A fish’s page shows its Latin name, its Stars and Care level, what sets it apart, its growth and sale facts, its home in the aquarium, and your own record: how many live with you, how many you sold and at what best quality, when you first found it, and any you adopted or released. See [Stars](https://fishies.lol/wiki/mechanics/stars) and [Care level](https://fishies.lol/wiki/mechanics/care-level).
 - Decorations: price, unlock level and category, with a note on caring for it. In the game, a decoration fills in once you have met it.
 
 ## On the website

field-guide/en-GB/getting-started/tools.md

@@ -11,7 +11,7 @@ Almost everything you do in your aquarium starts from the dock of tools at the e
 - Net: tap a grown fish to sell it, or collect a fish that was lost.
 - Clean: scrub algae off the glass with the sponge.
 - Shop: everything you buy lives here: fish, plants and decorations. Its Owned button shows what you own but haven't placed yet, with Arrange at the top, where your fish step back so you can move decorations. Its Aquarium Studio button opens the Studio.
-- Reef Journal: every species, decoration and way of the game, looked up in a moment.
+- Reef Journal: the notebook in the corner beside Aquariums and the Map. Every species, decoration and way of the game, looked up in a moment.
 
 ## The Map