Придумал простой способ добавить себе напоминалки о чём-то, что нужно сделать, глядя в консоль — прямо в консоль.

Полноценный японский «танка» на UML

Они помогают что-то объяснять и окружающим, и самому себе — это отличная лопата для анализа требований, от которых начинается тест-дизайн, где надо всё учесть, ничего не упустить, из ничего выявить неправильное или неоднозначное. Анализ рулит!

Рисовать их можно и на обоях, и в не очень удобном LibreOffice Draw, в MS Visio (не щупал уже сто лет), и в опенсорсном Modelio, и в браузерном draw.io. Там надо тыкать курсором по иконкам и стрелочкам, перетаскивать их по экрану и соединять в логичном порядке, после чего сохранить в виде картинки, которую надо вставить в свою документацию. И хорошо, если это надо сделать только один раз и картинка маленькая. Как правило, что-то надо поменять, или полотно диаграммы становится очень большим, на несколько экранов во все стороны — и там всегда надо что-то менять. Снова надо сгенерировать картинку, снова надо её прикрепить к странице и вставить в нужное место.

Есть другое решение — диаграммы можно не рисовать, а прямо в режиме редактирования документа в Notion (или в Confluence, или в IDE умного разработчика) в plain text с разметкой Markdown расписывать узлы диаграммы и связи между ними, а обновленная диаграмма автоматически перерисовывается. LaTeX way!

Проект называется Mermaid (русалка), работает на JavaScript, подключается как плагин в Confluence или Notion, в средах разработки, и даже в Jupyter notebook. Потыкать в свободном режиме — https://mermaid.live

Диаграмм в Mermaid множество: Class Diagram, Entity Relationship Diagram, User Journey, Gantt, Pie Chart, Quadrant Chart, Requirement Diagram, Gitgraph (Git) Diagram, C4 Diagram, Mindmaps, Timeline, Zenuml, Sankey, XYChart, Block Diagram. Cамые ходовые три:

1. Блок-схема (Flowcharts)
2. Диаграмма состояний (State diagram)
3. Диаграмма последовательности (Sequence diagram)

Mermaid в Notion

В Notion (не наш выбор, но и там есть жизнь) блок с мермайдом вызывается командой, которую можно даже не дописывать:

Получаем поле с представлением «Split» — сверху код, а внизу результат его правильной работы:

Когда дело сделано, разумно переключить отображение содержимого блока на «Preview», чтобы не пугать прожект-манагера непонятными буковками.

Блок-схема

Она же Flowchart. Документация по ней подробна и адекватна.

Блок-схема состоит из узлов (геометрических фигур) и ребер (стрелок/линий), и объявляется непременно с направлением развёртывания — сверху вниз (TD) или слева направо (LR):

Пример:

flowchart TD
S(Простая последовательность шагов)
--> id1(Самурай всё понимает)
--> E(Разговор исчерпан)

S — Start.

E — End.

Между ними можно расположить сколько угодно узлов. Называть их можно буквами любого алфавита, который есть в кодировке UTF-8, от «id1, id2, id3» до «самурайУмничает».

Сплошные управляющие стрелки (рёбра) указываются так:

-->

Стрелка с прерывистой линией:

-.->

Стрелку можно ставить перед узлом, а можно после. Мне удобнее воспринимать их в начале строки.

Стрелками можно связывать не только на каждый следующий узел, но и непоследовательно прыгать к любым другим узлам. Например, можно связать id3 с id1:

flowchart TD 
  S(Простая последовательность шагов) 
  --> id1(Самурай всё понимает) 
  --> id2(Невод закинут в море) 
  -.-> id3(Дед, ну ты дурак? ©) 
  --> id1 
  --> E(Разговор исчерпан)

Ещё есть комментарии — через «два символа процента»:

%%{init: {"flowchart": {"htmlLabels": true}} }%%

Форматирование узлов на блок-схеме

Их форма задаётся скобками.

flowchart TD 

S[\Простая последовательность шагов/]
 --> id1{Самурай всё понимает}
 --> id2[Невод закинут в море]
 -.-> id3(Дед, ну ты дурак? ©) 
-.-> id2 
--> E[/Разговор исчерпан\]

Комментарии на стрелках

flowchart TD 

S[\Простая последовательность шагов/] 
--> id1(Самурай всё понимает)
-.-> |размахнувшись| id2(Невод закинут в море)
--> E[/Разговор исчерпан\]

Пометить узлы разными цветами

Для этого надо объявить классы сущностей через ’classDef’, а там чистый CSS, поэтому названия или коды цветов надо взять из htmlcolorcodes.com

flowchart TD

classDef decisionPoint color:black,stroke:DarkOrange,fill:Snow,stroke-width:1px,text-align:left;
classDef startPoint color:black,stroke:White,fill:#93e4e6,stroke-width:1px,text-align:left;
classDef endPoint color:gold,stroke:White,fill:black,stroke-width:1px,text-align:left;

S[\Простая последовательность шагов/]:::startPoint
--> id1(Самурай всё понимает)
--> id2[Невод закинут в море]:::decisionPoint
-.-> id3(Дед, ну ты дурак? ©)
--> id2
--> E[/Разговор исчерпан\]:::endPoint

Затем применить классы к узлам через три двоеточия.

Не надо излишне увлекаться раскрасками. Стартовый и эндовый узлы лучше пометить не цветом, а формой узла через наклоны обрамляющих слэшей:

[\ старт /] и [/ финиш \]

Цвета, если действительно надо применять, следует подобрать неяркие. Учесть, что кто-то будет смотреть это всё в darkMode.

Поменять размер шрифта одного из узлов

Через управляющие команды CSS:

classDef decisionPoint font-size:0.9em,color:black,stroke:DarkOrange,fill:Snow,stroke-width:1px,text-align:left;

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

Просто переносим буквы/слова внутри узла на новую строку. В моем примере каждая новая (перенесенная) строка начинается с булита — это необязательно, просто выглядит как список на слайде. Кавычки вроде нужны, а на деле не обязательны.

flowchart TD 

classDef leftAlign font-size:0.9em,color:black,stroke:DarkOrange,fill:Snow,stroke-width:1px,text-align:left; 

