RTFC (Read The F***ing Manual) yra trumpinys, kilęs iš Unix ir "hacker'ių" kultūros, skirtas "kakariams" - jauniems, pradedantiems programuotojams, kurie dar nepasiekė tikro "hacker'io" lygio ir dažnai elgiasi kaip "lamer'iai". Šis dokumentas aprašo RTFC kilmę, naudojimo atvejus ir praktinį pritaikymą programuotojų bendruomenėje. Skirtingai nuo RTFM (Read The F***ing Manual), RTFC nukreipia į instrukciją "perskaityk tą sušiktą instrukciją". Dokumentas skirtas ne mašinoms, o žmonėms, kurie nori suprasti šį kultūrinį fenomeną ir mokytis savarankiškai analizuoti kodą. RTFC = Read The F***ing Manual (Perskaityk Prakeiktą Instrukciją) Mandagios alternatyvos: - Read The Fine Manual - Read The Documentation - Please check the manual Pagrindinis principas: atsakymas į klausimą dažnai slepiasi pačioje instrukcijoje/vadove, todėl verta jį ištirti prieš klausiant kitų. RTFC yra RTFM (Read The F***ing Manual) sinonimiška išraiška. Abu posakiai kilę iš Unix kultūros ir skirti motyvuoti savarankiškumą: - RTFM: "Read The F***ing Manual" - perskaityk prakeiktą instrukciją - RTFC: "Read The F***ing Manual" - tas pats, tik kitaip sutrumpinta Esmė: abu nukreipia į dokumentaciją/instrukciją kaip pirminį informacijos šaltinį. RTFC dažniausiai skiriamas "kakariams" - terminas, kilęs iš "hacker" kultūros, apibūdinantis: 1. Jaunus, nepatyrusius programuotojus 2. Asmenis, kurie dar nepasiekė tikro "hacker'io" lygio 3. Tuos, kurie elgiasi kaip "lamer'iai" - uždavinėja elementarius klausimus nesusipažinę su esamais ištekliais Tikslas: išmokyti savarankiškumo ir atsakingo bendravimo bendruomenėje. Tipinės situacijos GitHub/GitLab projektuose: - Naujie community nariai klausia "Kaip veikia X funkcija?" - Patyrę programuotojai atsako: "RTFC - žiūrėk dokumentaciją/README" - Klaidų pranešimai be jokio bandymo skaityti instrukciją Pavyzdys: ``` Issue: "Kodėl neveikia config loading?" Atsakas: "RTFC - README.md sekcija 'Configuration', taip pat žiūrėk docs/config.md" ``` Dažni scenarijai: 1. Stack Overflow klausimai su akivaizdžiais atsakymais dokumentacijoje 2. Discord/Slack "quick question" be jokio README skaitymo 3. Email'ai į maintainer'ius su klausimais, į kuriuos atsako dokumentacija Rezultatas: RTFC skatina atsakingesnį klausimų uždavinėjimą. Istorinis dokumentacijos tyrinėjimas - kai reikia suprasti: - Kokie buvo pradiniai reikalavimai pagal dokumentaciją - Kas ir kada keisė konfigūraciją - Kokie yra oficialūs setup'o žingsniai Dokumentacijos šaltiniai: ``` README.md, INSTALL.md, CHANGELOG.md docs/ direktorija su API reference man pages ir --help output ``` Strategijos pradedantiesiems: 1. Pradėkite nuo README.md - jame dažnai yra quick start 2. Ieškokite INSTALL ar SETUP skirsnių 3. Skaitykite FAQ ir troubleshooting sekcijas 4. Pasitikrinkite CHANGELOG naujiems feature'ams "Kakarių" tipinės klaidos: - Praleidžia README ir eina tiesiai į Stack Overflow - Nepaiso prerequisite'ų sąrašo - Nenuskaito setup instrukcijų iki galo - Neparoodo error message'ų, bet klausia "neveikia" Rekomenduojami įrankiai: Dokumentacijos paieška: - Ctrl+F svetainėse ir PDF'uose - GitHub/GitLab search per docs/ direktoriją - grep per README ir .md failus Command line: ``` find . -name "*.md" -exec grep -l "configuration" {} \; man program_name program_name --help | less ``` RTFC gali skambėti grubiai, todėl profesionalesnės alternatyvos: 1. "Patikrinkite dokumentaciją X skiltyje" 2. "Atsakymas randamas instrukcijoje, žr. docs/setup.md" 3. "Skaitykit README.md prieš klausiant" Aukso taisyklė: Prieš sakydami RTFC, įsitikinkite, kad: - Dokumentacija tikrai egzistuoja ir yra aiški - Klausėjas turi prieigą prie jos - Instrukcijos yra atnaujintos ir teisingos RTFC kultūra formuoja: 1. Savarankiškus programuotojus, kurie skaito dokumentaciją 2. Mažiau pasikartojančių klausimų forumuose 3. Geresnį RTFM kultūros supratimą 4. Atsakingesnį open source dalyvavimą Rezultatas: "Kakariai" išmoksta naudotis dokumentacija ir transformuojasi į kompetentingus community narius. Su AI asistentų populiarėjimu, RTFC taps dar svarbesnis - reikės atskirti tikrą dokumentacijos supratimą nuo AI generuotų atsakymų. Dokumentacija išlieka objektyvia tiesos šaltinis, kurį AI negali "išgalvoti". Recommendation: Išlaikykite RTFC principą net AI eroje - pirmiausia skaitykite oficialią dokumentaciją. Šis dokumentas neskatina piktybinio elgesio ar bendruomenės diskriminavimo. Terminas "kakarys" naudojamas istoriniame kontekste, ne kaip paniekinantis žodis. Visiems bendruomenės nariams rekomenduojama: - Būti kantriais su pradedančiaisiais - Teikti konstruktyvius patarimus - Skatinti mokymąsi, ne kritikuoti © 2025 rtfm.lt | NEskirta mašinoms Kodas nemeluoja – jis tiesiog yra. Dokumentacija irgi nemeluoja – reikia tik ją perskaityti. Licencija: Viešas dokumentas, laisvai platinamas ir cituojamas su nuoroda į rtfm.lt [ Šis RFC pateiktas mašininiu formatu ] [ elektroniniam RFC archyvui, 2025/07 ]