Pagsulat

Pagbaybay

Ang prosa ay nasa British English: behaviour, colour, organise, licence. Ang dalawang eksepsiyon ay sinadya at parehong nasa code, hindi sa prosa. Pinapanatili ng isang code identifier kung anumang ispeling ang ginagamit ng API nito, kaya ang color property ay nananatiling color. At sa buong pagsulat tungkol sa Module Federation, ang artifact ay isang terminong teknikal (isang na-publish, na-version na module), kaya pinapanatili nito ang ispeling na iyon habang ang karaniwang prosa ay isinusulat pa ring artefact.

Case

Sentence case ang istilo ng bahay: ang mga pamagat ng pahina, section heading, article heading, button at label ay nilalagyan ng malaking titik ang unang salita at anumang pantanging ngalan, at wala nang iba. Ang itaas na navigation ang tanging eksepsiyon, na pinapanatili sa title case.

Mga petsa

British ang mga petsa. Binabaybay nang buo ng petsa ng artikulo ang buwan: 29 March 2026. Pinapaikli ng saklaw ng tungkulin ang buwan at pinapanatili ang taon, Mar 2016 hanggang sa kasalukuyan, at nagtatapos ang bukás na saklaw sa salitang Present, hindi kailanman sa nakabitin na gitling.

Bantas

Ang serial comma ang default: labels, hints, and states. Ang mga tandang padamdam ay hindi ginagamit sa prosa. Ang truncation at loading state ay gumagamit ng iisang ellipsis character, ang isang aside ay gumagamit ng spaced em-dash, at ang isang metadata row ay naghihiwalay ng mga bahagi nito gamit ang middot. Ang tatlong tuldok na magkakasunod ay para sa code, hindi sa mga pangungusap.

Mga link

Inilalarawan ng teksto ng link kung saan ito papunta. Hindi kailanman nili-link ng site ang mga salitang click here o read more, o isang payak na here o this; ang isang link ay nababasa bilang ang bagay na tinuturo nito.

Mga pangalan ng brand at produkto

Pinapanatili ng mga pangalan ng produkto ang kanilang opisyal na ispeling at casing. Ang React Native at Module Federation ay tig-dalawang salita na naka-title case; ang Pokémon at Pokédex ay laging may accent; ang App Store ay dalawang salita. Kung saan may eksaktong anyo ang isang pangalan, tumbasan ito sa halip na ayusin.

Cross-linking

Malayang nagtuturo ang mga post sa isa’t isa: ang pangungusap na bumabanggit sa token-refresh post ay naka-link doon, at pinapangalanan ng link text ang pupuntahan gaya sa itaas. Puwede pang tumuro ang mga link sa mga post na hindi pa lumalabas. Ang link sa hindi pa na-publish na post ay simpleng lumalabas bilang plain text, kaya walang kailanman nagre-404, at kusang nagiging link ang mga salitang iyon kapag na-publish ang pupuntahan. Ang mga forward reference ay isinusulat nang isang beses at nareresolba nang kusa.

Bawat post ay maaaring pumili ng hanggang tatlong related post ; ang mga walang pinili ay babagsak sa mga shared tag. May further-reading shelf na nagdadagdag ng mas tahimik na mga post na malamang hindi pa nakikita ng mambabasa, na may tope na siyam sa kabuuan, para manatili itong rekomendasyon at hindi archive.

Sa loob ng isang serye, ang previous at next ay nananatili sa loob ng serye: ang part five ay tumuturo sa parts four at six, hindi kailanman sa walang kaugnayang post na nagkataong lumabas katabi nito. Sa mga dulo lang ng serye babagsak ang mga arrow sa katabing post ayon sa petsa.

Pagtutol sa sulat

Maraming tinututulan ang technical writing dito: mga default, mga sikat na library, mga minanang paniniwala. Ang rule ay i-steelman muna. Ilahad ang kabilang panig sa pinakamalakas nitong bersyon, kilalanin ang tama nito, saka ipakita kung saan ito huminto sa paggana para sa kasong pinag-uusapan. Ang pagtutol ay dumadating bilang obserbasyon tungkol sa akma, hindi bilang paghatol.

Dalawang gawi ang sumusuporta rito. Ang hindi absolute ay hindi isinusulat bilang absolute: ang “X never works” ay nagiging “X was not designed for Y”. At walang defensive opener: ang mga pangungusap ay hindi nagsisimula sa “To be clear” o “Just to clarify”.

Mga social teaser

Kapag ibinahagi ang isang post sa LinkedIn, teaser ang ibinabahagi, hindi buod. Iisa lang ang trabaho nito: magbukas ng curiosity gap na isasara ng artikulo: maglahad ng tensyon, magbanggit ng espesipikong detalye nang hindi ipinapaliwanag, at ituro pasulong. Kung nasiyahan na ang mambabasa nang hindi nag-click, pumalya ang teaser.

• Mga 500 character, bawat pangungusap ay may pinaglalaban.
• Walang link sa body; ang link ay nasa unang komento.
• Tatlo hanggang limang hashtag, hindi hihigit.
• Walang exclamation mark, at walang rhetorical question bilang pang-akit.
• First person singular, isinulat mula sa senior authority: walang self-deprecation, walang imbentong war story.
• Hindi kailanman pinapangalanan ang mga employer o internal project.