Absurd w świecie Linux. Ważne API czekało sześć lat na podstawową dokumentację

Podstawowy kod systemowy nie zmienia się tak szybko jak najnowsze trendy programistyczne - musi być stabilny, wydajny i dokładnie przetestowany. Czasami jednak opóźnienia przyjmują absurdalne rozmiary, jak w przypadku dokumentacji współczesnego API systemu plików w Linuksie. Według informacji Phoronix, użytkownicy musieli czekać ponad sześć lat na pojawienie się oficjalnej dokumentacji w standardowych stronach podręcznika systemowego.

Historia rozpoczęła się w 2019 roku, gdy Linux otrzymał nowe API do montowania systemów plików. Główne wywołania "fsconfig", "fsmount" i "fsopen" zastąpiły stary, monolityczny "mount", oferując programistom czystszy kod, lepszą obsługę błędów i czytelne komunikaty zamiast zagadkowego "mount failed".

Programista David Howells napisał wersje robocze dokumentacji już w 2020 roku, ale nigdy nie zostały one włączone do pakietu manual pages. Opiekunowie projektu nie chcieli publikować potencjalnie niekompletnych lub nieprecyzyjnych szkiców. Howells najwyraźniej nie był w stanie dokończyć pracy, a nikt inny się nie zgłosił do tego zadania.

Absurdalny wymóg blokował Linux przez lata - nikt nie chciał pisać w Groffie

Przez kolejne lata programiści chcący korzystać z nowego systemu musieli przedzierać się przez trudny do odczytania plik w kodzie źródłowym jądra, szukać dyskusji na liście mailingowej lub czytać dziesiątki notatek z łatek. W najlepszym przypadku pomocne okazywały się zewnętrzne strony internetowe z nieoficjalnymi poradnikami. Jednym z powodów braku chętnych do napisania dokumentacji był wymagany format, czyli 35-letni Groff, na tyle nieczytelny dla człowieka, że pisanie w nim było prawdziwym koszmarem.

Historia rozpoczęła się w 2019 roku, gdy Linux otrzymał nowe API do montowania systemów plików.

W 2024 roku ekspert od dokumentacji Christian Brauner stwierdził, że "lata pisania w Groffie go zmęczyły" i stworzył własne repozytorium z wersjami stron w Markdown. Dopiero w październiku 2025 roku oficjalny pakiet manual pages wreszcie zawiera te strony.

Brak dokumentacji mógł przyczynić się do opóźnień we wdrażaniu nowego API przez różne systemy plików. Ext4 zaimplementował je dopiero w 2022 roku, CIFS w 2023, Btrfs w 2024, a implementacja F2FS wciąż jest w trakcie realizacji.