[WIP] Thinking functionally

[kleidemos]

Thinking functionally

Актуальные ахтунги

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

Файлы

• Thinking Functionally: Introduction | Мыслить функционально: введение. Первый взгляд на основы функционального программирования.
• Mathematical functions | Математические функции. Движущая сила в основе функционального программирования.
• Function Values and Simple Values | Функции как значения и обычные значения. Связывание <> присваивание.
• How types work with functions | Как типы взаимодействуют с функциями. Понимание нотации типов.
• Currying | Каррирование. Разбивка функций с несколькими параметрами на множество мелких функций с одним параметром.
• Partial application | Частичное применение. Запечатывание некоторых параметров внутри функции.
• Function associativity and composition | Ассоциативность и композиция функций. Построение новых функций на основе существующих.
• Defining functions | Определение функций. Лямбды и многое другое.
• Function signatures | Сигнатуры функций. Сигнатура функции может дать вам некоторое представление о ее содержании.
• Organizing functions | Организация функций. Вложенные функции и модули.
• Attaching functions to types | Прикрепление функций к типам. Идеоматичный для F# способ создания методов.
• Worked example: A stack based calculator | Пример: калькулятор на стеке. Использование комбинаторов для построения функционала.

Сабж & Дисклеймер

Перевод серии статей на FFF&P.

• Изначально перевод использовался для сдачи "знаков" по иностранному языку в универе. Это должно объяснить некоторое изменение стиля (и видимо качества) в районе 5-6 глав, а также возможные артефакты в виде переводов слов и т.п.
• Текст переводился в 3-4 приема и достаточно длительное время, что также возымело последствия. // Временной ряд не дам, дабы избежать "ноцебо".
• Текст переводился в обычном редакторе кода, поэтому с орфографией и синтаксисом полный абзац. Планирую решить проблему сменой редактора чуть позднее. // Если знаете md редактор, который шарит в русском, сообщите.
• Финальный текст кроме меня никто не просматривал (не считая некоторой проверки в универе).

Форма записи

Основной текст

Текст дробился по абзацам, либо по плотно связанным структурам, типа [не]упорядоченных списков и т.п. Большая часть текста (исключения далее) дана в стиле:

---

Оригинальный текст на английском

Перевод на русский.

---

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

Заглавия

Я счел важным сохранить оригинальные заглавия наряду с переводом. Поэтому заглавия даны в виде:

---

Заголовок на английском | Заголовок на русском

---

Код

Текст в рамках фрагментов кода я не переводил. Т.к. не определился с осмысленностью данной операции. Но если партия прикажет...

Мета информация

Не переводил от слова вообще, ибо надо думать. К тому же ее состав изменился с моего клона.
В проекте использую свежую мету.

---

Изначальный Issue.

[kleidemos]

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

[Neftedollar]

@kleidemos да, та же мысль.
Ревьюеры, отпишитесь пожалуйста, кто будет ревьюить, если будет, и какую часть (UPD: названия md файлов)?
Если по каким-то причниам не сможете, не важно по каким, отпишите сюда тоже пожалуйста.

[AnnaUdovichenko]

Там диффы как-то очень странно отображаются, мозг немного взрывается.

А так я могу почитать про каррирование и частичное применение, например.

[FoggyFinder]

Ревьюеры, отпишитесь пожалуйста, кто будет ревьюить, если будет, и какую часть?

Буду читать по порядку, спешки ведь нет?

[Neftedollar]

@AnnaUdovichenko отпиши пожалуйста названия md файлов, обновлю сейчас свой коммент.

[Neftedollar]

@FoggyFinder пока, не спешим особо.
@kleidemos если надо поспешить, то отпиши пожалуйста

[AnnaUdovichenko]

@Neftedollar currying.md, partial-application.md - вот эти пока посмотрю. Ещё пару дней нет тотального загруза, надеюсь, успею.

[AnnaUdovichenko]

А как лучше делать: комментарии писать, или сделать клон и отредактировать у себя?

[Neftedollar]

А как лучше делать: комментарии писать, или сделать клон и отредактировать у себя?

@kleidemos как тебе удобнее? Упомяни @AnnaUdovichenko плз в ответе

[kleidemos]

@Neftedollar
По поводу разделения
Я имел ввиду полное ревью, но в разное время. Т.е. подключать новых людей после некоторого объема изменений.
У меня похоже менялась терминология по ходу перевода, если текст разделить на куски, то подобные вещи можно пропустить. Хотя с другой стороны, это можно оставить на завершающую стадию.

@Neftedollar @FoggyFinder
Время
Не спешу.

@AnnaUdovichenko
Форма обратной связи
Честно говоря, пока не попробуем, сказать не смогу. Но разумеется глобальные вещи, связанные с массовым "переименованием" терминов лучше указывать здесь.

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

[Neftedollar]

Хотя с другой стороны, это можно оставить на завершающую стадию.
this
Потом ревьювера еще добавим.

[ForNeVeR]

По поводу диффов. Я обычно стараюсь вычитывать переводы следующим образом: читаю оригинальный материал (например, статью или её раздел), а потом смотрю перевод и комментирую то, за что зацепится глаз.

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

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

[kleidemos]

К сожалению, такая техника слабо подходит при создании перевода.

Представление диффов на гитхабе чудовищно, знал бы заранее, подобрал бы другую форму записи.

[FoggyFinder]

Какой файл еще остался не распределенным?

[Neftedollar]

@FoggyFinder взяты currying.md, partial-application.md

[Neftedollar]

@FoggyFinder было бы не плохо посмотреть на posts/defining-functions.md

[Neftedollar]

Т.К. двигается все немного медленнее чем хотелось бы. Давайте обрабатывать файлы последовательно.
Нельзя чтоб такая огромная работа канула в никуда.

[Neftedollar]

Предлагаю сначала разобрать https://github.com/kleidemos/fsharpforfunandprofit.gitbook/blob/thinking-functionally/posts/thinking-functionally-intro.md

[AnnaUdovichenko]

Я кусок файла про каррирование уже отредактировала, но не запушила - думала сразу выложить все правки одного файла хотя бы. А так In progress.

[FoggyFinder]

Предлагаю сначала разобрать https://github.com/kleidemos/fsharpforfunandprofit.gitbook/blob/thinking-functionally/posts/thinking-functionally-intro.md

свои комментарии к этому файлу уже оставил

[kleidemos]

@FoggyFinder Я не понял, куда смотреть?

k