S[\Простая последовательность шагов/]
 --> id1(Самурай всё понимает)
 --> listOfEvents("•  Некуда спешить
• Не о чём думать
• Начинается дождь"):::leftAlign
 --> id2[Невод закинут в море]
E[/Разговор исчерпан\]

Тут под произвольным именем ’newLines’ было задано соединение нескольких узлов в один общий узел. А это значит, что можно заранее соединять узлы в отдельные ветки… тааакое можно наворотить!

Разместить на одной диаграмме несколько самостоятельных ветвей

…между которыми связующих звеньев вообще может не быть — это глупо, но возможно. Или можно задать связи между ними в нелинейном сочетании:

flowchart TD

classDef leftAlign font-size:0.9em,color:black,stroke:DarkOrange,fill:Snow,stroke-width:1px,text-align:left;

biblioteka["Понял в тишине библиотеки"]
apple["Яблоки на снегу"]
gameOver["Демоны спёрли дыхание"]
bookIsClosed["Книга недолго открыта"]
listOfEvents("• Некуда спешить
• Не о чём думать
• Начинается дождь"):::leftAlign

apple 
--> biblioteka 
--> listOfEvents

S[\Происходит жизнь/]
--> id1(Самурай всё понимает)
--> id2[Невод закинут в море]
--> listOfEvents
--> E[/Разговор исчерпан\]

id1
--> gameOver
--> bookIsClosed

Вполне можно свести узел «Книга недолго открыта» к финишу, прописав последней командой „—> E”, но это необязательно, некоторые процессы вполне самостоятельно могут закончиться «ничем».

Диаграмма последовательности

Она же Sequence diagram.

Это предпочитают программисты — удобно показать, как процессы взаимодействуют друг с другом и в каком порядке.

sequenceDiagram

Jules->>+Brett: What does Marsellus Wallace look like?
Brett-->>+Jules: …What?
Jules->>+Brett: ENGLISH, MOTHERFUCKER! DO YOU SPEAK IT!?
Brett-->>+Jules: Yes!!
Jules->>+Brett: DESCRIBE WHAT MARSELLUS WALLACE “LOOKS” LIKE!
Brett-->>+Jules: Wha-what I—?
Jules->>+Brett: SAY "WHAT" AGAIN! I DOUBLE-DARE YOU, MOTHERFUCKER!! SAY "WHAT" ONE MORE GODDAMN TIME!
Brett-->>+Jules: H-H-He's black...
Jules->>+Brett: Go on!
Brett-->>+Jules: ...He's bald...!
Jules->>+Brett: Does he look like a bitch?!
Brett-->>+Jules: What? 
Note over Jules,Brett: shoots Brett in the shoulder
Jules->>+Brett: DOES! HE! LOOK! LIKE! A BITCH?!?!
Brett-->>+Jules: NO!
Jules->>+Brett: Then why'd you try to fuck him like a bitch, Brett?
Brett-->>+Jules: I didn't...!
Jules->>+Brett: Yes, you did! YES, you DID, Brett! You tried to fuck him!

Pulp Fiction in action

Акторов может быть множество, переходы между ними тоже доступны в разных сочетаниях.

Разумно рисовать от одного актора только сплошные стрелки, а от другого только прерывистые.

Неразумно рисовать в таком стиле длинные диаграммы.

Также программисты используют рисование диаграмм через LiveScript с аналогичными возможностями:

sequenceDiagram
  actor Customer
  participant Checkout
  participant DB

  Customer->>+Checkout: Request checkout page
  Checkout->>+DB: /api/settings

и так далее по той же схеме.

Диаграмма состояний

Она же State diagram — диаграмма, которая описывает поведение систем. Ты видел её в книге Коупленда про тест-дизайн.

Всё чётко, да?

Эта диаграмма — учебная, кривая, неправильная:

Note that the diagram is still incomplete. No arrows and bulls-eyes emerge from the Cancelled states. Perhaps we could reinstate a reservation from the Cancelled NonPay state. We could continue expanding the diagram to include seat selection, flight cancellation, and other significant events affecting the reservation but this is sufficient to illustrate the technique.

© Lee Copeland

А она неправильная. Просто для экономии бумаги три перехода сведены к одному и тому же (Cancelled ByCust), а в норме это надо выводить в отдельные (тупиковые) ветви. Иногда даже из тупичка может произойти обратное действие, и если через всё пространство протягивать стрелки в одно и то же место, то через какое-то время диаграмма покрывается паутиной метаний от одного узла к другому… ох.

Её надо пересоставить в более адекватном порядке, но для разгона попробуем воссоздать как есть, сведём выход из нескольких узлов в один Cancelled ByCust:

stateDiagram-v2

[*] --> Made : giveInfo/startPayTimer
Made --> Cancelled_NonPay : PayTimer_expired
Made --> CancelledByCust : cancel
Made --> Paid : payMoney 
Paid --> CancelledByCust : cancel/Refund
Ticketed --> CancelledByCust : cancel/ReturnTicket/Refund
Paid --> Ticketed : print/Ticket
Ticketed --> Used : giveTicket
Used --> [*]

Важно: названия узлов должны быть представлены одним словом. Пробел между ними принудительно создает новый узел. Решение — отдельно создать переменную узел с условным названием и содержимым в виде слов с пробелом. Например:

stateDiagram-v2

CancelledByCust: Cancelled by Customer
Cancelled_NonPay: Cancelled when payTimer expired

[*] --> Made : giveInfo/startPayTimer 
Made --> Cancelled_NonPay : PayTimer_expired 
Made --> CancelledByCust : cancel 
Made --> Paid : payMoney 
Paid --> CancelledByCust : cancel/Refund 
Ticketed --> CancelledByCust : cancel/ReturnTicket/Refund 
Paid --> Ticketed : print/Ticket 
Ticketed --> Used : giveTicket Used --> [*]

Раз уж название каждого узла — это его уникальный идентификатор, придется все эти ответвления в «CancelledByCustomer» сделать уникальными через нумерацию. Заодно пометим цветом happyPath и отхождения от него:

stateDiagram-v2

classDef happyPath font-size:1em,color:black,stroke:DarkOrange,fill:palegreen,stroke-width:1px,text-align:left;
classDef negativeScenario font-size:1em,color:black,stroke:DarkOrange,fill:IndianRed,stroke-width:1px,text-align:left;

[*] --> Made:::happyPath : giveInfo/startPayTimer
Made --> Cancelled_NonPay:::negativeScenario : PayTimer_expired
Made --> CancelledByCustomer_1:::negativeScenario : cancel
Made --> Paid:::happyPath : payMoney 
Paid --> CancelledByCustomer_2:::negativeScenario : cancel/Refund
Ticketed --> CancelledByCustomer_3:::negativeScenario : cancel/ReturnTicket/Refund
Paid --> Ticketed:::happyPath : print/Ticket
Ticketed --> Used:::happyPath : giveTicket
Used --> [*]

Можно задать направление этой диаграммы по-горизонтали, но это воспринимается неудобно:

direction LR

Намутить тест-кейсы по этим путепроводам

Дёрнем chatGPT с задачей перемножить все эти блямбы между собой.

Для stateDiagram псевдоинтеллект выдал такое:

1. TC1: Complete Payment and Print Ticket
   • Initial State: [*]
   • Action: giveInfo/startPayTimer
   • Result: Made
   • Action: payMoney
   • Result: Paid
   • Action: print/Ticket
   • Result: Ticketed
   • Action: giveTicket
   • Result: Used
   • Final State: [*]
2. TC2: Complete Payment and Use Ticket
   • Initial State: [*]
   • Action: giveInfo/startPayTimer
   • Result: Made
   • Action: payMoney
   • Result: Paid
   • Action: print/Ticket
   • Result: Ticketed
   • Action: giveTicket
   • Result: Used
   • Final State: [*]

И так далее.

Уберем детали:

Happy Path Test Cases

1. TC1: Complete Payment and Print Ticket
2. TC2: Complete Payment and Use Ticket

Negative Scenario Test Cases

1. TC3: Payment Timer Expired
2. TC4: Cancelled by Customer Before Payment
3. TC5: Cancelled by Customer After Payment
4. TC6: Cancelled by Customer After Ticket Printed

Кхм… Позитивные тесты — отдельно напечатать билет и отдельно его использовать — ну-ну. Тебе же говорили, что диаграмма неадекватная и требует пересмотра?

А отклонения от happyPath ПИ считало норм.

Хорошо бы ещё навостриться прописывать основу для диаграмм, из которой chatGPT мог бы генерировать код для самих диаграмм, и тогда можно ускориться ещё сильнее.

Туториалы по Mermaid

Их таки есть, вот два самых наглядных:

и

Файл с примерами из второго видео — mermaid.md

ZIM

Любопытно, что в вики-редакторе Zim тоже есть модуль «Вставка диаграмм» (ему нужен GraphViz), который работает по тому же принципу — пишем словами, видим диаграмму. Редактирование диаграммы включается даблкликом по ней.

Вольное последумие

Диаграммы как сапёрные лопатки, отлично помогают только там, где они уместны. Нельзя сводить представление всех сложных абстракций только к диаграммам. Надо уметь всё объяснять и рисунками, и текстом, и видео.

© Джеральд Вайнберг, книга «Exploring Requirements — quality before design» (1989), подглава «1.4 Making Sure That Everyone Can Read the Map»:

Proponents of each notation claim that their maps are “intuitive” and ”easy to read”. These statements are true in the same sense that Chinese is intuitive — in Beijing. Virtually any notational system becomes intuitive after someone has spent a lot of time working with it.

Как только диаграмма объяснила одну идею, её надо немедленно оставить в покое и не усложнять — рисуй новые.

Генеративные сервисы надо держать под пристальным, недоверчивым присмотром, бо оно тебе нагенерирует, лишь бы ты был хоть немного счастлив. Если в череде шагов не будет чего-то очевидного, то GPT ничем не поможет, оно будет работать только с тем, что ему передал нерадивый тестировщик.

По-дефолту звуки, которые издает Teams на смартфоне раздражают даже мëртвого Имхотепа — имхо, конечно, да кабы у него был смартфон, коий ему не дадут.

Их можно отключить ВООБЩЕ, но иногда таки надо получать сообщения из этой навязанной корпорациями шняжки, поэтому еë не заткнуть.

Но как тут поменять звук-то?!?!?!?

А вот так:

В приложении Teams тыкнуть по иконке своего аккаунта,
-> Settings (Настройки)
-> Notifications (Уведомления)
-> General activity (Общие действия)
-> Chats (Чаты)
-> Без звука
Или же можно выбрать другой звук, например, тишину.

• 14$ за просмотр видео (стриминг)
• 20$ за возможность скачать видео)

Анадысь я сбегал на один его открытый стрим про историю и будущее языков программирования и получил за это такое письмо

Thanks for attending Uncle Bob’s webinar, The Future of Programming Languages! Use the following code to redeem a free streaming episode of your choice from cleancoders.com…

Я выбрал видео самым близким мне названием «Test Design»

Clean Code: Advanced TDD, Episode 21

56 minutes • 1.00GB • Aug 2013

https://cleancoders.com/episode/clean-code-episode-21

Редим-код как раз на 14$, поэтому я положил в корзину «стрим» и купил видео на просмотр бесплатно, на условиях продавца, легально и законно.

Но я хочу это видео скачать бесплатно без регистрации и смс. Что делать?

Найти источник видео

Ввиду того, что меня никто не просил всё это делать, и вообще это всё мамкино кулхацкерство для обучения неофитов, все уникальные символосочетания в ссылках и на скриншотах заменены/замазаны.

И вообще все ссылки резко сокращены, бо всё равно это условности.

Firefox: F12 > Сеть > Медиа (это фильтр, собственно). Тыкнуть по какому-нибудь источнику в списке полученных ответов и выбрать для него режим просмотра Headers (Заголовки).

Chrome: F12 > Сеть > XHR (или фильтруем по All, разница несущественная). Тыкнуть по какому-нибудь источнику и выбрать для него режим просмотра Headers (Заголовки).

В общем, что хром, что по лбу — видим повторяющиеся URL типа https://videos-cloudflare.jwpsrv.com/content/conversions/abcdef123456/videos/NVGldаRq-2327О335.mp4-67.ts — отсюда далее представляем их в виде

https://videos/NVGldаRq-2327О335.mp4-1.ts
https://videos/NVGldаRq-2327О335.mp4-2.ts
https://videos/NVGldаRq-2327О335.mp4-3.ts
…

Следовательно, видео приходит в браузер кусками/частями в виде ts-файлов, которые принадлежат какому-то большому файлу с названием «NVGIdаRq-2327О335.mp4» и пронумерованы логично и последовательно.

Прокрутил я это видео дяди АнклБоба в конец и посмотрел в логе номер последней прилетевшей части — «848.ts» — всего-то файлов скачать. Оукей, «Челленджер» акксепдет.

Хотя, мы уже знаем имя файла (NVGldaRq-23270335.mp4). Так поскорее же

wget https://videos/NVGldаRq-2327О335.mp4

Однако в ответ приходит

403 Forbidden
2020-09-27 23:59:22 ОШИБКА 403: Forbidden.

Нда? Ну, тогда надо

Упорядочить добычу

Чтобы получить ВСЕ ссылки на ВСЕ эти файлы, их надо инкрементально размножить. Для этого можно выучить, наконец, Python, или можно зайти в Excel. Ладно, у меня

LibreOffice Calc

И в первую колонку положим общий шаблон

https://videos/NVGldаRq-2327О335.mp4-
https://videos/NVGldаRq-2327О335.mp4-
https://videos/NVGldаRq-2327О335.mp4-

А во вторую — инкремент

1.ts
2.ts
3.ts

Достаточно трёх строк. Ухватили край третьей ячейки курсором и потянули вниз, пока не мелькнёт строка «848». Автоподстава безупречна.

Выделить обе колонки, Ctrl+C.

Kate

Ctrl+V. Получили вот это:

https://videos/NVGldаRq-2327О335.mp4- 1.ts
https://videos/NVGldаRq-2327О335.mp4- 2.ts
https://videos/NVGldаRq-2327О335.mp4- 3.ts
…

Kate.Замена #1 (Ctrl+R)

Убираем символы табуляции после «.mp4»

[.mp4-\t]
[.mp4-]
Режим: Управляющие последовательности
«Заменить все».

Результат:

https://videos/NVGldаRq-2327О335.mp4-1.ts
https://videos/NVGldаRq-2327О335.mp4-2.ts
https://videos/NVGldаRq-2327О335.mp4-3.ts
…

Kate.Замена #2

Убираем перенос строк

[.ts\n]
[.ts ]
Режим: Управляющие последовательности
«Заменить все».

Результат: одна длинная строка, уходящая в правую даль.

https://videos/NVGldаRq-2327О335.mp4-1.ts https://videos/NVGldаRq-2327О335.mp4-2.ts https://videos/NVGldаRq-2327О335.mp4-3.ts

Перед этой строкой дописываем настройки wget (Расшифровка: эй, wget, а поскачивай мне файлы из строки поочерёдно, и если будет отказ соединения, повторяй подключение через каждые 60 секунд):

wget -c -t 60 https://videos/NVGldаRq-2327О335.mp4-1.ts https://videos/NVGldаRq-2327О335.mp4-2.ts https://videos/NVGldаRq-2327О335.mp4-3.ts…

Ctrl+A, Ctrl+C.

В консоль

Сделать новый каталог и зайти в него.

mkdir UncleBobVideo && cd UncleBobVideo

Вставить награбленное добро с wget в голове (Ctrl+V) и запустить (Enter).

Смотрим на мельтешение строк.

Если всё ок — уходим играть «Белоруссия ждёт переименования в Беларусь» на ксилофоне, бо это надолго.

Итог скачивания файлов в Dolphin выглядит норм. Но там сортировка приближённая к естественной (в настройках Sorting mode = Natural).

В действительности всё отсортировано так, как это всегда было в DOS…

И если запихнуть все эти файлы в один плейлист в видеоплеере, то воспроизводиться всё будет именно так, как должно по машинной логике:

1.ts
10.ts
100.ts
101.ts
…

Что можно сделать:

1. или выстроить файлы в плейлисте вручную,
2. или — old school — переименовать файлы по следующему шаблону:

   001.ts

   002.ts

   …

   009.ts

   010.ts

   011.ts

   и так далее.

Возможно, отредактировать плейлист будет проще. Это же обычный текстовый файл с расширением m3u, а его содержимое — хэх, копипаст из того самого Excel идеально подойдёт (мы же его не удалили?) с удалением символов табуляции.

Ну или в консоли

ls > playlist.m3u

Чтобы получить более внятный список файлов, можно использовать ls так:

ls --group-directories-first -p -1 > playlist.m3u

Затем открыть файл playlist.m3u в Kate и вперёд, переставлять блоки текста местами. Или же копипаст из экселя, чо мудрить-то…

Теперь можно открыть этот плейлист в видеоплеере и если он будет адекватным, то можно будет смотреть череду коротких видеофайликов как один большой (50 минут).

А если раз в сутки будут разрывы между файлами — можно собрать все разрозненные файлы в один большой видеофайл, мне для этого очень норм OpenShot.

Или можно поискать какое-то сложное колдунство в консоли, бо буквально всё то, что я сделал в Calc и Kate, можно сделать в консоли, бо это же работа со строками в plain/text файлах.

И даже сборку множества видеофайлов в один можно сделать в консоли…

Итоговое соображение: всё то, что попадает в сеть, может быть скачано и использовано. Смиряемся с этим.

Сохранить полноразмерное фото из инстаграма

А теперь бесплатный лайфхак для любителей бесплатных лайфхаков. Можно сохранить полноразмерное фото из инстаграм, если воспользоваться тем же методом просмотра загружаемого контента. Иногда там файлы размером в три-пять тысяч пикселей, поэтому лечение стоит свеч.

1. Запустить в браузере «уголок веб-мастера» по [F12].
2. Открыть страницу с фотографией (иначе ничего не загрузится же), например, это https://www.instagram.com/p/CFXlAIpgU1w/

Firefox: F12 > Сеть > Изображения

Отсортировать по колонке «Размер» так, чтобы самые объёмные файлы были первыми.

Тыкнуть по первому источнику и выбрать режим просмотра Ответ.

Если картинка неподходящая — тыкаем следующий источник. Долго тыкать не придётся.

Затем даблклик по подходящему источнику — откроется новая вкладка с искомой картинкой в полном размере первоисточника.

Chrome: F12 > Network > Img

Тыкнуть по какому-нибудь источнику и выбрать режим просмотра Preview.

Общая сортировка по размеру принятых файлов и последовательное тыканье по ним — ня.

Ставьте лайки на свои колокольчики и подписывайтесь на дядибобин канал.

Мне же остаётся последний лайфхак: сделать это всё в консоли, на bash и в Python. Задача достижима (руками), следовательно, можно всё сделать не выходя из консольки.

Пик её пришёлся на 2014-ый, когда было тревожно жить и было важно знать, где прямо сейчас в Киеве опасно, чтобы знать и принимать соответствующие решения. Лента новостей была оооогромной, вперемешку свидетельства, новости, слухи, мнения. Не сразу, но почувствовал эффект «рекомендуемого контента».

И проблема не в том, что я не выбираю, что смотреть, а в том, что рекомендуемый контент «заходит» как конфетка за конфеткой, что совершенно безалабернизирует и мышление, и восприятие. Уже не думал, а только реагировал.

К чему это всё привело: организм стал требовать постоянного обновления и развлечения, а также стало сложно сосредоточиться на долгосрочных рабочих задачах. Стало сложно засесть, как когда-то, за чтение книги (або просмотр фильма) часа на два, бо вскорости начинается сучение ножками и уверения в том, что «Да я просто посмотрю в википедии модель мэшингана, из которого Джек Ричер крошит супостатов, а что такое калибр, а какой был калибр у револьверов образца 1870-х гг, а раз уж мы тут, заглянем и в…»

Лечение было неоднозначным и ещё не закончилось.

Сперва я делал эксперименты вроде «перестать нажимать на лайки», чтобы бескровно вырваться из пузыря рекомендуемого контента (раз уж целиком и сразу невозможно). Результат — так себе. Если бы механизм слежения был основан только на лайках… Но в целом вообще перестал где бы то ни было ставить лайки или реагировать эмотикончиками.

Затем перешел в режим «фигачить контент» — там же надо подумать, не? Оказывает, не, можно «фигачить контент» с высокой скоростью и частотой в любое время суток, но от безалабернизации это не спасает.

А со стороны ещё и выглядит как «весь рабочий день зависает в фэйсбуках».

Затем пошли припарки на трупе лошади: убрал приложение со смартфона. В браузере это всё менее удобно, но, к сожалению, приноровился быстро.

Затем заходил в ФБ только со смартфона. Но смартфон в офисе постоянно под правой рукой, а дома постоянно у подушки…

Уменьшил количество «друзей», снял подписку на посты всех оставшихся. В фэйсбук зайдёшь, а ничего нового нет (кагбэ), ну и уходишь. Кагбэ.

И да, на DOU ежедневно заходить нельзя. Если туда не ходить — становишься терпимее и добрее. Если наоборот, то — наоборот.

Вроде бы полегчало, стал более взвешенно воспринимать всё, что читаю, стало меньше дурацких смешных видосиков, почти перестал думать мемасиками. Почти. Клиповое мышление привязывается быстро, а отвязывается долго (если вообще отвязывается).

Потом заметил, что в ФБ не хожу, зато залипаю на совершенно ненужных видео в Youtube, например, на бесконечном мельтешении коубов. В ютюбе «заклятие рекомендованного контента» ощущается особо сильно, но тут уже пофигу, клиповое мышление укоренилось.

С торрентов стал снимать не современные, а древние фильмы, 30-х и 40-х годов (только не советские!). Вообще — другой мир. Хз, является ли это следствием, но вроде бы сон наладился.

В работе: стал много читать «с бумаги» и записывать в бумажных блокнотах, а не во всех этих ваших удобных и стильных приложениях. Заодно перешёл на дорогие канцелярские принадлежности — появились какие-то замороченные, изысканные карандаши и ручки, и сразу 30 штук толстых красно-синих кохинуровских карандашей, бо в детстве такие были, и это действительно ня!

Блокноты тоже начал было брать дорогие, бо если ресурс ограничен, кагбэ и незачем рисовать каляки-маляки впустую — для этого есть напоминалки в смартфоне. Собираешься и пишешь по-делу — коротко и лаконично (гы-гы). Все инструкции и заморочки к педалям для гитары — в золотистом толстом блокноте Leuchtturm. Все заметки к системе анализа — в чёрном «репортёрском» Leuchtturm. Все бытовые записи, которые нужны больше, чем на день — в «репортёрском» Moleskine. Весь журнал автомобиля (от лога километража до марки масел в отдельном узле) — в А4-подобном красном блокноте Leuchtturm.

Вообще, Leuchtturm — очень годный торт.

Со временем рабочими блокнотами стали шняжки вроде «небрежно разрезанная надвое тетрадь с перекидными листами на пружинке». Легко вырвать лист, легко выбросить целиком. Неотъемлемая часть рабочего стола.

И вообще, начал много писать от руки. Было… непривычно и сложно. Но помогает сосредоточиться. Рецепт, если надо в чём-то разобраться:

• бумажная книга по теме,
• наидешёвейший блокнот,
• наидорогущий карандаш.

Увеличивается фокус на теме/задаче. И скорость поиска по важному содержимому тоже.

Казалось бы, Ctrl+F быстрее, но для этого надо, чтобы текст был оформлен под эту задачу, а это увы.

В электрокнигах (коих у меня несколько сотен гигов, фигли) вроде бы тоже можно выделять отдельные абзацы/идеи и приписывать собственные заметки или закладки. Я долго сопротивлялся этому выводу, но он неизбежен — электрозаметки, коих у меня много сотен и в смартфоне, и в электрокнигах, не запоминаются и не интегрируются в обновлённое понимание.

Они существуют как-то обособленно, как монетки иностранных государств в шкатулке в шкафу. Если иногда их нарочно достать и перебирать, то что-то брезжит. Но в целом они постоянно лежат в шкатулке в шкафу, их нет. Ходовая валюта остаётся прежней — рука, бумага, карандаш.

Качество оформления текста в бумажных книгах выше, чем в электрокопиях и вообще, и в частностях, если речь идет про научный контент (тест, например, дизайн). Оттуда в фэйсбуки ходить не хочется, и смартфон, как носовой платок Канта, днём постоянно находится на кухне. Уже вин.

В Украине книги дешевле, чем в Молдове, поэтому если прочитал и «нет нужности» — можно и выбросить вынести из дома, оставить где-нибудь. Кому-то если пригодится — велкам. Ценные остаются.

В Молдове всё наобоврот (новое слово, чо). Дорогая канцелярка тут слишком дорогая. Книги — сразу нет, бо слишком дорогие. Ассортимент — ширяльный потреб, что-то ценное не найдёшь, надо заказывать из-за рубежа. Чёртова действительность окраинной губернии, нда. Хочется зайти в фыцбук и поматериццо на этот счёт.

Нынче на проекте постоянно чиркаю в блокнотах расчёты (чёртова крипта с тоннами цифр после запятой), бо надо проверять-перепроверять их правильность в приложении.

Наверное, можно всё это делать в Excel, но для этого надо переключаться между окнами в мониторе — теряется фокус. Когда-то это не было проблемой, но сегодня это чувствуется как проблема. Короче, блокнот с отрывными листами и карандаш наше всё.

Фокус получается удерживать, если приложение неподвижно в мониторе, а расчёты — в разложенных по столу бумажках с моими каракулями. Туда посмотрел, сюда посмотрел, туда, сюда. Сверился. Но если надо попереключаться между окнами — уже фэйл. Мозг ноет.

Виндовый калькулятор, конечно, норм — небольшой, висит поверх всего, клац-клац прямо с клавиатуры, две строки (введенные числа и результат расчётов). Но с ним увеличилось количество переносов взгляда между экраном и столом с бумажками. Почему-то, это ощущается. Ноет мозг.

Решил взять настольный калькулятор. Из детства у меня остался программируемый «Электроника МК-61». Всё хорошо, тепло и зелено-лампово, но экран в одну строку, и прибор работает только от розетки. Нехорошо. Моет нозг.

И с расчётами пошли сложности. То и дело надо выяснять правильность процентного соотношения (fees applied), а возраст уже такой, что мелочи отрицаются, и простые, вроде бы, формулы расчётов забываются или смешиваются. Начал подвисать на ровном месте. Выписал их себе в громадный настольный блокнот, полегчало, но это не точно. Гоез монт.

Предположил, что в современности уже должны быть калькуляторы с экранами на две строки, как в виндовом калькуляторе. И нагуглилось чудо чудное — инженерный непрограммируемый калькулятор „Casio fx-991EX” из серии ClassWiz, предназначен для будущих и бывших школьников. Поражает своей повышенной дружелюбностью и удобством проведения и перепроверки расчётов. Это затягивает. Это ВИН!

ЖК-дисплей с высоким разрешением на несколько строк, небольшая, но электронная таблица (значения сбрасываются при выключении калькулятора), расчёты с дробями, с комплексными числами, с математическими, тригонометрическими и гиперболическими функциями, преобразование координат, решение уравнений с неизвестными, вычисления с векторами, девять запоминаемых (и после выключения калькулятора) ячеек памяти под переменные, 47 физических констант и 40 метрических преобразований, warp speed, mr. Sulu!

Тот самый случай, когда надо сперва прочитать полную инструкцию (на support.casio.com), а затем уже свободно клац-клацать по клавишам. Читал я эту узкую брошюру с мелким шрифтиком, подчёркивал, экспериментировал, затем стал записывать отдельно в блокнот какие-то решения задач бытового характера на fx-991EX, вроде расчёта процентов и всякой «дорожной математики» вещи.

Обычно я делал такие расчёты по логарифмической линейке на циферблате моих наручных часов (Citizen Promaster Sky BJ7070-57E), но то вариант сугубо походный:

• на циферблате очень мелкие риски и точность расчётов слишком уж приблизительна,
• к этому всему надо приноровиться через долгую практику. Пропустил месяц-два, и всё, доставай шпаргалку и прикидывай заново, что и как крутить и накладывать, бо дело неочевидное.

С широкоэкранным калькулятором это всё несравненно удобнее.

Дело задвигалось. Сохраняется более-менее неотключаемый фокус на происходящем, чёртова крипта уже не так уж и чёртова. Warp speed five, mr. Sulu!

Ввиду самотеплоизоляции тряхнул LaTeX-ом и собрал все эти мои записки в виде краткой инструкции в pdf (Dropbox).Теперь всё то же самое воспринимается проще, бо не каракули, а высокохудожественная типографика же. Ctrl+P.

Если это всё будет полезно не только мне — welcome, рекомендую.

Ответ: надо перейти в режим «Я увольняюсь».

Нет, не уволиться, а начать вести себя так, словно ты принял решение, и уже скоро уйдёшь.

Увольняющийся всегда работает очень хорошо.

А он просто делает ровно то, что нужно, не стараясь что-то улучшить.

А он просто делает всё так, как ему было сказано. И вовремя.

А он просто делает не больше того, что было указано.

Отличный работник.

Замечательный работник.

Почему он раньше не был таким? Весёлый, креативный, как жалко, что он уже уходит. Вот всем бы так.

Почему увольняющийся так весел и креативен? Почему так унылы остающиеся?!

Джуниор, как школьник, боится сделать ошибку. Ну, вы знаете школьников — те самые стрёмные и неуверенные в себе дети, которые боятся получить двойку, чтобы не быть битыми батогами нещадно.

Те самые, которые боятся экспериментов, бо их научили всегда выполнять какую-либо работу только по одному шаблону, иначе карательный меч педагогического правосудия…

Те самые глупые детёныши человека, которых приучили делать только то, за что хвалят, и НЕ делать ничего того, за что будут ругать.

Те самые, которые сперва выясняют правила и шаблоны, а потом стараются действовать строго в рамках этих правил, даже если здравый смысл говорит, что уже не надо так…

Какой такой здравый смысл в школе? Вот те два! Вот те шаблон! Вот что имел ввиду автор сей поэмы, когда раскрывал образ Онегина в образе Татьяны!

Ну, вы их знаете. Скажите ещё раз спасибо вашим учителям за то, что они из вас воспитали.

Вот и сидят джуниоры наши в ступоре, медленно накликивая себе на баг-репорт. Бо страшно. И задачи выполняют медленно — бо страшно ошибиться. И делать стараются лучше, чем могут (бо всем так говорят), но при этом стараются не экспериментировать, а то вдруг накажут (все так говорят). Вот и поди разберись…

А если увольняешься, то уже не страшно. Уже как раз всё делаешь как надо. Уже и экспериментируешь (ну и хрен с ним, если не получится — переделаешь). И ни с кем ни о чём не споришь, не сомневаешься, просто делаешь.

И начинает получаться!

Повторюсь, что речь идёт не о реальном движняке в ближайший порт, а всего лишь о психическом настрое начинающего весляра, будущего капитана своего боевого швертбота класса USS Enterprise.

Харэ сомневаться, просто начни делать хотя бы ровно то, что от тебя ожидается. Это уже потребует множества усилий, и на сомнения времени не останется.

Будете варить мыло?

К манагерам

Всё вышесказанное было обращением к джуниорам, но раз уж вы за каким-то чёртом дочитали досюдова, то для вас есть два важных соображения.

1)

