Сторінка привітання
Сторінка привітання — власна сторінка Aggrega в окремій вкладці редактора, яка пояснює, що таке Aggrega, а потім перелічує, що потрібно розширенню в цій робочій області, позначаючи кожну умову як Met або To do. Кожен крок пропонує спосіб створити потрібне й спосіб указати на те, що у вас уже є, пояснює умову, а вже виконаний крок ні про що не питає. Крок із позначкою Met повертається до To do, якщо його умова перестає виконуватися. Уже виконаний крок відкривається згорнутим, тож сторінка відкривається на роботі, що лишилася. Кожен крок також показує своє поточне значення — корінь робочої області, компілятор, Release, реєстри, — набране більшим і жирнішим за пояснення, з попереднім Selected:, під заголовком, коли крок згорнуто, і безпосередньо над кнопками, коли розгорнуто, а якщо ви ще нічого не вибрали, каже про це словами — None selected., коли вибрати є з чого, None available., коли вибирати взагалі нема з чого. Унизу розташовано прапорець, який визначає, чи відкривається сторінка під час запуску, — той самий перемикач, що й на екрані налаштувань, — під ним версії розширення й компілятора, які у вас запущено, і останнім — чи запущено мовний сервер і яку версію він повідомляє. Значок будиночка в заголовку панелі Commands будь-коли знову відкриває сторінку. Вона не займає місця в поданні Aggrega.
Welcome to Aggrega! відкривається в окремій вкладці редактора. Вона пояснює, що таке Aggrega, а потім перелічує, що потрібно розширенню у відкритій вами робочій області:
- Робоча область, яку розпізнає Aggrega, — виявлення, описане в розділі Передумови.
- Компілятор, який може запустити цей редактор, — двійковий файл
aggrega, зазначений уaggrega.server.binaryPath. - Release, з яким потрібно працювати, — збирання, попередній перегляд і граф топології працюють кожен з однією сутністю Release.
- Реєстр, з якого виконується розв’язання, — отримання залежностей і пошук в опублікованому каталозі виконують розв’язання за реєстрами, зазначеними у вашій конфігурації.
Кожен крок пояснює, для чого потрібна умова і як редактор її виконує, тож сторінка — це місце, де можна прочитати про продукт, а не лише контрольний список.

Кожен крок пропонує більше ніж один шлях, і один із них завжди — «у мене це вже є». Можна створити конфігурацію робочої області або вказати редакторові теку, у якій вона вже є; використати компілятор із вашого PATH, вибрати збірку, яка лежить у вас деінде, або завантажити її; створити чернетку Release або вибрати один зі своїх; заповнити офіційний хаб, указати власний реєстр або додати реєстр до вже наявної конфігурації. Тут немає глухих кутів, які видають вам діалог вибору файлу й лишають крок невиконаним.
Уже виконаний крок позначено галочкою, і він ні про що не питає. Сторінка зчитує фактичний стан, а не ставить усім ті самі запитання, тож якщо ви створили конфігурацію з командного рядка, а потім відкрили редактор, усі кроки будуть уже позначені.
Кожен крок згортається, і сторінка відкривається, показуючи те, що ще потрібно. Стрілка в правому верхньому куті кожного кроку розгортає і згортає його. Крок, умову якого вже виконано, відкривається згорнутим, а невиконаний — із поясненням перед вами, тож читати доводиться про роботу, яка ще лишилася, а не про виконану. Згорнутий крок зберігає свій заголовок і всі свої кнопки та приховує лише пояснення: коли ви знаєте, для чого потрібен крок, ви можете виконати його, не перечитуючи.
Розташування визначається під час створення сторінки, а після цього ним розпоряджаєтеся ви. Крок, умова якого виконується, поки ви його читаєте, оновлює свою позначку й лишається розгорнутим — він не згортається під вашим курсором, — а натиснута вами стрілка лишається в тому положенні, у яке ви її встановили, скільки б разів сторінка навколо неї не оновлювалася. Закриття й повторне відкриття сторінки наново зчитує умови, і розташування визначається наново. Те саме відбувається зі сторінкою, яка малюється замість відкритої, коли редактор перезапускає розширення, — як це буває під час додавання теки до вікна, відкритого на одній теці: попередню сторінку закривають, а нову малюють у тій самій групі вкладок, незалежно від того, чи налаштовано сторінку на відкриття під час запуску, тож у вікні й далі одна сторінка, і ця сторінка стежить за робочою областю, у якій ви перебуваєте.
Кожен крок також показує своє поточне значення, тож сторінка відповідає на запитання який саме, а не лише чи є: корінь робочої області, компілятор, Release і реєстри, оголошені в конфігурації. Значення набрано більшим і жирнішим за пояснення навколо, бо значення, набране тим самим накресленням, що й суцільний текст, доводиться шукати. Згорнутий крок показує його під заголовком, тож ви можете підтвердити свій вибір, нічого не розгортаючи; розгорнутий — наприкінці пояснення, безпосередньо над кнопками, де воно читається останнім перед дією. Вибраному значенню передує Selected:, набране меншим і світлішим за саме значення, щоб мітка вказувала на значення, а не змагалася з ним.

