Who writes it
The handbook is kept by Yarik Kalytiuk, a developer who has been building websites in Kyiv since 2007, together with the team of Web Gate, a small Kyiv studio that designs and builds websites. The pages grew out of the notes we write when we check our own projects. We tidied them up so they make sense to anyone.
Where the advice comes from
When a page gives a number, like how dark text should be or how big a button should be, that number comes from a published source, and the page links to it. Most of them come from WCAG 2.2, the web accessibility guidelines from the W3C, which many countries use in their laws. For phones, we use the guides from Apple and Google. For how browsers behave, we rely on MDN Web Docs, and for how people actually use screens, on research from the Nielsen Norman Group.
When a page gives advice without a number, it comes from our own experience of building and checking websites. We try to make it clear which is which.
About the drawings
The pictures on each page are drawings made for this handbook, not screenshots of real apps or websites. That way you see only the difference that matters, without a famous brand getting in the way. The names, prices and dates in them are made up.
Keeping it up to date
Rules and browsers change over time. We read every page again at least twice a year, and also whenever an important guideline changes. The date at the top of each page shows when it was last checked. This site has no adverts, no tracking and no cookies.
Spotted a mistake?
If something here is wrong or out of date, we would really like to know. Write to us through the contact form on the studio’s website, and tell us the page and the sentence. When we confirm a mistake, we fix it and note the change on the page.
Using the pages
You are welcome to link to any page, to quote a piece of advice with a link back, or to print the review checklist for your team. Please don’t copy whole pages.