@gentbajko/slopify 4.0.0 → 4.1.0

package/dist/tutorials/Editing-a-Project.md

@@ -1,201 +1,201 @@
 # Editing a Project
 
-You can change almost anything about a project after it has run: the article, a narration chunk, one image, the prompts, the providers, the captions or the volume. Slopify saves each change as a new revision and remakes only the outputs the change affects, after you have seen what that costs.
+You can change almost anything about a project after it has run: the article, one narration chunk, one image, the prompts, the services and models, the captions or the volume. Slopify saves each change as a new version and makes again only what the change affects, after you have seen what that costs.
 
-**Where to find it:** a project → **Edit settings** (top right), or **Settings** in the section rail. The form is called **Edit project**.
+**Where to find it:** a project → **Edit settings** in the title row. It opens the project's settings in the main column, with two tabs: **Settings** and **Versions**. While they are open the same button reads **Close settings**.
 
 ## How editing works
 
-1. **Edit.** You change settings or content in the Edit project form. Nothing runs while you edit.
-2. **Save.** **Save changes** stores a new revision. Saving never starts work. Outputs the change affects turn **outdated** and keep their old version until they are remade.
-3. **Remake.** The next action button offers the first group of outdated outputs, for example **Remake the outdated narration** or **Remake 4 outdated images**. Press it, or open **Choose what to remake** to see the full list, the cost, and what is kept.
+1. **Edit.** Change settings or content under **Settings**. Nothing runs while you edit.
+2. **Save.** **Save changes** keeps a new version. Saving never starts work: the line beside the button says "Saved as a new version. Nothing is made again until you choose to." What the change affects turns **outdated** and keeps its current version until it is made again.
+3. **Make it again.** The title row's next action offers the first group of outdated files, for example **Make the outdated narration again** or **Make the 4 outdated images again**. Press it, or open **Choose what to make again** to see the full list, the cost and what is kept.
 
-Remaking one group can make the next group outdated in turn (new narration outdates the video); the next action then names that group.
+Making one group again can make the next group outdated in turn (new narration outdates the video); the next action then names that group.
 
-## Edit project sections
+## The sections
 
-The form has its own section list on the left. Some sections appear only when the project uses them.
+The settings have their own list of sections on the left, named and ordered as Create's rows and Edit template's sections are. A section appears only when the project can use it.
 
 | Section | What you change there |
 | --- | --- |