Якщо ви ще нічого не вибрали, крок каже про це словами, а не лишає порожній рядок, який виглядав би як збій відображення сторінки, — і розрізняє два стани, на які читач реагує по-різному. None selected. означає, що вибрати є з чого, але нічого не вибрано. None available. означає, що вибирати тут взагалі нема з чого, тож натискання на «I already have one» цього кроку показало б лише порожній список, а вам потрібен інший шлях цього кроку. Показати None available. можуть лише два кроки, які пропонують список, — робоча область і Release. Компілятор зазначається за ім’ям, а реєстр реєструється безпосередньо, тож жоден із цих кроків не має списку, який міг би виявитися порожнім. Крок реєстру має третій стан, Not read yet., на випадок, коли компілятор не вдалося опитати: повідомити, що ви нічого не налаштували, коли відповісти не було кому, означало б сказати більше, ніж знає сторінка.
Позначка кроку стежить за його умовою в обох напрямках. Поруч із позначкою кожен крок словами вказує свій стан — Met або To do, — бо сама позначка є гліфом, а гліф сам по собі лишає своє значення на здогад. Крок показує Met, коли його умова стає істинною, і знову To do, якщо умова пізніше перестає виконуватися, — компілятор перестає відповідати, вибір Release скасовується. Сторінка під час кожного оновлення зчитує фактичний стан, а не запам’ятовує те, що колись було істинним, тож вона ніколи не повідомляє про те, що ви відтоді втратили. Там, де втрата важлива, про неї також повідомляється там, куди ви вже дивитеся: рядок стану показує компілятор, який перестав відповідати, а рядки Project folder, Aggrega workspace і Release у верхній частині панелі Commands називають поточний вибір.
Це звичайна вкладка редактора, а не діалог, і так зроблено навмисно: кожен крок просить вас указати на щось у вашій робочій області, а діалог закривав би файли, у яких містяться відповіді. Вона розташована в області редактора, а не в поданні Aggrega, тож не займає місця на бічній панелі й може розповісти, що являє собою продукт, — для чого у вузькій колонці немає місця. Це власна вкладка Aggrega, яка відкривається й закривається за власними правилами і не пропонує переходу на власну сторінку привітання редактора.
Це рішення розташоване внизу сторінки, по центру, а також у палітрі команд. Обидва місця змінюють одне й те саме налаштування, aggrega.getStarted.show, що записується до ваших власних налаштувань — ніколи не до репозиторію, тож ваш вибір не переходить до тих, хто ще його відкриє. Елемент керування внизу — прапорець із написом Show Aggrega welcome page on startup, установлений, поки сторінка відкривається під час запуску, — тож він показує налаштування в його поточному стані, а не пропонує вам дію, яка б його змінила. Вимкніть його на екрані налаштувань — прапорець підлаштується; натисніть прапорець — підлаштується екран налаштувань. Це один перемикач у двох місцях, а не два перемикачі. Після натискання прапорець зберігає фокус клавіатури, тож клавіша Space почергово встановлює й знімає його.
Вимкнення лише припиняє відкриття сторінки під час запуску, а не робить її недоступною, і це не двері в один бік: Aggrega: Get started у палітрі команд знову вмикає налаштування й відкриває сторінку, а Aggrega: Stop opening the welcome page on startup — власний шлях палітри до того самого налаштування.
На панелі Commands поруч із шестернею є шлях назад до сторінки. Це значок будиночка в правому верхньому куті, і його спливна підказка — Open the welcome page, — тож шлях назад до сторінки можна знайти, поглянувши на подання Aggrega, а не треба знати, що ввести. Він відкриває сторінку й лишає ваше налаштування запуску саме таким, яким ви його задали: повторний перегляд сторінки не вмикає його знову. Це робить команда палітри, бо знову ввімкнути налаштування — це рішення, а не побіжний погляд.
Унизу сторінки показано, що у вас запущено. Там два показники версії: Extension — яку збірку цього розширення завантажив ваш редактор, і Compiler — що про себе повідомляє двійковий файл aggrega, запущений мовним сервером. Показник Extension записується під час збирання розширення, за станом його вихідного коду в той момент, у тому самому вигляді, у якому власна збірка компілятора записує свою версію, — тож вікно розробки, встановлена копія і копія, запакована зі зміненого дерева, кожна повідомляють, чим вони є:
- лише тег випуску, наприклад
0.2.0, означає, що збірка — саме цей випуск; - тег, за яким ідуть число й коміт, наприклад
0.2.0-3-g1a2b3c4, означає збірку з коміту1a2b3c4, через три коміти після цього випуску, — а лише коміт, наприклад1a2b3c4, означає збірку з цього коміту, якому не передує жоден випуск; - суфікс
-dirtyу будь-якого з них означає, що збірку зроблено з копії вихідного коду з незафіксованими змінами; devозначає, що збірку зроблено там, де історію вихідного коду прочитати не вдалося.
Жоден із показників не записано в сторінку — обидва зчитуються під час відображення сторінки, тож збірка для розробки повідомляє про себе як про таку, а не показує порожнечу, а перезапуск на іншому компіляторі змінює показник. Якщо показник отримати неможливо — розширення зібрано без запису про те, яка це збірка, запитати нема кого, бо нічого не запущено, або запущене не відповіло, — мітка лишається й повідомляє, що версію не повідомлено, тож відсутній показник ніколи не сприймається за той, якого ви не помітили.
Останній рядок сторінки повідомляє, чи запущено мовний сервер і яка це збірка. Він показує Language server running, starting, not running або failed to start — тими самими словами, що й рядок стану та сповіщення; failed to start означає, що остання спроба запуску завершилася невдачею і відтоді нічого не запускалося. Причину повідомляє канал виводу Aggrega, а також сповіщення, яке з’являється, коли не вдається перший запуск або перезапуск. Поки сервер працює, рядок додає версію, яку запущений сервер повідомив про себе, коли розширення до нього підключилося, записану так само, як версію записує показник Compiler. Показник Compiler над ним — це інший факт: це те, що повідомляє на запит двійковий файл, з якого було запущено сервер, і вони відрізняються, коли файл за цим шляхом замінюють, а запущений з нього сервер продовжує працювати, тож сторінка показує обидва. Мовний сервер, який не повідомляє власної версії, показує там version not reported, а не запозичує версію двійкового файлу. Рядок і два показники над ним стежать за сервером, коли він запускається, зупиняється, перезапускається або завершується збоєм, без повторного відкриття сторінки; кроки зберігають свої позначки під час перезапуску.