
\documentclass[12pt]{article}
\usepackage[T2A,OT1]{fontenc}
\usepackage[default]{cantarell}
\usepackage[a4paper, top=20mm, bottom=20mm, left=20mm, right=20mm]{geometry}
\usepackage[utf8]{inputenc}
\usepackage[russian, english]{babel}
\usepackage{tabu}
\usepackage{hyperref}
\usepackage{parskip}
\usepackage{graphicx}
\usepackage{tabularx}
\usepackage[normalem]{ulem}
\usepackage{float}
\floatstyle{boxed}
\restylefloat{figure}
\usepackage{setspace}
\onehalfspacing
\author{Artyom Bologov \href{mailto:principles@aartaka.me}{(email)}}
\date{\today}
\title{My Blog Principles}
\makeatletter
\def\endenv{\expandafter\end\expandafter{\@currenvir}}
\makeatother
\begin{document}
\maketitle

\includegraphics[width=\textwidth,height=\textheight,keepaspectratio]{./assets/principles.png}

So over my (relatively) long blogging journey I’ve accumulated some crust of principles.
Ensuring that what I’m doing is kind and useful to people.
This led to some decisions.
Including ones that make my own blog maintenance slightly harder.
But I’m ready to suffer if this brings something good to others.
Here are things I formulated that must be true for my blog:

\section*{Accessibility} \label{accessibility}

\begin{itemize}
\item Posts should be easily readable even to the
  \href{run:stupid}{silly people like me}.
\item \href{run:3mins}{Shorter is better}.
\item More (shorter) sections are better for reading.
\item Color contrast between background and foreground, and between these and accent color—should be decent, close to WCAG AA (4.5 ratio.)
\item Colors should be minimal and soft.
\item Large font (\verb|font-size: large;|) by default.
\item Everything should be dark mode (\verb|prefers-color-scheme: dark|) friendly. Including the pictures, made in two versions—light and dark.
\item But dark mode should be togglable for those with arbitrary system settings.
  \href{https://codeberg.org/aartaka/pages/commit/fca12d4}{I’ve only implemented it recently}.
\item \href{https://vispero.com/resources/screen-readers-support-for-text-level-html-semantics}{Emphasis and other text-level elements} should be avoided. Because they don’t bear much meaning and are too noisy.
\item HTML should be semantic and
  \href{https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA#before_using_aria}{stick to built-in elements unless absolutely necessary}.
\item Most posts should be readable in all supported formats: HTML, .txt, Manpage, and LaTeX.
\begin{itemize}\item Exception: highly interactive pages / with forms.
    \href{run:kaktovik}{Like this Kaktovik numerals post}.
    \href{run:cv}{Or my HTML-only CV (go hire me!)}.
\end{itemize}
\item \href{https://sembr.org}{Semantic linebreaks}
  in source for easier editing and reading.
\item Sentences—or clauses, rather—should have less than 80 chars in them, because longer sentences are harder to read.
\end{itemize}

\section*{Cultural / Linguistic} \label{cultural}

\begin{itemize}
\item No “AI” for post polishing and writing.
  \href{run:not-ai}{I want to stay human}.
\item Do projects and writing in public, unless otherwise necessary.
  \href{https://codeberg.org/aartaka/pages}{This website build and content is fully public on Codeberg}.
  So you can easily snoop on my activities and preview drafts there.
\item Use an open license (Creative Commons as of April 2026) for the content.
\item they/them as the “default” pronouns.
\item English is the preferred language, followed by Interslavic, and only then by Russian. So far, I only have one post in Interslavic and ~80 in English. Based on this trend, you’re unlikely to see Russian posts in the next couple of years.
\begin{itemize}\item Because Russian is an imperial language forced onto many people to this day.
\begin{itemize}\item English is imperial too, but it’s slightly more neutral
\end{itemize}
\item Also because of accessibility to the widest possible audience.
\end{itemize}
\item Use smart curly quotes and apostrophes for English and angle quotes for Slavic languages.
\item Use classic punctuation (punctuation is put before quotes and parentheses!) for English and
  \href{https://slate.com/human-interest/2011/05/logical-punctuation-should-we-start-placing-commas-outside-quotation-marks.html}{logical punctuation}
  for Slavic languages.
\item \href{https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a#strong_link_text}{Make link text a good indicator of where it leads}.
\end{itemize}

\section*{Technical} \label{technical}

\begin{itemize}\item \href{https://jeffhuang.com/designed_to_last}{Designed To Last}.
\item \href{run:hypertext}{Hypertext first}.
\item \href{run:markdown}{No Markdown}.
  \href{run:pidgin}{Only Pidgin HTML}.
\item JavaScript should only be used when direly necessary. If it’s used, it should only progressively enhance the page.
\begin{itemize}\item My code should never block one from engaging with the post with JS off.
\end{itemize}
\item CSS should be minimal and Widely Available as per Baseline.
\begin{itemize}\item In case it’s not Baseline, it should only be used when progressively enhancing the page.
\end{itemize}
\item \href{https://developer.mozilla.org/en-US/docs/Glossary/Graceful_degradation}{Gracefully degrade} if both of the previous points fail.
\item The site should be reasonably static and all the generation load should be offloaded to a machine I own and not to the user.
\begin{itemize}\item \href{run:this-post-is-ed}{Right now, it’s all built on my laptop with ed(1)}.
\end{itemize}
\item The tech used in building the site should be standard, portable, and non-vendor-locked.
  Which means: HTML, CSS, vanilla JS (no frameworks,) Lisp, C, and ed(1)
\item There’s preferably no machine I manage in site deployment.
  \href{run:digital-bum}{As per Digital Bum manifesto}.
  \href{run:codeberg-pages}{Right now, it’s all Codeberg Pages}.
\item Size of the page and assets should be ruthlessly optimized for those on slow connection.
\begin{itemize}\item Images are generated as lazy by default.
\item And compressed as much as possible.
\end{itemize}
\item No analytics.
\item No CDNs—all content is shipped with the site. Safer and more reliable this way.
\end{itemize}


\par\noindent\rule{\textwidth}{0.4pt}
\href{https://creativecommons.org/licenses/by/4.0}{CC-BY 4.0} 2022-2026 by Artyom Bologov (aartaka,)
\href{https://codeberg.org/aartaka/pages/commit/a91befa}{with one commit remixing Claude-generated code}.
Any and all opinions listed here are my own and not representative of my employers; future, past and present.
\end{document}
