sudodoki’s personal blog

5-минутка википедии: Синестезия

2020-05-11T00:00:00+00:00

Задался я вопросом

а есть ли каноничное цветовое представление для высоты звука?

в контексте каких-то своих начинаний для визуализации музыки. И, в общем, логическая цепочка ( и якорь в памяти из house m.d. ) привел меня к Синестезии. Вообще, это такой режим/нейробиологическое состояние работы мозга, когда раздражение одних органов чувств приводит к активации других. Буквы/слова обретают для вас цвет, вы слышите звуки смотря на беззвучные вспышки света, этс. Есть разные варианты, как того, как это ощущается людьми с этим состоянием, так и самих пар стимулов воспринимаемых/ощущаемых. Визуальное ощущение цвета при прослушивании звуков называется Хроместезия. В попытках узнать, смог ли кто-то обобщить и найти закономерности, нашел парочку статей, которые и хотел бы здесь оставить.

A Statistical Study of Pseudo-Chromesthesia and of Mental-Forms

Статья 1893 года (!) которую можно найти в интернете в открытом виде. Сам факт наличия такого заставляет в очередной раз радоваться существованию интернета. Из интересных замечаний было про то, что кто-то воспринимал звуки пианино как квадраты, а звуки скрипки – как линии.

Musical pitch classes have rainbow hues in pitch class-color synesthesia

Небольшой опрос-исследование на 15 японоговорящих студентах, имеющих хроместезию. Вот усредненные цвета

Across-subject averaging of reported colors revealed that pitch classes have rainbow hues, beginning with do-red, re-yellow, and so forth, ending with si-violet, accompanied by a decrease in saturation.

Тут также высказывалось мнение, что с учетом того, что до-диез вызывал ощущения “красноватости”, а ре-бэмоль – “желтоватости” (для людей вне музыкального контекста, это один и тот же звук), и эти цвета напрямую связаны с цветами основных нот (до – красный, ре – желтый), то связь цвета и звука происходила именно из-за названия ноты.

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

Из другого, средне связанного

некоторые люди видят “числовую линию”, мысли о числах мапятся в некоторое геометрическое пространство. В первой статье был описан следующий пример, Человек не мог объяснить, почему так, но у него была гипотеза, что часть с числами по кругу была связана с тем, что он научился определять время по часам до того, как он научился считать и в дальнейшем при учебе он всегда возвращался к ментальному представлению циферблата.
У Франца Листа была синестезия и ходит анекдот, что он просил оркестры играть “чуть поголубее” и “в более розовых тонах”. Многие долго думали, что он просто троллил и выражался образно. Где-то еще видел другой анекдот, что он пересекался с другим композитором с хроместезией и они до хрипоты спорили о том, какой цвет связан с той или иной нотой.
по ключевым словам синестезия и хроместезия можно найти отдельные проекты связанные с визуализациями музыки и прочего.

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

2019. Мои итоги

2019-12-31T00:00:00+00:00

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

Джедайские техники

Первая книга, прочитанная в этом году. 10/10, и доклады у Макса есть интересные, рекомендую, если у вас возникают ситуации, когда голова гудит из-за тысячи несделанных дел и вы не справляетесь с нагрузкой. И хоть по итогам за год я перестал делать некоторые упражнения оттуда, мой todoist до сих пор со мной как и инбокс зеро. Но я точно стал спокойнее относится к рабочей нагрузке и ощущаю себя более продуктивным.

Записывать интересное/полезное из прочитанных статей

Не помню, зачем изначально я начал это делать, но по итогам имею следующее: 169 записей прочитанных статей/блогпостов и особо выдающейся документации, из которых захотелось что-то сохранить в свой скрапбук полезных референсов/инструментов/подходов/информации. Судя по EDA, чаще всего читал вещи по воскресеньям, вторникам и средам 🤔. Удобно было при повторном попадании на какую-то статью читать её краткое содержание или опираться на записи для пересказа. Смотря на график, можно понять, когда у меня голова была занята чем-то более важным.