Менеджеру не рекомендуется рекомендовать джуну думать про «А представь, что ты увольняешься…» Одно дело услышать это от тех, кто не влияет на твою зп, и совсем другое дело услышать это от того, кто на твоё зп влияет прочно. Не доводите их до суицидальных наклонностей в вашу сторону. Лучше официально разрешите им экспериментировать с выполнением поставленных вами задач.

Заодно сами начнёте лучше вникать в суть задач, а не только их раздавать и собирать отчёты.

2)

Опытный манагер всегда заранее знает, который из его пиратов намылился спрыгнуть за борт. Хитрому Билли кажется, что кроме него об этом ещё никто не знает, но решающий увольняться уже намного задолго до финальной дудки боцмана перестаёт вовлекаться в общее дело. Перестаёт спорить. Перестаёт предлагать. Перестаёт потеть и показываться на глаза начальству. Перестаёт бояться ответственности, и старается поменьше задач на себя брать. А те, которые взял, выполняет ровно настолько, насколько этого требуют условности контракта. И всё это очень хорошо видно и понятно, и если вам уже кажется, что кто-то из вашей команды заранее отстранился, то в приступе профессионализма вы можете вообразить, что уже распознали потенциального бегуна, и надо поскорее наподдать ему на прощание под зад…

Однако!