-| **Inputs** | **Project title**, **Channel** and brand kit, **Stages** (the source of each stage: Research, Article, Audio, Images, Thumbnail, Video, Document), **Document theme**, **Timing** (silence, seconds per image, zoom, motion), **Cuts and look**, **Ambient sound**, **Pauses and volume**, **Intro and outro**, **Research notes**. |
-| **Article** | The **Article text** itself. Shows an "edited" badge once you have changed it. |
-| **Providers** | Language, text, narration and image providers, models, voice, speakers, Pronunciation Glossary, narration aliases, **Describe tables and figures**, chunking and Narration Preparation. |
-| **Prompts** | The **YouTube description** switch (turn it on for a project that has no description yet) and its **Description prompt**, every prompt the project uses, and the keywords. |
-| **Reviews** | Automatic reviews. See [Reviews and Checkpoints](Reviews-and-Checkpoints). |
-| **Shorts** | Shorts settings, the Shorts preview and picked clips. See [Shorts](Shorts). |
-| **Subtitles** | Caption mode, font, size, position and the style preview. See [Video Editing](Video-Editing#subtitles). |
-| **Images** | **Image prompts**, **More images for long videos**, the establishing image, thumbnail count, replacing provided files, and the image list. The badge shows how many images there are. |
-| **Narration** | The narration chunks (only when narration is generated). |
-| **Captions** | Caption text and timing. The badge shows how many captions you have loaded. |
+| **Title and keywords** | The **Project title**, **Refresh keyword facts** and every keyword with what it feeds. |
+| **Article** | Where the research and the article come from, **Written by** (service, model, thinking), the article prompt and the **Article text** itself, with **Write the article again after review**. Shows "edited" once you changed the text. |
+| **Narration** | Where the narration comes from, **Read by** (service, model, voice), **Split the narration by**, pronunciation, narration aliases, tables and figures, **Speakers**, narration preparation, the **Intro and outro** and the narration chunks. |
+| **Images** | Where the images come from, **Images by** (service, model), **Image prompts**, **More images for long videos**, **Scenes from the article**, the establishing image and the image list. The badge shows how many images there are. |
+| **Video and style** | Video on or off, the frame format, **Images and cuts** (seconds per image, zoom, motion, cuts, the Look) and **Sound polish** (silences, pauses, volume and ambient sound). See [Video Editing](Video-Editing). |
+| **Captions** | The captions' mode, font, size and position with the style preview, and the captions' own words and timing. The badge shows how many captions you have loaded. |
+| **Extras** | The thumbnail (how it is made, one or three, its files), the YouTube description, **Shorts**, the PDF and its **PDF look**, and the prompts they use. |
+| **Pauses and checks** | The pauses for this run and the AI checks. See [Pauses and checks](Reviews-and-Checkpoints). |
+| **Channel** | The project's channel, **Use the channel's brand kit** and the language. |
 
-At the bottom: **Save changes** saves a revision, **Discard changes** drops the draft. While a file is uploading the bar says "Waiting for uploads to finish…" and saving waits.
+At the bottom: **Save changes** keeps a new version, **Discard changes** drops what you changed (with **Undo** for a moment after). **Save changes** is lit only once something changed. While a file uploads the bar says "Waiting for uploads to finish…" and saving waits.
 
-If someone (or another tab) saved the project while you were editing, the bar says "A newer revision is available. Your unsaved changes are kept below and in this browser." Press **Reload latest and re-apply my edit** to lay your changes over the newer revision (check them, then **Save changes**), or **Copy my edit** to keep a copy on the clipboard first.
+If someone (or another tab) saved the project while you were editing, the bar says "A newer version is available. Your unsaved changes are kept below and in this browser." Press **Reload latest and re-apply my edit** to lay your changes over the newer version (check them, then press **Save changes**), or **Copy my edit** to keep a copy on the clipboard first.
+
+The bundled sample's settings can be read, section by section, but not changed. Press **Make my own copy** first.
 
 ## Change the article text
 
-1. Open **Edit project → Article**.
+1. Open **Edit settings** → **Article**.
 2. Edit the **Article text** (Markdown; headings become chapters).
 3. Press **Save changes**.
 
-Your edit is kept when other settings change, and saved as a new revision. The narration, images and video made from the old text turn outdated and are remade when you choose.
-
-### Regenerate the article
+Your edit is kept when other settings change. The narration, images and video made from the old text turn outdated and are made again when you choose.
 
-**Regenerate article after review** (under the article text, when the article is generated) marks the article to be written again by the text model, one or more paid text calls. Nothing runs yet: the rebuild review lists it with the narration, images and video it outdates, and you start it there. It replaces any edits you made to the article.
+**Write the article again after review** (under the article text, when the AI writes the article) marks the article to be written again: paid writing calls, with their cost shown first. Nothing runs yet: **Choose what to make again** lists it with the narration, images and video it outdates, and you start it there. It replaces your edits to the article.
 
 ## Edit narration
 
-**Edit project → Narration** shows the narration split into the chunks it was spoken in. Only the chunks you touch are made again, paid per character, and the video is rendered again with them.
+To fix one line, you don't need the settings: on the project page, press the line in **Narration**, then **Fix this line**, correct the words or leave them, and press **Make this passage again**.
+
+**Edit settings** → **Narration** ends with the narration split into the chunks it was spoken in. Only the chunks you touch are made again, paid per character, and the video is put together again with them.
 
 | Control | What it does |
 | --- | --- |
-| **Text for narration chunk N** | What the narrator says in this chunk. Editing it has the chunk spoken again by your voice provider when you remake outdated outputs. The other chunks keep their audio; captions and the video follow. It does not change the article. |
+| **Text for narration chunk N** | What the narrator says in this chunk. Editing it has the chunk spoken again by your voice service once you make the outdated narration again. The other chunks keep their audio; captions and the video follow. It does not change the article. |
 | **Replace narration chunk N** | Uses your own audio file for this chunk. |
-| **Regenerate narration chunk N after review** | Speaks the chunk again with the same text and voice, for a new take when a word came out wrong. Paid per character. The current audio stays until then. **Keep narration chunk N** takes the mark off. |
+| **Make narration chunk N again · voice call** | Speaks the chunk again with the same text and voice, for a new take when a word came out wrong. Paid per character. The current audio stays until then. **Keep narration chunk N** takes the mark off. |
+
+When the narration was spoken as one whole request, the section says so: editing its text makes the whole narration again. When the narration is your own file, **Replace provided narration** takes a new one.
+
+### Narration options
 
-When the project was narrated as one whole request (Chunking set to the whole article), the form says so: editing its text rebuilds the whole narration request.
+| Control | What it does |
+| --- | --- |
+| **Also use pronunciations from my other projects** → **Update from other projects** | Copies your other projects' Pronunciation Glossary terms into this project again, picking up any added since the last copy. After you save, only the chunks whose words those terms change are spoken again, paid per character. |
+| **Use your pronunciation list** → **Copy the list again** | Copies your Pronunciation list (Settings → Voices → **Pronunciation**) into this project again. A change to the list reaches the project only when you press this. After you save, only the chunks the changed aliases touch are spoken again. |
+| **Describe tables and figures in the narration** | The AI writes a short spoken passage for each table, figure, equation and code block. Turning it on costs one AI call per block, and after you save the chunks that contain a block are spoken again (the whole narration when it is spoken as one request). **Leave code out** skips code blocks. |
+
+**Show tables and figures on screen** (in **Video and style** → **Images and cuts**, when Describe tables and figures is on) shows each described block in the video while its description is spoken, as the article's picture or a card drawn on your computer at no cost. Turning it on or off puts the video together again, and any shorts that include a card; the narration is kept.
+
+See [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).
 
 ## Edit images
 
-**Edit project → Images** lists every image of the video in the order it is shown. Changes apply after you save.
+**Edit settings** → **Images** ends with every image of the video in the order it is shown. Changes apply after you save.
 
 | Control | What it does |
 | --- | --- |
-| **Prompt for image N** | The words this image is drawn from, with keywords in double braces filled in from the project. Editing it outdates only this image and the video; it is drawn again, one image call, when you remake. |
-| **Use saved wording as template for image N** | Copies the prompt as sent into the box so you can edit it. |
-| **Replace image N** | Uses your own picture in its place. |
+| **Prompt for image N** | The words this image is drawn from, with keywords in double braces filled in from the project. Editing it outdates only this image and the video; it is drawn again, one image call, when you make it again. |
+| **Use saved wording as template for image N** | Copies the prompt as it was sent into the box so you can edit it. |
+| **Replace image N** | Uses your own picture or clip in its place. |
 | **Move image N earlier** / **later** | Changes the order. |
-| **Delete image N** | Removes it. Deleting the last image also turns Images and Video off. |
-| **Regenerate image N** | Marks the image to be drawn again from its prompt, one paid image call, with a new result, when you save. The image says it is marked, and **Keep image N** takes the mark off. The current image stays until the new one is made. |
+| **Delete image N** | Removes it, with **Undo**. Deleting the last image also turns Images and Video off. |
+| **Make image N again · 1 image call** | Marks the image to be drawn again from its prompt, with a new result. **Keep image N** takes the mark off. The current image stays until the new one is made. |
 | **Add generated image** | Adds a new image with an empty prompt at the end. |
 | **Add provided image** | Adds your own picture at the end. |
 | **Add a video clip** | Adds a clip (MP4, MOV, M4V, WebM or MKV). It plays muted in an image's place, trimmed, slowed (to half speed at most) or looped to fit. |
 
 A project holds at most 60 images, or 240 with **More images for long videos** on.
 
-The **Regenerate** button on an image in the project's Images section, and **Regenerate all** beside Download all, do it without the settings: they ask once, then make the new images straight away. The video keeps the old images, marked outdated, until you remake it, so you can regenerate several images and render the video once. If the settings have unsaved changes of their own, the images are marked there instead, to go with them when you save.
+On the project page itself, **Make this image again** under an image and **Make all 4 images again** in the Images heading do it without the settings: they ask once, then make the new images straight away. The video keeps the old images, marked outdated, until you make it again, so you can make several images again and put the video together once. If the settings have unsaved changes of their own, the images are marked there instead, to go with them when you save.
 
 ### Image prompts and More images for long videos
 
-- **Image prompts** is the same control as on Play: which Library image prompts the project uses and how many images each makes (its Number). The line under it says what saving will do. Raising a Number adds images right after that prompt's last one, lowering it drops its last ones, unticking a prompt drops its images, and a newly ticked prompt adds new images at the end. Images left as they were are kept and reused.
+- **Image prompts** is the same control as on Create: which of your image prompts the project uses and how many images each makes. The line under it says what saving will do. Raising a number adds images right after that prompt's last one, lowering it drops its last ones, unticking a prompt drops its images, and a newly ticked prompt adds new images at the end. Images left as they were are kept and reused.
 - **More images for long videos** sets extra images by length: **Every N minutes** or **N per hour**. Saving plans the extra images and keeps every existing one.
 
-### Establishing image and provided files
+### Establishing image and your own files
 
-The establishing image can be changed or made again in the Images section. When a stage uses your own file (narration or thumbnail set to Provide), **Replace provided audio** and **Replace provided thumbnail** take a new file.
+The establishing image can be changed or made again in the Images section. When the thumbnail is your own file, **Replace provided thumbnail** in **Extras** takes a new one.
 
 ## Edit captions
 
-1. Open **Edit project → Captions**.
-2. Press **Edit existing caption cues**. This works once the current narration has finished and its subtitle timing is ready.
-3. Change a caption's words, or its start and end in seconds from the start of the narration.
+1. Open **Edit settings** → **Captions**.
+2. Press **Edit existing caption cues**. This works once the current narration has finished and its caption timing is ready.
+3. Change a caption's words, or its start and end in seconds from the start of the narration. **Play** beside a caption plays that stretch of the narration.
 4. Press **Apply caption edits to draft**.
 5. Press **Save changes**.
 
-**Apply caption edits to draft** checks every caption (text present, times in order, inside the narration) and puts your edits into the draft. Captions must not overlap and must end after they start; each problem is named, for example "Caption 4: enter caption text." Nothing is saved until **Save changes**, and the video is rendered again only when you remake outdated outputs. Caption edits cost nothing; only the subtitle files and the video are made again. The narration is not changed. **Discard caption edits** drops them.
+**Apply caption edits to draft** checks every caption (text present, times in order, inside the narration) and puts your edits into the draft. Captions must not overlap and must end after they start; each problem is named, for example "Caption 4: enter caption text." Nothing is saved until **Save changes**, and the video is put together again only when you make the outdated files again. Caption edits cost nothing; only the caption files and the video are made again. The narration is not changed. **Discard caption edits** drops them.
 
-If the narration changed since you edited the captions, the form says the edits belong to an earlier narration: check them against the current one, apply and save.
+If the narration changed since you edited the captions, the section says the edits belong to an earlier narration: check them against the current one, apply and save.
 
 ## Prompts
 
-**Edit project → Prompts** shows every prompt the project used (the article, Narration Preparation, YouTube description, Shorts, Shorts image style, thumbnail, establishing image, intro, outro and each image prompt).
+Each prompt the project used sits in the section of the stage it writes for: the article prompt under **Article**; narration preparation, the intro and the outro under **Narration**; the establishing image and each image prompt under **Images**; the thumbnail, YouTube description, shorts and shorts image style under **Extras**; the checks' prompts under **Pauses and checks**.
 
 | Control | What it does |
 | --- | --- |
-| **Use saved template for ...** | Copies a prompt from your Library into this project, replacing the raw prompt. Pick it in **Choose a saved template**. |
-| **Raw prompt for ...** | This project's own copy of the prompt, with keywords still in double braces such as `{{Topic}}`. Edit it to change what the model is asked, for this project only; the Library prompt is untouched. |
-| **Saved rendered prompt** | The prompt as it was sent, with keywords filled in. |
-| **Use the Library version for ...** | Shown when the Library prompt changed since the project copied it. Copies the new wording in. |
-| **Keywords** | The keyword values, each with everything it feeds. |
-
-The project keeps its own copy of each prompt, so later Library edits reach it only when you pick it again or press **Use the Library version**. Saving fills the keywords in again, and whatever was made from the old wording turns outdated. Nothing is remade until you choose.
-
-**Write the description again after review** marks the YouTube description to be written again, one paid text call, when you save and continue or start the rebuild review. **Keep the current description** takes the mark off. See [YouTube Description](YouTube-Description).
+| **Use a saved prompt for …** | Copies one of your prompts (from **Prompts**) into this project, replacing its own copy, with **Undo**. |
+| **Prompt for …** | This project's own copy of the prompt, with keywords still in double braces such as `{{Topic}}`. Edit it to change what the model is asked, for this project only; the prompt in Prompts is untouched. |
+| **As it was sent, keywords filled in** | The prompt as it was sent, with keywords filled in (folded). |
+| **Use the new wording** / **Keep this project's version** | Shown when the prompt in Prompts changed since the project copied it. Use the new wording copies it in. |
 
-## Narration options in Providers
+The project keeps its own copy of each prompt, so later edits in Prompts reach it only when you pick it again or press **Use the new wording**. Saving fills the keywords in again, and whatever was made from the old wording turns outdated. Nothing is made again until you choose.
 
-| Control | What it does |
-| --- | --- |
-| **Also use pronunciations from my other projects** → **Update from other projects** | Copies your other projects' Pronunciation Glossary terms into this project again, picking up any added since the last copy. After you save, only the chunks whose words those terms change are spoken again, paid per character. |
-| **Use narration aliases** → **Update from Library** | Copies Library → Narration aliases into this project again. A Library edit reaches the project only when you press this. After you save, only the chunks the changed aliases touch are spoken again. |
-| **Describe tables and figures in the narration** | The text model writes a short spoken passage for each table, figure, equation and code block. Turning it on costs one text call per block, and after you save the chunks that contain a block are spoken again (the whole narration when Chunking is the whole article). **Leave code out** skips code blocks. |
-
-**Show tables and figures on screen** (in **Inputs → Cuts and look**, when Describe tables and figures is on) shows each described block in the video while its description is spoken, as the article's picture or a card drawn on your computer at no cost. Turning it on or off renders the video again, and any Shorts that include a card; the narration is kept.
-
-See [Narration Aliases and Glossary](Narration-Aliases-and-Glossary).
+**Write the description again after review** (in **Extras**) marks the YouTube description to be written again, one paid AI call, when you make the outdated files again. **Keep the current description** takes the mark off. See [YouTube Description](YouTube-Description).
 
 ## Pauses and volume
 
-**Edit project → Inputs → Pauses and volume** holds these settings. All run on your computer with no API calls.
+**Edit settings** → **Video and style** → **Sound polish** holds these settings. All run on your computer with no service calls.
 
 | Option | What it does | Default / range |
 | --- | --- | --- |
+| **Silence gap (seconds)** | Quiet between the intro and the narration, and between the narration and the outro. Only matters when an intro or outro is set. | Settings value (3 s unless changed); 0 to 30 |
+| **Silence at start and end (seconds)** | Quiet before the narration starts and after it ends. | 2; 0 to 30 |
 | **Pause between sentences (seconds)** | The least quiet after each sentence. Adds silence where the pause is shorter; never shortens one or cuts a word. About 0.25 s is brisk, 0.35 to 0.45 natural, 0.5 to 0.8 an audiobook's pace, 0.8 and up sleep content. 0 keeps the voice's own. | 0.4; 0 to 2 in steps of 0.05 |
 | **Pause between paragraphs (seconds)** | The least quiet at the end of a paragraph, when you want more than between sentences. At 0 paragraphs get the sentence pause. Try 0.8 to 1.2 for a slower read. A speaker's turn gap is set under Speakers instead. | 0; 0 to 2 |
 | **Soften breaths** | Turns the audible in-breaths a voice takes between sentences and after commas down by 12 dB, with soft fades (Inworld's TTS-2 takes a loud one almost every time). A breath with any word sound in it is left alone; words, pauses and captions stay where they were. | Off |
 | **Soften S sounds** | Takes the sharp edge off s and sh sounds with a very light de-esser; the voice keeps its brightness. Works with or without Soften breaths. | Off |
 | **Level each sentence** | Holds every sentence to the sentences in the minute around it, so no line jumps out or drops away: a loud one comes down by up to 6 dB, a quiet one up by up to 3 dB, and the volume only changes in the pauses. Runs before Soften breaths and Soften S sounds. Needs Level the volume; one voice only. Pairs well with a Video volume of −2 dB, which gives the final limiter more room. | Off |
-| **Level the volume** | Brings every narration piece to one loudness before they are joined, then sets the video, shorts and audio files to a finished loudness. | On for new runs (Settings → General → **Level the volume for new runs**) |
+| **Level the volume** | Brings every narration piece to one loudness before they are joined, then sets the video, shorts and audio files to a finished loudness. | On for new runs (Settings → Production defaults → **Level the volume for new runs**) |
 | **Video volume** | How loud the video and shorts are, in dB from the recommended level (0 dB is -14 LUFS, what YouTube and Spotify play at). -6 dB is about 50%, +4 dB about 158%. Peaks stay under -1.5 dBTP. | 0 dB; -10 to +4 dB in 0.5 dB steps |
 | **Audio files volume** | How loud the WAV, MP3 and M4B are, in dB from -18 LUFS (what audiobook shops such as ACX ask for). Peaks stay under -3 dBTP. | 0 dB; -10 to +4 dB |
 
-You can type a volume in dB or as a percentage of the recommended level.
+You can type a volume in dB or as a percentage of the recommended level. **Ambient sound** is in the same fold; see [Video Editing](Video-Editing#ambient-sound).
 
-What changing them remakes:
+What changing them makes again:
 
-- **Pauses, Soften breaths, Soften S sounds or Level each sentence**: the narration is joined again from the pieces it already has and timed again, which remakes what is timed from it: captions, the video and, when on, the YouTube description and the shorts' pick (those two are text calls). No speech is made again.
-- **Level the volume on or off**: the levelled narration is joined again and the exports rendered again. No speech is made again, and word timing, description, shorts' pick and reviews are not redone.
-- **A volume only**: the exports are mastered again, nothing else.
+- **Pauses, Soften breaths, Soften S sounds or Level each sentence**: the narration is joined again from the pieces it already has and timed again, which makes again what is timed from it: captions, the video and, when on, the YouTube description and the shorts' pick (those two are AI calls). No speech is made again.
+- **Level the volume on or off**: the levelled narration is joined again and the video and audio files are put together again. No speech is made again, and word timing, description, shorts' pick and checks are not redone.
+- **A volume only**: the video and audio files are mastered again, nothing else.
 
-An uploaded narration is never levelled piece by piece; only the final master reaches it. Turn Level the volume off to keep the exports at your file's own level.
+An uploaded narration is never levelled piece by piece; only the final master reaches it. Turn Level the volume off to keep the files at your recording's own level.
 
-## Choose what to remake
+## Choose what to make again
 
-**Choose what to remake** opens the rebuild review for every outdated or failed output. Open it from the **Settings** view, **More project actions → Choose what to remake…**, or the command palette.
+**Choose what to make again** opens the review of every outdated or failed file. Open it from **More** → **Choose what to make again…** in the title row (only when files are outdated), from the **Settings** tab after you discarded a draft, or from the command palette.
 
 The review shows:
 
-- Counts of work items: **to make**, **built on this computer**, **to confirm**, **kept as they are**, and **can't run**, plus the known cost range. CLI work reads "$0 on your plan", with what the same work would cost via API.
+- What it does, in words: what is made again (and whether it is charged or on your plan), what is then put together on this computer for free, and what stays as it is.
+- Counts of work items: **to make**, **built on this computer**, **to confirm**, **kept as they are** and **can't run**, plus the known cost (**Not known** when no call in it has a price). Work on a Claude Code or Codex plan reads "$0 on your plan", with what the same work would cost through the API.
 - **Changed inputs**: each changed input with **Before** and **After**.
-- **Work items**: every item, why it is made or kept, and **View request text** for the exact request.
+- **Item by item (N)**: every item, why it is made or kept, and **View request text** for the exact request.
 - **Cost by step**.
 
-Press **Remake N outputs** to start, or **Keep things as they are** to close it with nothing spent. When the button is off, the line beside it says why, for example that an item can't run (its reasons are listed above) or that a box needs ticking:
+Press the button named for what it makes, **Make image 2 again** for one thing or **Make 3 items again** for several, to start, or **Keep things as they are** to close it with nothing spent. When the button is off, the line beside it says why, for example that an item can't run (its reasons are listed above) or that a box needs ticking:
 
 | Tick box | When it appears |
 | --- | --- |
-| **Keep the provided content for ...** | An output uses a file or text you supplied, and something it depends on (such as the narration) has changed since. Tick to confirm it still fits. To use something else, close the review and replace the file in Edit project first. |
-| **I understand that N cost estimates are unknown.** | Some steps use a model with no published price, so their cost is left out of the total. Tick to start anyway; the real cost is recorded under Cost once they run. |
+| **Keep the provided content for …** | A file uses something you supplied, and something it depends on (such as the narration) has changed since. Tick to confirm it still fits. To use something else, close the review and replace the file in Edit settings first. |
+| **Start even though 1 call's price isn't known** (or **N calls' prices aren't known**) | Some steps use a model with no published price, so their cost is left out of the total. Tick to start anyway; the real cost is recorded under the project's cost line once they run. |
 
-The next action button and **Remake everything outdated** in the command palette start the remake at once when nothing needs ticking; otherwise they open this review.
+The next action button and the outdated groups in the command palette start at once when nothing needs ticking; otherwise they open this review. A make-again button on the project page (**Make this image again**, **Make this short again**, **Fix this line**) asks first in its own dialog, which names the paid calls and their price or says the price isn't known; pressing on there starts the work at once. If that work still needs this review (it costs more than the dialog said, or something can't run), **Keep things as they are** puts the project back to the version it was on before the press, and a start that is refused does the same and lists the reasons under each step's name.
 
-## History and saved revisions
+## Versions
 
-Every save of Edit project is a revision: a snapshot of the settings and content. Continuing a run always uses the current one.
+Every save is a version: a snapshot of the settings and content. Continuing a run always uses the current one.
 
-When the editor is closed, the **Settings** view shows **Saved revision** with each output's state: **Ready**, **Outdated; the retained version stays until it is remade**, **Provided content needs review**, or **Retained file missing**.
+**Edit settings** → **Versions** lists every version, newest first, as **Version N** with its title, when it was saved, **by agent** or **by assistant** when one of them saved it, and **Current** on the one in use. With only one version, one line says when it was saved instead.
 
-### Look at or restore an earlier revision
+1. Press **Show its files** on a version to see what it made: **Download all images** (or **Download this version's images**), one **Open folder**, then each file with its state, its download and a preview. Files the current version no longer uses read **Earlier result**. Kept narration parts play in Slopify's own audio player, and text parts can be opened too.
+2. Press **Restore** on an older version. A dialog says what it does: the settings go back to that version's, saved as a new version; the current ones stay in the list. Confirm with **Restore version N**, or **Keep the current settings**.
 
-1. Open **History** in the section rail.
-2. Pick a revision from **Project history** (the current one is marked **Current**).
-3. At the top, one row of buttons: **Restore this revision** (the main action), **Download all images** (a zip of that revision's images) and one **Open folder** for the revision.
-4. Below, each output is listed with its state, **Download** and **Preview retained output**. Earlier results are marked **Earlier result**. Retained narration parts play in Slopify's own audio player, and text parts can be opened too.
-5. Press **Restore this revision** to make it current again.
+Restoring never makes anything again until you choose to. A restored version takes its channel back. When agents or the assistant changed the project, **Done by agents** (or **Done by the assistant**) lists what they did and when.
 
-Restoring adds a new revision with the old settings and outputs, so nothing after it is lost. A restored revision takes its channel back.
+Under the list: **Free space** on a finished project (see [Project Page](Project-Page#free-space)) and the **Project ID** with **Copy project ID**.
 
 ## Save as template
 
-**More project actions → Save as template…** saves this project's settings as a template for Play and Schedules. Keywords the title names are saved empty; other keyword values are kept. See [Templates](Templates).
+**More** → **Save as template…** in the title row saves this project's settings as a template for Create and Schedules. Keywords the title names are saved empty; other keyword values are kept. The project itself stays as it is. See [Templates](Templates).
 
 ## Tips
 
-- Several edits can go into one save. Make them all, save once, then review the remake.
-- A rejected save lists each problem next to its field; fix those and save again.
-- To redo a whole stage from scratch rather than one piece, use the section's own More menu on the project page (see [Project Page](Project-Page#re-run-a-whole-stage)).
+- Several edits can go into one save. Make them all, save once, then choose what to make again.
+- A refused save lists each problem next to its field; fix those and save again.
+- To make a whole part again rather than one piece, use the button in its heading on the project page (see [Project Page](Project-Page#make-a-whole-part-again)).
 
 ## Related pages
 

package/dist/tutorials/FAQ.md

@@ -8,11 +8,11 @@ Short answers to the questions people ask most, with links to the pages that go
 
 ### Is Slopify free?
 
-Yes. Slopify is free and open source. You pay the AI providers you choose (for text, narration and images) directly, on your own accounts. Rendering, captions, loudness, the Look, ambient sound, chapter cards and the style preview run on your computer and cost nothing.
+Yes. Slopify is free and open source. You pay the AI services you choose (for writing, narration and images) directly, on your own accounts. Putting the video together, captions, loudness, the Look, ambient sound, chapter cards and the style preview run on your computer and cost nothing.
 
 ### How much does one video cost?
 
-It depends on the providers, models, length and number of images. Play shows an estimate before you start, with **Cost by stage** under it. After a run, the project's **Cost** section shows what each stage and model actually cost, retries and remakes included. See [Costs and Run Cost](Costs-and-Run-Cost).
+It depends on the services, models, length and number of images. Create shows an estimate before you start, with **Cost by stage** under it. After a run, the project's cost line and its **See the breakdown** show what each stage and model actually cost, retries and everything made again included. See [Costs and Run Cost](Costs-and-Run-Cost).
 
 ### Can I use my Claude, ChatGPT (Codex) or Gemini subscription instead of API keys?
 
@@ -20,11 +20,11 @@ Yes, through the command-line tools you are already signed in to: Claude Code, C
 
 ### Can I make a video without any API key?
 
-Yes. Sign in to Claude Code, Codex or Antigravity CLI for the text (Codex also draws the images), and the narration can use your computer's own voice, the **System voice**, for free. That is what the first 60-second short uses when no voice key is saved. It sounds robotic, so add a voice key when you want a better one. See [Your First Short](Your-First-Short) and [Providers and Keys](Providers-and-Keys#the-system-voice).
+Yes. Sign in to Claude Code, Codex or Antigravity CLI for the text (Codex also draws the images), and the narration can use your computer's own voice, the **System voice**, for free. That is what the first 60-second short uses when no voice key is saved. It sounds robotic, so add a voice key when you want a better one. See [Your First Short](Your-First-Short) and [Keys and Services](Providers-and-Keys#the-system-voice).
 
 ### How do I know a key works before I save it?
 
-Paste it in Settings → **Providers** and press **Test**. Slopify checks the pasted key with the provider without storing it; press **Save** to keep it. See [Providers and Keys](Providers-and-Keys#test-a-key).
+Paste it in Settings → **Keys & services** and press **Test the key (free)**. Slopify checks the pasted key with the service without storing it; press **Save** to keep it. See [Keys and Services](Providers-and-Keys#test-a-key).
 
 ### Do I need an account or a login for Slopify?
 
@@ -34,7 +34,7 @@ No. There is no Slopify account and no login. That is also why Slopify listens o
 
 ### Where are my API keys stored?
 
-On your computer, in Slopify's hidden data folder (`~/.slopify` by default; in Docker, the `slopify-data` volume). Each key is sent only to its own provider, and keys are never put in a backup or an export. Diagnostics files never contain them either. See [Providers and Keys](Providers-and-Keys).
+On your computer, in Slopify's hidden data folder (`~/.slopify` by default; in Docker, the `slopify-data` volume). Each key is sent only to its own service, and keys are never put in a backup or an export. Diagnostics files never contain them either. See [Keys and Services](Providers-and-Keys).
 
 ### Where are my projects?
 
@@ -42,35 +42,35 @@ In your files folder, `Documents/Slopify` for new installs, Docker included (Set
 
 ### Does Slopify send anything about me?
 
-Slopify sends anonymous counts to show the live totals on slopify.stream: tokens per stage with provider and model, audio seconds, images, thumbnails, videos, PDFs, YouTube descriptions, shorts, projects created, that the machine installed Slopify, and when each happened. Each event carries a random ID and a random machine ID. It never sends your API keys, prompts, keyword values, titles, article or research text, files or file names, or your operating system, locale or hardware. A notice explains this the first time you open Slopify.
+Slopify sends anonymous counts to show the live totals on slopify.stream: tokens per stage with service and model, audio seconds, images, thumbnails, videos, PDFs, YouTube descriptions, shorts, projects created, that the machine installed Slopify, and when each happened. Each event carries a random ID and a random machine ID. It never sends your API keys, prompts, keyword values, titles, article or research text, files or file names, or your operating system, locale or hardware. A notice explains this the first time you open Slopify.
 
-What you write is sent only to the AI providers you pick, because they make the article, narration and images.
+What you write is sent only to the AI services you pick, because they make the article, narration and images.
 
 ### Does it work offline?
 
-Partly. The AI steps (article, research, narration, images, thumbnails, descriptions) call providers over the internet, or CLIs that do. Rendering the video, levelling the volume, captions, the style preview and the System voice run on your computer. Captions need a speech model of about 378 MB (smaller ones can be chosen in Settings → Production defaults) that is downloaded once, on first use. Patch notes ship with the app and open offline.
+Partly. The AI steps (article, research, narration, images, thumbnails, descriptions) call services over the internet, or CLIs that do. Putting the video together, levelling the volume, captions, the style preview and the System voice run on your computer. Captions need a speech model of about 378 MB (smaller ones can be chosen in Settings → Production defaults) that is downloaded once, on first use. Patch notes ship with the app and open offline.
 
 ## Making and editing videos
 
 ### Can I change a video after it is made?
 
-Yes. Open the project, press **Edit settings**, change what you want and press **Save changes**. Only the outputs the change affects turn outdated, and you remake them when you choose, after seeing the cost. See [Editing a Project](Editing-a-Project).
+Yes. Open the project, press **Edit settings**, change what you want and press **Save changes**. Only the files the change affects turn outdated, and you make them again when you choose, after seeing the cost. See [Editing a Project](Editing-a-Project).
 
 ### Can I fix one image or one sentence without redoing everything?
 
-Yes. In **Edit project → Images** you can edit one image's prompt, replace it with your own file or regenerate it; in **Edit project → Narration** you can edit or respeak one chunk. Only that piece and the video are made again.
+Yes. In **Edit settings** → **Images** you can edit one image's prompt, replace it with your own file or make it again; in **Edit settings** → **Narration** you can edit one chunk or have it spoken again. Only that piece and the video are made again.
 
 ### Where do I see what a run cost?
 
-At the top of a finished project's page, one line sums it up ("This run cost …"), with **See cost by stage**. See [Costs and Run Cost](Costs-and-Run-Cost).
+Under the status list on the project page, one line sums it up ("Cost $0.07 · 4 s of working time"), with **See the breakdown**. See [Costs and Run Cost](Costs-and-Run-Cost).
 
 ### Can I go back to an earlier version?
 
-Yes. **History** on the project page lists every saved revision with its files. **Restore this revision** makes an old one current again, without losing anything saved after it.
+Yes. **Edit settings** → **Versions** on the project page lists every saved version with its files. **Restore** makes an old one current again, saved as a new version, without losing anything saved after it. See [Editing a Project](Editing-a-Project#versions).
 
 ### Can I use my own images, audio or video clips?
 
-Yes. Stages can use a file you provide instead of generating one, and in Edit project you can replace any image, add your own picture or add a video clip that plays in an image's place. See [Editing a Project](Editing-a-Project#edit-images).
+Yes. Stages can use a file you provide instead of one made by AI, and in **Edit settings** you can replace any image, add your own picture or add a video clip that plays in an image's place. See [Editing a Project](Editing-a-Project#edit-images).
 
 ### What happens if I close the browser while a video is being made?
 
@@ -90,7 +90,7 @@ Yes, within 30 days. Open Settings → **Backup & storage** → **Trash** and pr
 
 ### Are captions free?
 
-Yes. Captions are timed from your narration on your computer, with no paid API. See [Video Editing](Video-Editing#subtitles).
+Yes. Captions are timed from your narration on your computer, at no cost. See [Video Editing](Video-Editing#captions).
 
 ### Can Slopify make videos in other languages?
 
@@ -100,7 +100,7 @@ Yes, with some differences in captions and cuts for languages without word timin
 
 ### Does Slopify upload to YouTube for me?
 
-No. Slopify never uploads or publishes anything. **Prepare upload** lays out the file, title, description, thumbnail, playlist, audience, AI use and tags in the order YouTube Studio asks for them, each with a copy button. The optional Studio browser extension fills in the Studio form for you; you check it and press Publish yourself. **Mark uploaded** records that you did. See [Publishing to YouTube](Publishing-to-YouTube) and [Studio Extension](Studio-Extension).
+No. Slopify never uploads or publishes anything. **Copy for YouTube Studio** lays out the file, title, description, thumbnail, playlist, audience, AI use and tags in the order YouTube Studio asks for them, each with a copy button. The optional Studio browser extension fills in the Studio form for you; you check it and press Publish yourself. **Mark uploaded** records that you did. See [Publishing to YouTube](Publishing-to-YouTube) and [Studio Extension](Studio-Extension).
 
 ### Does it make Shorts too?
 
@@ -118,17 +118,17 @@ Slopify is meant to be used on the computer it runs on. You can change the addre
 
 ### How do I update?
 
-Press the circular-arrows button at the foot of the sidebar, or run `npx @gentbajko/slopify@latest update` while Slopify is running. It waits for running work, keeps a copy to go back to, and puts the previous version back if the new one does not start. See [Updating and Patch Notes](Updating-and-Patch-Notes).
+Press **Update ready** in the rail (or **Help → Check for updates**), or run `npx @gentbajko/slopify@latest update` while Slopify is running. It waits for running work, keeps a copy to go back to, and puts the previous version back if the new one does not start. See [Updating and Patch Notes](Updating-and-Patch-Notes).
 
 ### Something is broken. What should I send?
 
-Open Settings and press **Download diagnostics**. The file lists your Slopify, system and Node versions and which providers are set up, never your keys, prompts or project content. Attach it to your bug report. See [Troubleshooting](Troubleshooting).
+Press **Download diagnostics** at the foot of Settings → **About** (or in the **Help** menu). The file lists your Slopify, system and Node versions and which services are set up, never your keys, prompts or project content. Attach it to your bug report. See [Troubleshooting](Troubleshooting).
 
 ## Related pages
 
 - [Troubleshooting](Troubleshooting)
 - [Recovery and Retries](Recovery-and-Retries)
-- [Providers and Keys](Providers-and-Keys)
+- [Keys and Services](Providers-and-Keys)
 - [Costs and Run Cost](Costs-and-Run-Cost)
 - [Where Your Files Live](Where-Your-Files-Live)
 - [Publishing to YouTube](Publishing-to-YouTube)