визуализация с помощью altair который точно может стать отличным дополнением вашего EDA toolbox’а.

Летняя школа

По-прежнему считаю это очень эффективным форматом. В этом году смог поучаствовать как слушатель в Conversational Intelligence Summer School, было забавно из-за локации и общего покрытия тем. Также под вывеской летней школы сделали курс в RR. Надеюсь не в последний раз :)

Конференции

Поучаствовал как спикер в input conf. Было очень тепло и лампово. Котаны очень круты, как всегда, а каждый новый человек вдыхает все больше жизни и взращивает комьюнити в новом направлении. Никогда не учитесь в одиночку 😉 Также вписался в комитет data science fwdays. Получилось неплохо, спасибо оргам и всем спикерам, кто предлагал свои темы или отозвался на приглашения. Уже вовсю работаем над тем, чтобы в следующем году сделать все еще круче и сформировать такой лайнап и такие доклады, что и сам бы с удовольствием все послушал. Билеты уже можно купить.

Проект “Феникс”

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

За кадром

Был участником и других ивентов, как хороших так и таких, которые очень не понравились. Плохие мероприятия, как ни странно, дали больше мотивации сделать что-то хорошо и правильно.
Одни несделанные пет-проекты сменялись другими, но я ведь после каждого из них узнавал что-то полезное (так ведь? 😝). Так что, надеюсь закончить текущий и хоть что-то показать миру, а потом сразу делать тот воркшоп про МЛ, который я публично обещал.
Послушал лучший концерт so far от Royal Blood и побывал в самых красивых горах (спасибо, Артем :)).
Полезные привычки: спальня без экранов, читать бумажные книги перед сном, и здоровое питание (хотя бы на завтрак).
Наконец-то попробовал боулдеринг (всего-то 4 года после первого желания сходить до осуществления задуманного).
На работе начали делать продукт, в связи с чем получилось тоже поделать много чего разного нового и интересного.
Кстати, забавно, закрыл самую большую тудушку из 2018 года лишь в сентябре этого.
Ну и экзистенциальные ужасы глобального потепления, которые заново заставили переживать флешбеки из детства, когда я опасался сокращения пригодной для употребления воды из-за фосфатов в стиральных порошках.

PS

Возможно, это не так насыщенно, как чьи-то еще итоги, но 🤷this is me and this is my story. Есть уже и какие-то условные резолюции и планы на 2020, посмотрим, что из этого выйдет, не хочу загадывать наперед.

Хорошего нового года, и пускай он будет таким, каким вы захотите.

Итоги 2017: садите людей в комнату и наваливайте

2017-12-26T00:00:00+00:00

tl;dr: пробовал больше одного формата, лучше всего зашло сидеть в закрытой комнате с лектором, ну или на крайняк читать что-то глазами. Если наши интересы имеют точки пересечения, вам может быть полезен данный пост. Если захотите что-то обсудить, да и вообще, – пишите в тви / гиттер.

Субъективный топчик

Летние воркшопы УКУ

что: Летние воркшопы УКУ.
формат: а-ля летняя школа (хотя у них это еще отдельное мероприятие). Собираем группу людей, каждый день садим их в класс, приводим преподавателей, полдня лекций, полдня практики.
плюсы:
1. за неделю закачали огромное количество знаний, что самостоятельно осваивал бы на порядок дольше.
  - роадмап/пайпалайн с кучей статей / слайдов / воркбуков, что стоит еще изучить
  - знакомства с замечательными людьми и буст вашей мотивации.
  - отличный современный кампус
  - замечательные приглашенные преподаватели
минусы
1. туда непросто попасть, я не в первый раз подавался, наконец-то взяли, и то я был не их первым выбором
  - при озвучивании идей изучать CS/DS в УКУ готовьтесь услышать очень тупые шуточки / непонимающие взгляды и прочая