Люди могут отстраняться от вас не только перед увольнением. Например, если вы менеджер, но болван, и с вами сложно общаться, то эффект будет такой же — джуны постараются не попадаться вам на глаза чаще необходимого, выполнять ровно то, что было сказано, и вообще постараются не брать на себя никакую ответственность.

Джуниору нужно всего лишь избавиться от страха экспериментировать со способом выполнения задач. Собственно, весь секрет нашего профессионализма заключается в том, что ты на протяжении всего своего джуниорства позволял себе экспериментировать. В процессе поиска ответа на один вопрос ты находишь ответы на десять других, незаданных вопросов, и в итоге знаешь и умеешь намного больше, чем тот твой товарищ, который тыщу раз отмерял и сомневался, и готовился сделать всё СРАЗУ правильно.

То же самое видно и у спортсменов.

Люди разные, и ситуации разные. Но тот, кто долго и тщательно готовится сделать один, но правильный прыжок, всегда проигрывает тому, кто прыгает снова, и снова, и снова, и снова, и прыгает по-разному, в разных условиях, в разных эмоциональных состояниях, и просто прыгает для удовольствия, а не для «рраз — и победа». Почему так — сами догадайтесь.

P.S. А, ну да, если вы досюда дочитали, то вам интересно узнать, как понять, не болван ли вы. Ну, если вам кто-то что-то вякнул про вашего джуна, а вы не достали плазмаган для защиты своих пацанов, а побежали к вашему виновнику торжества, вытащили его в коридор и начали рвать ему пасть, приговаривая «Почему я должен слышать жалобы от чужих про тебя и краснеть за тебя и страдать за тебя?!», то увы…

