Не стіна з + і −.Зміни на відмальованій сторінці.

Чому порядковий diff погано читається для прози

Порядковий diff порівнює текст рядок за рядком. У коді це працює, бо рядок — одиниця змісту. У документі ні: абзац часто йде одним довгим рядком, тож через одне слово весь абзац показується видаленим червоним і доданим зеленим. Те саме трапляється, якщо абзац перенести інакше. У підсумку ви шукаєте те єдине слово, яке змінилося.

З таблицею ще гірше. Змінена клітинка — це змінений рядок із вертикальних рисок і дефісів. А хочеться бачити відмальовану таблицю з позначеним зміненим рядком.

DotMD показує різницю на сторінці, яку ви читаєте: заголовки, абзаци, пункти списків, блоки коду й рядки таблиць, додані зеленим, видалені червоним і закресленими.

Відкрийте історію версій

Натисніть кнопку ⑂ на панелі інструментів, ⌥⌘Y або виберіть File → Show Version History. Вікно перемикається в режим історії, як у Google Docs. Версії перелічено за днями праворуч, угорі Current version. Вибрану версію показано відмальованою замість сторінки, з виділеними змінами відносно попередньої.

• Highlight changes вимикає кольори, щоб побачити версію такою, якою вона була.
• Restore повертає вибрану версію. Поточний текст перед цим зберігається як версія, тож відновлення можна скасувати.
• Done (⌘↩) виходить із режиму історії.

Версії зберігаються як знімки: коли ви додаєте теку, коли запускається DotMD, коли інший застосунок, наприклад ШІ-агент, git чи інший редактор, змінює файл, і коли ви відкриваєте файл, залишаєте його або завершуєте редагування. Старіші проріджуються, як у Time Machine, не більше 200 на файл. Історія — це зручність, а не резервна копія.

Відкотіть одну правку, решту залиште

Відновлення версії повертає весь файл. Часто потрібно менше: залишити новий текст, крім одного абзацу. З DotMD Reviewer у поточній версії кожен змінений блок показано як старий текст червоним просто над новим текстом зеленим.

1. Позначте, що відкотити

   Наведіть на правку й натисніть ↩ Revert на її червоному тексті. В абзацу, який тільки додано, натомість ✕ Remove. Сторінка показує, як усе виглядатиме.

2. Застосуйте

   Натисніть Apply Reverts. Файл записується з відкотом лише цих правок, решта лишається. Cancel знімає позначки. Попередній текст зберігається як версія, тож і це можна скасувати.

Після редагування файлу ШІ-агентом

Файли, які інший застосунок змінив від вашого останнього відкриття, отримують у бічній панелі помаранчеву крапку. Відкрийте такий файл, і DotMD одразу перейде до його змін, виділивши все з вашого останнього перегляду. Якщо відкритий файл змінюється, банер повідомляє, скільки рядків додано й видалено, а Show Changes відкриває порівняння.

Коли ви перевіряєте виправлення агента за вашими коментарями, зміни показано поруч із кожним коментарем, а правки, про які не просив жоден коментар, рахуються як other changes. Саме там ховаються сюрпризи агента. Див. Перевірка змін.

Git diff чи DotMD?

Git використовуйте для рев’ю коду в pull request: для цього й потрібен порядковий diff. DotMD використовуйте, щоб прочитати, що змінилося в документі: у специфікації, плані, README, порівняльній таблиці. Вони не конкурують. DotMD не потрібен репозиторій, і він ловить також зміни, які так і не були закомічені.

Запитання про diff Markdown

Інші запитання