Если есть возможность (а она будет не у всех, там таки 💰), подумайте поучаствовать в летних/зимних воркшопах, школах, или даже махнуть на полтора года магистратуры – программа выглядит 🔥.

Practical Common Lisp

что: Practical Common Lisp
формат: одна из лучших книг о языках и околотого, что я дочитал от начала до конца. [Кажется, следующим постом будет что-то в духе “мои полгода с Common Lisp”.]
плюсы: не тухлое изложение, с полезными сниппетами, начиная почти с первой страницы, не особо заостряется внимание на каких-то исторических и не сильно полезных вещах, даются алгоритмы решения типичных проблем, зачатки философии использования инструментом
минусы: мало речи о настройке окружения (можно посмотреть на portacle, например), чуточку в стороне осталась экосистема quicklisp‘a, по ощущениям

В лиспе, в общем-то, можно увидеть, если смотреть, динамический язык, который одним из первых начал (и продолжает!) использовать кучу фич, к которым мы привыкли (optional/keyword аргументы, GC, работа с неймспейсами), при этом имеет пару своих особенностей (особая объектная модель, работа с рестартами / исключениями) и все равно поможет создавать код как close to the metal так и используя высокоуровневые абстракции.

Курс от ODS

что: Открытый курс машинного обучения.
формат: набор лекций в письменном виде (хотя были еще и видеозаписи лекций) + набор jupyter воркбуков с исполняемыми примерами из лекций / домашними заданиями + централизованая проверка домашек (с дедлайнйами) через гугл формы + чатик участников и коучей.
плюсы: стоит $0. Хороший баланс между “навалим формул, ничего не ясно” ↔ “вот, импортим либу, все работает”. Обсуждения в чате заставляли глубже осознавать материал (“а и правда, об этом я не думал 🤔”), или добавляли еще более понятных объяснений / подсказки по коду. Также индивудальные проекты и соревнования каггл инкласс добавляли элемент азарта и “все как у взрослых”.
минусы: довольно высокий темп, под конец так и вообще, все дедлайны наступают примерно в один и тот же момент; было некоторое количество вопросов к домашкам и их проверке, какие-то оргмоменты, но это все мелочи

Скоро будет новый запуск. И да, если что, в курсе нет нейроночек и дип-лернинга. Показательно с точки зрения мотивации/статистики: первую домашку сдало 1300 людей, последнюю – 136. 🤔

Все остальное

В общем-то, субъективный топ на этом можно заканчивать. За кадром остались

ридинг клабы, что мы проводили один и второй раз (и я надеюсь, соберемся проводить еще). Главной проблемой тут является низкий % дошедших до конца. Книги, что выбирали, были очень фундаментальны и мне сложно передать warm fuzzy feeling от понимания отдельных важных концепций / кусков материала из книг. Курсы по этим же книгам, субъективно, чем-то схожи с другими адаптациями: или разбавляют повторениями, чтобы было понятно всем, или вырезают отдельные арки сюжетов, что не вписываются по времени
- замечательная книга, которая первая выскочила у меня при идеях подводить итоги – говори и показывай
- оффлайн курсы котанов по жсу, я помогал ^_^
- комьюнити и его жизнь, там тоже были интересные встречи, доклады, завтраки, афтепати и сопутствующая движуха
- курсера, которая иногда, кажется, не стоит тех денег, что просят за специализацию, но добавляет кучу эндорфинов при успешном вписании той одной / двух строчек когда, что необходимых для выполнения задания
- полусистематическое выделение 5-15 минут в день на то, чтобы поднять скиллы владения инструментом – очень полезная инвестиция (отдельные схожие мысли на тему не так давно видел тут)
- pydata – кажется, сейчас это мой уровень, не сильно академичен, не сильно казуальный, есть интересные проекты и инсайты, больше полудюжины докладов оттуда посмотрел. Другой конфой из недавних откуда я так смотрел доклады был KharkivJS 2017 – тоже рекомендую.
- статьи на arxiv. Вообще следить за тем, что там на almost bleeding edge (да, не все понятно, но хотя бы создается ощущение, что что-то куда-то двигается + какие-то границы неизведанного / представление о возможном меняется)
- про питон, но лень
- про воркшопы, как человек, что проводил и ходил на некоторые: самое сложное, это помнить, что к ним нужно готовиться заранее дома. А еще хорошо бы фиксировать версии зависимостей или иметь понимание, как их обновить по-быстрому
- ивенты от Meetup Tonight & UDS
- активити связанные не с CS/DS/AI, но про это тут не будем, хотя всегда можете спросить меня напрямую