Вся инструкция в txt http://bit.ly/2Er0x6o (Dropbox).

Внимание, даже в txt в ряде случаев происходит искажение символов в тексте — ординарные кавычки превращает в фигурные, а дефис превращается в подобие тире.

Презентабельности ради почти то же самое в pdf — http://bit.ly/2GIUSOX

Познакомиться с LaTeX исчерпывающе просто: достаточно установить Kile (редактор для LaTeX в среде KDE)

sudo aptitude install kile

При установке Kile принудительно потянет за собой зависимости, необходимые для базовой установки LaTeX. Например, будет установлен базовый пакет ‘texlive-latex-base’. Посмотреть информацию о нём:

sudo aptitude show texlive-latex-base

И это, конечно же, хорошо. Однако, как всегда, версия в репозиториях на порядок старее актуальной.

Current release ‘TeX Live 2017’ — от 4 June 2017.

А в репозиториях Debian доступен только LaTeX версии ‘2016.20170123-5‘.

Философия Debian не подталкивает к использованию «всего самого свежего», но речь идет о TeX, который в принципе остановился в развитии на версии 3.14, а обновляются только пакеты LaTeX, поэтому тут можно смело требовать «свежатинки».

Установка LaTeX из сети возможна, но процесс скачивания и установки трёх тысяч файлов долгий, и при сбоях связи слегка… раздражающ. И ещё говорят, что

…if TeXLive is installed via Debian’s own package manager (apt, synaptic, etc), TeXLive’s package manager (tlmgr) will not be available. This means that if a newer version of a package, or a package that is not in one of Debian’s own groups of LaTeX packages is required, it ends up being manually installed and that can make your system messy and hard to maintain.

This can be a big issue with Debian, since it has a very conservative view of what is a ‘stable’ package, and can easily be three years behind the main TeXLive repository.

Таки да, как-то довелось разбираться с установкой пакетов по-отдельности, и это было стрёмно.

Хочется просто поставить LaTeX самостоятельно и заставить Kile сразу работать с установленной программой, а не… Поэтому далее рассматривается несколько замороченная, но исключительно однозначная, точная и грамотная ручная установка всего набора LaTeX из его официального iso-файла  вкупе с неординарной, но смелой установкой Kile.

Место установки произвольное. Но по-умолчанию будет предложена установка в /usr/local/texlive/2017/.

Это разумно. Каталог с названием года выпуска — это фича, бо это позволяет установить сразу 100500 версий LaTeX рядом и переключаться между ними…

В /usr/ хранятся все установленные пакеты программ, документация, исходный код ядра и система X Window и да, к содержимому /usr/ все пользователи (кроме root) имеют доступ только «для чтения». А если система со своим /usr/ ещё и находится на SSD (solid-state drive, твердотéльный накопи́тель), а /home/ положено на HDD, то LaTeX, который и так работает быстро, будет работать еще быстрее нужного (о-ля-ля, куда уж быстрее-то?!).