Что дальше?

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

C’ya 😸

Programming as analogy, part III

2016-11-07T00:00:00+00:00

One other field software development is similar to would be dentistry (okay, actually, there are a lot of different things, but this one would make it easier and funnier to relate to).

Imagine one day a patient coming in and asking to treat his tooth. Or Imagine one day a customer coming in and asking to do support/consulting stuff on his project.

There are different ways it can go on. You can know this person for years and all the services were bought from your company, so you know pretty damn well what’s going on there.

But usually, it would happen that customer is just trying to get a better price, or their previous goto man left the field, or something just didn’t work.

And then starts the fun part.

It might be that customer doesn’t have any complaints and then you could just let them off with advice of flossing and hoping everything’s gonna be okay. Or you just need to do some whitening, and that’s it and everybody is happy.

In case there are complaints you would try to ask some questions for the medical history. Rule of thumb is customer knows some stuff s/he was exposed to, but they might 1) confuse difficult (lamost foreign sounding) terms 2) not being fully aware of all the previous decisions made while being treated

And with every question customer might be getting angrier and more impatient, because the problem at hand seems soooo easy and it always took just 15 minutes, but not this time for some reason. It really depends on how thorough you can afford to be and what type of customer you are dealing with. Good professional won’t be easily withhold by someone just being angry, as they are doing their best in order to acquire fullest picture so that everyone is on the same page and noone gets to stumble in darkness with hidden surprises everywhere.

You could get a medical history (aka docs). But there might be a case it wasn’t maintained properly (‘yeah, this is my card from years ago, but then I had like 4 teeth pulled out while on vacation in Cambodia’). It might be conceived before laser printers were in every clinic, so it’s hand written or uses foreign language, uses some cryptic abbreviations you have never heard of and on top of it, few pages are missing and one has a huge coffee stain on it.

You might try to get more info but running some test or taking x-ray and trying to get an idea of what’s going on. But there are always hard cases when you cannot easily tell what’s going on. People afraid of x-rays, tongue piercing coming up on shots, people overthinking the sensations they get from dentist explorer – all that might lead to a certain degree of false positives.

Worst part of the story is understanding someone messed up years ago but it’s only now that patient/customer needs to take drastic measures to prevent even bigger issues that can even pose threat to someone and just redo everything done before.

If you liked this tiny one, take a look at part II.

Programming as analogy, Part II

2016-05-13T00:00:00+00:00

This is a stand-still capture of lightning talk I presented at Ruby Meditation this spring.

This is just an analogy. And any analogy is inaccurate

So, the basis for this analogy would be that we can compare web development to music (previously, it used to say ‘software development’ but I slightly adjusted this as to what’s going next and because of the fact webdev is just a small subset of software development overall). Yes, there’s always a good amount of discussion whether writing code is craft or art, and on this one, let’s just all agree we can compare webdev and music. Both can serve different purpose (or no purpose at all), involve blend of inspiration, taking someone’s problem off their shoulders, making a living and cashing out big in the end (not everyone, sure) and genuinely having fun while it’s on.