Однако нет.

1

На моём ноуте только один юзер, и городить «общий доступ» нет резона. И вообще, сделаем установку portable LaTeX (то есть, эту шнягу можно установить даже на флэшку, my ass!).

2

В будущем всегда маячит переустановка системы. Если при этом не заморочиться бэкапом всего /usr/ (что вряд ли, если произойдёт большой и внезапный бэмц вроде «эсэсдэ помрэ»), то LaTeX придётся и ставить, и настраивать с нуля. Ы!

3

То же самое относится к установке программы в /opt/. Тоже, кагбэ, логичное для установки место, но оно тоже будет «обнулено» при вероятностной переустановке системы.

4

Для крупного обновления разумно сносить «устаревший» LaTeX и ставить новый «с нуля» (так гласит официальная инструкция, не будем ей перечить), и очевидно, что жить будет проще, товарищи, жить будет веселее, если новый софт будет установлен в тот же самый каталог с сохранением тех же путей в системных переменных. Поэтому не хочется устанавливать софт в каталог с названием типа /2017/ !

Хочется поставить программу в каталог, который не привязан к номеру года, и расположен близко к домашнему каталогу, и при этом находится в месте, в котором изменения возможны только для root. Собственно настройки программы, так и быть, положим к своему юзеру в скрытый каталог, бо настройки же юзерские, и будут то и дело уточняться.

И местами — весьма серьёзно, в режиме «раз настроил и забыл», поэтому припоминать «что там менялось» через год-два будет очень, очень затруднительно.

Поэтому далее рассматривается только установка LaTeX в каталог ‘/home/LaTeX/‘.

Enjoy.

Если попасть молотом по башке врага — ты победил. Если промахнулся — иди учись…

Согласно pairwise.org , есть множество софтинок для этого дела, и от Microsoft (их несколько, не только PICT), и от NASA (уже недоступна, в космос улетела), от Motorola, от IBM, и др.

Некоторые эти программы работают через консоль, другие через GUI, третьи через одно место, и все они, в принципе, делают то же самое, что может сделать один нормальный инженер с карандашом и бумагой, но делают это очень быстро. Главное — подать им на вход грамотный набор данных.

Вообще, ключевой навык для успешности в PairWise — исчерпывающее понимание этой технологии и неоднозначное умение почувствовать проблему/искажение уже на этапе сведения сущностей и их параметров в единую таблицу.

Есть и онлайновые сервисы: hexawise, inductive, testcover — смотреть большой обзор, я ими не пользуюсь, предпочитаю консольную Allpairs (скачать бесплатно с джеймсобаховского сайта), бо привык к ней, и она не привязана к одной операционной системе.

Чтобы с ней управляться, нужно сперва уметь управляться с консолью. Ну там, между каталогами переходить, уметь из каталога с тестовыми файлами запускать программу, которая находится в другом каталоге, короче, основные основы управления любым современным кантупиром.

Ведь не может же такого быть, чтобы кто-то занимался тестированием ПО, не понимая, как устроена файловая система, и как организованы файлы на жестком диске, и как управляться со всем этим добром из консоли.

Затем нужно уметь составлять таблицу данных, которая будет обработана Allpairs. В Excel (или в Calc) нужно сделать таблицу с перечислением сущностей и их параметров, затем экспортировать эту таблицу в текстовый файл с разделением столбцов через «TAB». Затем скормить этот текстовый файл Allpairs на обработку.

Непосредственно Allpairs привык использовать так: в каталоге с программой allpairs.exe создаю подкаталог (‘Test’), в который сохраняю текстовые файлы (с таблицами из Excel). В этом же подкаталоге появится и файл с результатами работы allpairs.exe.

Перехожу в этот подкаталог (‘Test’), и уже из него обращаюсь к allpairs.exe, которая находится на одном уровне выше.

Указываю в этом вызове файл, который надо обработать (назвал его input.txt) и приказываю вывести результат работы в файл, который на диске еще не существует (назвал его output.txt).

В Unix алгоритм работы (методология) тот же, но

1. перед вызовом программы обязательно нужно указать ‘perl’,
2. в самом названии программы указывать расширение ‘.exe’ уже нет необходимости,
3. слэши другие.

Нюансы под макой и убунтой (вот, казалось бы): таки надо внятно указать обращение к файлу allpairs.pl:

perl ../allpairs.pl input.txt > output.txt

В Confluence можно грамотно разметить оглавления в тексте, заголовками уровня 1-6.

Можно вставить автоматически собираемое «Содержание» всех заголовков на странице (макрос ‘Table of Contents’).

Можно вставлять в тело страницы другую страницу, целиком (макрос ‘Include Page’).

Даже можно сделать на странице, содержимое которой надо встроить, специальное выделение текста (макрос ‘Excerpt’), и вставлять ТОЛЬКО то содержимое, которое было помеченное таким хитрым образом (макрос ‘Excerpt Include’).

Можно вставлять ссылки на другие страницы внутри Confluence аж двумя способами: по-простому (по-дурацки) и грамотно.

Вставляем по-дурацки

1. Просто скопируй нужную ссылку из адресной строки, да вставь ее в нужное место на странице открытым текстом.

Буквально copy/paste ‘httр://confluence.test/display/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process‘ в тело открытой на редактирование страницы.

Сработает сразу.

Но вероятно не будет работать в будущем, если в названии страницы изменится хотя бы один символ — ссылка просто «умрёт».

Например, если в названии только дружественные англо-символы (вроде «Action Verbs to be used in Goal setting process«), URL страницы будет выглядеть как ‘httр://confluence.test/display/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process‘

Если изменить заголовок страницы на «Англ Action Verbs to be used in Goal setting process» (добавить неанглоалфавитный символ, или двоеточия, или что-то еще неординарное), URL страницы поменяется на что-то вроде ‘httр://confluence.test/pages/viewpage.action?pageId=54598262‘

Всё потому, что URL страниц в Confluence создается динамически, изменяясь «на лету» в зависимости от названия страницы.

А ссылки на страницы в Confluence существуют в системе как самостоятельные сущности (переменные). Поэтому привязываться надо не к ссылкам, а к сущностям, которые хранят в себе ссылки. Поэтому

Вставляем грамотно

1)

1. Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K).
2. В окне настроек выбрать Search > искать по названию страницы.

Будет мелкий неудобняк:

• надо начинать набирать название искомой страницы без ошибок хотя бы в первых словах.
• ой, если надо искать только что созданную страницу — она сперва должна проиндексироваться в системе, и процесс этот нам не подчиняется. Пока поиск не проиндексируется, будет казаться, что только что созданная страница тупо отсутствует…

Поэтому более точный и удобный способ: в окне настроек макроса ‘Insert Link’ открыть раздел ‘Recently viewed‘. Нужная страница там безусловно найдется, практически всегда окажется, что я её уже открывал. Клик по её ‘Title’, и всё готово.

Confluence Recently Viewed

Теперь название страницы, на которую поставлена ссылка, может изменяться как угодно, вплоть до появления ‘pageId=54598262‘ — ссылка всё равно сохраняется «живой и невредимой».

2)

Как быстро вставить ссылку, не подергивая свою мышь:

1. В открытой на редактирование странице нажать на клавиатуре клавишу ‘[‘ — появится окно ‘Link suggestions’, аналог ‘Recently viewed’.

Дальше понятно?

Ссылки на имена юзеров вызываются через ‘@‘.

Вставлять картинки: через ‘!‘.

Можно внутри страницы организовать огневые перекрестные внутренние ссылки, что дичайше котируется в больших документах вроде ‘QA Vocabulary’ (например, в нашем 226 терминов, ой-вэй).

Ссылки на разделы внутри страницы

делаются так:

1. Разметить текст как заголовок (в моем случае ‘Definitions of Selected Functional Verbs‘).
   

   Confluence Heading

2. Скопировать этот текст в буфер обмена as is. Со всеми его пробелами и запятыми, если есть.
3. Перейти в другое место страницы, где надо сделать ссылку на данный заголовок.
4. Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K).
5. В окне настроек выбрать Advanced.
6. В поле ‘Link’ своими руками вписать символ ‘#‘ и сразу текст (заголовок) из буфера обмена со всеми его пробелами, as is, буквально ‘#Definitions of Selected Functional Verbs‘
   
   

   Confluence Advanced Links

   // Внимание: The anchor name is case sensitive. You must use the same pattern of upper and lower case letters as you used when creating the Anchor.

   // После обработки текст превратится в #DefinitionsofSelectedFunctionalVerbs (ибо справка: The anchor name in the full URL is concatenated into a single word, with all spaces removed).

   // В поле ‘Link text’ автоматически будет вписан тот же текст. Его спокойно можно отредактировать, при этом содержимое поля ‘Link’ уже не изменится.

7. Insert.

Итоговая ссылка на заголовок ‘Definitions of Selected Functional Verbs‘ будет выглядеть так: httр://confluence.test/display/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process#ActionVerbstobeusedinGoalsettingprocess-DefinitionsofSelectedFunctionalVerbs

Мелкий неудобняк: ничто не подсказывает, что надо вставить ‘#‘. GTFO, если не знаешь про этот хинт. Я про него знаю, и вроде не дурак, но иногда забываю вписать эту чертову решеточку…

Серьезный, раздражающий неудобняк: если заголовок раздела ‘Definitions of Selected Functional Verbs‘ когда-нибудь изменится хоть на одну букву, ссылка внешне останется активной, но превратится в ссылку, просто закрытую заглушкой ‘#’.

Ок, это был простейший сценарий, ссылки внутри страницы. Теперь дело посложнее:

Поставить ссылку на заголовок с другой страницы, которая находится в другом space

Учли, что прямой Copy/Paste возможен, но потенциально недолговечен, и надо действовать через макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K).

И пусть там можно найти только общий Title нужной страницы, внутренние ссылки оттуда недоступны, однако действовать надо именно через макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K). Если в будущем изменится название страницы, в которой находится заголовок, на который надо ссылаться, Confluence эту ссылку грамотно обновит. Confluence рулит!

Вот если внтури страницы изменится тот самый внутренний заголовок, на который сделана «ссылка внутри страницы», тогда уж увы.

И всё равно придется действовать через раздел Advanced, да еще и вручную вписывать название страницы.

А это уже раздражающий неудобняк.

Если страница с внутренней ссылкой, на которую надо сослаться, находится в том же space:

1. Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K) > Advanced
2. Вставить ссылку по шаблону ‘Page Name#MyHeading‘.
3. В моем случае это ‘Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs‘
4. Insert.

Если страница с внутренней ссылкой, на которую надо сослаться, находится в другом space:

1. Вызвать макрос ‘Insert Link’ (элементарно вызывается по Ctrl+K) > Advanced
2. Вставить ссылку по шаблону ‘spacekey:Page Name#MyHeading‘.
3. В моем случае это ‘~a.lupan:Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs‘
4. Insert.

Работает.

ВНЕЗАПНОСТИ

1)

Полностью URL на определенный заголовок внутри определенной страницы выглядит так: httр://confluence.test/display/~a.lupan/Action+Verbs+to+be+used+in+Goal+setting+process#ActionVerbstobeusedinGoalsettingprocess-DefinitionsofSelectedFunctionalVerbs

Что же это за #ActionVerbstobeusedinGoalsettingprocess-DefinitionsofSelectedFunctionalVerbs, если я вписывал только #DefinitionsofSelectedFunctionalVerbs? Что за Wtf?

Ответ такой: все в порядке.

The page name is repeated in the URL, after the # sign. The second occurrence of the page name is concatenated into a single word, with all spaces removed.

Но зачем?

Ок, учтем, что в виде ссылки надо использовать только то, что идет за решеткой, но только после дефиса.

Неочевиднейший подход. Пока это поймешь…

2)

Если продолжить редактировать страницу, отсылка продолжает оставаться рабочей.

Но если я решу отредактировать эту ссылку… в ней исчезает spacekey, и вместо

‘~a.lupan:Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs‘

там будет написано

‘Action Verbs to be used in Goal setting process#DefinitionsofSelectedFunctionalVerbs‘.

Всё, ссылка сдохла.

Не обратишь на это пристальное внимание — увы, блеать…

Confluence Space Key Disappear

3)

Confluence Help организован не по-взрослому.

Есть дефолт-справка по работе со ссылкам: https://confluence.atlassian.com/display/CONFEAP/Links

Но также зачем-то существуют отдельные страницы справка для разных версий Confluence. Например, справка для Confluenct версии 5.6 находится тут: https://confluence.atlassian.com/conf56/confluence-user-s-guide/creating-content/using-the-editor/working-with-links

Я работаю с Confluence 5.5.2, поэтому смотрю на https://confluence.atlassian.com/conf55/confluence-user-s-guide/creating-content/using-the-editor/working-with-links

Между всеми тремя версиями справки разницы НЕТ, количество слов в двух документах идентично. Wtf?

Confluence Help Links Word Count

В целом Confluence рулит неимоверно!

Просто надо немного оторвать ноги/руки тем, кто реализовал механизм работы с ссылками, и мир во всем моем мире наступит.

Сразу.

Всей подошвой.