Extending this analogy, we could say that backend is a rhythm section

Bringing in strong base and steady rhythm, beating heart of the system. And frontend would be melody & other stuff™

Important tool for conveying general mood and idea, but makes so much more sense when there’s a solid rhythm section backing it up.

Now, I would exercise my sense of humor and tire you up with some silly one pic + caption translations of things between webdev & music.

BaaS would be drum machine, aka ‘Look ma, no Backend’

Autotune would be linters, making it so much simpler to have unified sound and not having everyone argue whether that was A or A♭.

Backender doing Frontend

And, possibly, full-stack engineer would be a one man band.

Scaffolded/generated backend <img src=”https://sudodoki.github.io/slides/rubymeditation-april-16/images/automated_backend.gif” height=600>

Backend not keeping up with the spec <img src=”https://sudodoki.github.io/slides/rubymeditation-april-16/images/spec_handling.gif” height=600>

Burnout aka too much work

Creating fancy frontend demo for customer

(↑Note that there’s no backend present.)

Orchestration

Whenever there are breaking changes in backend

Backender seems to be really proud, but some other team members seems to be slightly not as excited about this.

And the most important part here would be that Different languages would represent different instruments 🎹🎷🎺🎸🎻

Different music styles, which could correlate to different type of projects, would require different instruments to bring out the best of the style and the team/band behind it.

You could also compare Computer Science to Music theory ♩♪♫♬♭♮♯. There’re too many people being self-taught in both fields, and, IMO, there are always a chance prodigy would be able to come up with innovative idea and solution, but there’s also a high probability of running into too many unsuccessful experiments because one is not able to ‘stand on the shoulders of giants’ and reuse that knowledge that field has accumulated throughout its existence.

Patterns might translate into scales, chords, …, things lesser than whole solution, but a building block you might not need, but that is there in case you need it.

And finally,

Go on and create nice music!

🎹🎤🎧🎼🎷🎺🎸🎻

Closing remark: topic of comparison music and software development was covered in great book by Chad Fowler that I had great pleasure reading called The Passionate Programmer. And yeah, this was slightly based on tons of related tumblrs, like devopsreactions and others.

Hope you liked it – just wanted this off my draft tab as it was there for good half a year and I really enjoyed this small brain exercise and had feeling this might amuse and/or inspire someone.♥️

Bash scripts to automate usage of starters/boilerplates

2015-05-19T00:00:00+00:00

There are a lot of different starters & boilerplate projects out there, especially for the frameworks/systems that are not tied up by conventions. From those quite widespread right now I would name angular (see angular seeds) and react to have quite a bit of those, each of which might bring some interesting ideas/tools/paradigms to the table.

There’re some minor things I would love to see less when people are providing instructions on using their seed/starter for starting project 1) Forgetting to specify --depth 1 as argument to git clone. Omitting that argument will mean cloning whole tree with history, which gets you extra overhead on space & waste more time to start the project (especially on slow bandwidth or for projects that have gone a loooong way and have hundreds/thousands of commits under the belt). 2) Suggesting using same git - not hinting on how to specify new remote url, or get rid of previous history, which caused the folder size to bloat (especially with conjunction with #1), etc.

To simplify this flow in case you’re quite frequent user, you might want to have some handy aliases. For some time I occasionally ran git clone https://github.com/%some-boilerplate-project%.git my-bp-project && cd $_ && rm -rf .git to get me a plain folder from which I could start building up, which ended up living in my alias section of .zshrc file.

So following are the examples of zshrc aliases (which should work on bash/sh with minor modifications (at some point I put it into separate template.sh file with #!env sh shebang and code did work although there were some changes regarding regex matching). Here, we have template alias which will use provided git URL (be it ssh/https ones you would copy from github/bitbucket or github username/reponame pair) & name of the folder (with fallback to boilerplate name itself as folder name) that it will proceed to clone to specified folder, remove original .git folder and init empty git repo. It will also save the git url to the ~/.last_template file (plain text file), which can be leveraged by last-template alias, which reuses last provided template and basically is template with default value of last used boilerplate provided via ~/.last_template file.

cloneCleanup() {
  # $1 - $GITREMOTE
  # $2 - $FOLDER_NAME
  echo "Will be setting up $GITREMOTE in $FOLDER_NAME"
  # Clone last commit, remove git folder, init empty git repo, save the last used template
  if git clone --depth 1 $1 $2 && cd $_ && rm -rf .git && git init && echo $1 > ~/.last_template ; then
    echo "Ready to work."
  else
    echo "Something went wrong."
  fi
}
scaffoldGithub() {
  # Script to scaffold project based on github repo
  GITREMOTE=$1
  # Handle username/reponame case
  if [[ "$1" =~ ^[A-Za-z0-9_-]+\/[A-Za-z0-9_-]+$ ]]
  then
    GITREMOTE="https://github.com/$1.git"
  fi
  # capture PROJECT_NAME part of git link (right before .git)
  REGEX="([A-Za-z0-9_-]+).git$"
  [[ "$GITREMOTE" =~ $REGEX  ]];
  PROJECT_NAME="${match}"
  # use provided folder name with fallback to project name
  FOLDER_NAME="${2:-$PROJECT_NAME}"
  cloneCleanup $GITREMOTE $FOLDER_NAME
}
simplifiedScaffoldGithub() {
  # Script to reuse last used template saved in ~/.last_commit
  GITREMOTE="`cat ~/.last_template`"
  # Throw in case user forgets to put in folder
  : ${1?"Usage: last-template foldername"}
  FOLDER_NAME="$1"
  cloneCleanup $GITREMOTE $FOLDER_NAME
}

alias template=scaffoldGithub
alias last-template=simplifiedScaffoldGithub

To add alias you will need to add them to one of your environment config files. I usually have put them into .(ba|z)shrc files. After adding aliases & reloading the environment (source ~/.zshrc in my case) you can use them. Sample usages:

template https://github.com/kriasoft/react-starter-kit.git my-killer-startup-secret-product
template roman01la/f-react-kit
last-template glorious-app

At some point I almost had published this as a separate tool (just a set of executable shell scripts & installation script to link those to usr/bin) on github, because only thing I’ve seen doing something similar was scaffoldinpy. Although it might be I just didn’t look hard enough for this. Will appreciate feedback on this.

Readme.md as lazy persons html page

2015-05-14T00:00:00+00:00

Occasionally, working on some projects hosted on github, we put much time into creating useful & comprehensive README.md file for our project and I think you can benefit from using it to create html pages hosted on github that will be always in sync with the content.

Issue

When you might benefit from thing I’m talking about? For example, your README.md is magnificent & useful, you have some static examples hosted on github page but there’s no landing page and no connection between two. Whenever someone lands on your examples, if he knows how github pages work, he might edit the URL in his address bar & land on your repo (not everyone does & that’s quite normal). And on top of that, you don’t have time/skillset to do a cool static page and will be happy with something minimal for lack of better alternative. I turned to do this after I’ve seen I have different content in README.md & static page used for the folder (hosted on github pages) for statically hosted slides project of mine.

How to solve it?

Turn your README.md into static page! Your repo is already on github, and whenever you push something to branch name gh-pages it’s being build & published to %username%.github.io/%reponame% (given it’s enabled in the repo’s settings). Only exception is your very own github space that resides in repo called %username%.github.io and will be using master branch to build stuff out. [UPD 2020: you actually can now customize the branch & even tweak subfolder github pages are built from]. Github pages use Jekyll - static site generator written in Ruby. There’re some catches to it - you cannot run plugins on Github pages, Github is using some custom markdown parser, but those are minor considering how useful this feature is, providing static site hosting & ability to use markdown to create content (you can run your very own blog using Jekyll or Octopress built on top of it and pay noone for that). [UPD 2020: this blog is now using jekyll]

‘Code’ to do that

To signal Jekyll that some markdown needs processing, you add YAML syntax FrontMatter in the very beginning, which can be as brief as two sets of triple dashes, separated by newline.

---
---

Learned this some time ago when was battling with Jekyll for kottans.org site, which now seems to be a common knowledge, marked as ProTip in the corresponding section of documentation. But after README.md will be processed it will be output as ‘README.html’, which poses a minor issue. We don’t want to change the name of the file (README.md will rendered by default when looking at repo page using github), but we want to be able to navigate to root path of our project and still be able to see something instead of four-oh-four page, which means we want to have index.html page probably. I used something simple as static page that would be redirecting to README.html. There’re at least 2 different ways to redirect using <meta> tag and couple of ways to navigate to another page using JS, so it shouldn’t be of too much of a trouble. I ended with following code:

<!DOCTYPE html>
<html>
<head>
  <title>Redirecting to main site</title>
  <meta charset="UTF-8">
  <meta http-equiv="refresh" content="0;url=README.html">
</head>
<body>
  Redirecting<i>↻</i>
</body>
</html>

And that would be pretty much everything that needed to be made in order for your README.md get 2 horizontal rulers on top (those tripple dashes added for jekyll’s sake) & it’s very own html representation on your github pages.

Caveats

Broken Charset on Localhost & `_layouts`

If you use github-pages gem to bootstrap jekyll locally and directly going to ‘localhost:4000’ URL, you might see some issues with encoding because of lack of specification of proper character encoding. This won’t be a problem when pages are on Github, because Github sets charset=utf-8 encoding using Content-Type header. In any case, if that might be a problem for you, you might want to add layout with proper charset. For this, you will need to create _layouts folder and put default.html with following markup:

<!DOCTYPE html>
<html>
<head>
  <title>These are my precious slides!</title>
  <meta charset="UTF-8">
</head>
<body>
  {{ content }}
</body>
</html>

and in your README.md you will have to put

---
layout: default
---

which will render not that pretty when looking at your github project page, but as soon as you do that step you can add all sorts of customization and styling to the page.

Default markdown parser might work differently from Github’s

In process of creating html version page for one of my slides it turned out that markup of

Strike through heading

isn’t working in markup used in jekyll by default. Thanks to issue#1752 in jekyll repo I was able to go over bunch of different possible engines to render markdown to find the one that worked correctly for page that used github flavored markdown (spoiler: it was rdiscount). To set an engine used on your gh-pages, you will need to create _config.yml file in root of your project and put

markdown: rdiscount

into it. That did solve the issue of. 😼

Nested folders & `README.md`

Every folder, especially when it’s a separate entity/project, should have its own README.md to explain how/what/why of the contents. That will mean, that you will have to apply the same changes to the README’s content as to the one in you project root (and add redirecting page).

Write READMEs

Be a good person and don’t just throw your stuff over the fence in the world of open source. Share your work, show you care about it & people using it, and you will get tenfold in return. Hope this small note will help you have this while spending less time. Hope it was somewhat useful. 😇

Concurrency in JS

2015-05-04T00:00:00+00:00

Recently I’ve been to BostonJS at Bocoup, where Naveed Ihsanullah from Mozilla shared some of the upcoming concurrency features that will come to live supposedly in about a year (and this talk took place on 30th of April 2015).

Previously, closest we had to concurrency was usage of Web Workers, which solved some of the problems. It provided us with ability to offload heavy computations from our single threaded javascript. It was safe in terms of playing well with single threaded execution model, but involved some overhead for communication between main thread and workers, as well as imposing restrictions to what kind of code could run in those.

Looks like things are going to change. There’s a draft spec “Spec: JavaScript Shared Memory, Atomics, and Locks”, and this gist that talks about SharedArrayBuffer primitive that would be concurrently accessible. You could read about motivation and roadmap in February entry in Mozilla blog.

Naveed joked about bringing deadlocks & race conditions to previously safe js (which is great pun and will help make future interviews ‘funnier’: ‘- do you want to create static pages for us & validate some forms? - Yeah! - Great, tell us about concurrency & deadlocks in javascript’). I might have got previous paragraph distorted, so here’s an actual comment by Naveed:

Deadlocks are actually possible now in JavaScript. Shared memory and the associated locks, however, would potentially allow data races and new deadlocks because of synchronization. A bit different. What I meant is shared memory can be complex and JavaScript was spared that complexity in the past. Depending on how we finally choose to surface this functionality that may not be the case in the future.

It seems that API will be going through some dramatic changes over the course of next months. Naveed mentioned that on the day of the talk there was an interesting idea of looking into the way C++ handles threads & modifying the API slightly. For more details, you might want to take a look at this draft.

Closing up was the demo of visualizing Mandelbrot fractal, which used all 8 cores. Notably, it was also using SIMD, which made code run several times faster. The fractal demo itself was about 6x faster (using 8 cores instead of 1), than normal JS because of shared memory & threading. SIMD brought another 2.5-3.5x pefromance boost.

Such an API might be used to enable some great things in the web, as well as bring us another way to shoot ourselves in the foot.

Naveed did mention necessity of future involvement of library authors to wrap this powerful low-level primitives to bring end-users handy tools that would enable easier work, especially when it will involve VR, image processing and other heavy-computational activities that will get only more widespread as we go forward. Oh, Naveed did mention that there was a public indication that V8 team had intention of implementing this, so let’s just hope we will have this generally available in around a year.

All in all, this looks like interesting space to follow & I would definetely be looking forward to Naveed’s talk on JSCONF US 2015.

I want to thank Naveed for taking time to review this post & provide additional details I didn’t get right the first time 😼

ui.router: absolutely@nothing

2014-07-18T00:00:00+00:00

###Absolutely adressing views in angular-ui-router.

Something not many people had to leverage while working with ui-router is its ability to use absolute/relative addressing. Behind the scenes every ui-view gets assigned absolute path. You can easily find source for figuring out ‘@’-name for view by randomly poking around code or stepping over debugger (that happened in my case). This minor thing might come off handy some day when you’re dealing with irregular outlet structure or different view hierarhies, that are supposed to be sharing same views. In my case it was a task of having sidebar, which could have 2 different possible configurations & hierarchies – depending on different parts of the app – with state specific widget embedded into it. Naming my ui-view plug@sidebar in different outlets & addressing those in my state definition object worked like a charm. It might be a bit risky relying on internal API, so don’t forget to have tests for that & have proper dependency management. 😸

TIL: pre/post are for everybody!

2014-07-16T00:00:00+00:00

Just a short note on discovery (which is not too much of a discovery actually): you can use pre- & post- hooks in npm-scripts for your own custom tasks. So, next time you would need to run several things as part of one task, you could leverage those.

{
  "scripts": {
    "premyscript": "echo \"Pre stuff\"",
    "myscript": "echo \"LOL MY SCRIPT\" ",
    "postmyscript":"echo \"Post stuff\""
  }
}

So, if we run npm run myscript in the folder where package.json would hold abovementioned lines, we would see something like:

$ npm run myscript

> npm-test@0.0.0 premyscript /home/sudodoki/Projects/npm-test
> echo "Pre stuff"

Pre stuff

> npm-test@0.0.0 myscript /home/sudodoki/Projects/npm-test
> echo "LOL MY SCRIPT"

LOL MY SCRIPT

> npm-test@0.0.0 postmyscript /home/sudodoki/Projects/npm-test
> echo "Post stuff"

Post stuff

UPD (21/7/14): Note on this became part of oficial documentation. OSS FTW