ستاسو د کارکوونکو پوهیږي مخکې له دې چې دا څه جوړوي

هرڅوک کولی شي په ویب پاڼه کې یو ماډل اشاره وکړي. دا هغه قوانین دي چې دا هرې پاڼې ته پلي کیږي، ولې هر یو شتون لري، او کوم چې د دې په اړه خبرداری ورکولو پرځای د خپرولو مخه نیسي.

هر قانون لاندې د یو ځای په اړه د پیښې له امله تادیه شوی و چې موږ یې چلوو - د درجه بندي غار، یو مات شوی ژباړه، یو پاڼه چې د خپل سرچینې کوډ یې رامینځته کړی. موږ په غوره عمل کې اټکل نه کوو؛ موږ لیکو چې څه غلط شوي نو دا ستاسو په سایټ کې غلط نه ځي.

قواعد چې د خپرولو outright بندوي: 8 د 12. د بند شوي مخ د دلیل سره د کارمند سره بیرته ورکړل کیږي، او دا بیا هڅه کوي. دا نه خپروي او تاسو وروسته خبرداری درکوي.

1. One page, one subject

خپرول

Exactly one <h1>. A descriptive <title> of 15-60 characters.

ولې: Title is the strongest per-page signal Google has. Google rewrites titles for the SERP most of the time, but the signal it forms from yours still affects ranking, and a generic or duplicated title reads as a quality problem.

2. A description written for a human

خبرتياوې

A meta description of 140-158 characters, unique to the page.

ولې: Description does not rank the page, it decides whether anyone clicks it. Too short wastes the snippet; too long truncates mid-sentence.

3. No shared body text, ever

خپرول

Every page gets body copy and FAQ answers written for that page. Never a shared template with a noun swapped in.

ولې: This is the one that costs months. A site we run shipped ~1700 pages on one generic FAQ body and a site-level quality classifier suppressed the whole domain — pages still indexed, ranking gone, no manual action to appeal. Recovery ran on core-update timescale.

4. Absolute canonical, paired with hreflang

خپرول

Every page self-canonicalises with an absolute URL. Any hreflang cluster ships alongside that canonical, also absolute.

ولې: Relative hrefs are silently dropped. hreflang without a self-canonical fills the index report with "Duplicate without user-selected canonical" — 56,801 pages on one site we run.

5. Markup may only claim what the page shows

خپرول

Structured data mirrors the visible text exactly. Schema goes on the page types that earn a rich result, not on everything.

ولې: Schema is not a general ranking input and not required for AI search -- Google says so directly. Markup that claims a price or a question the page never shows is a violation that can earn a manual action.

6. Django comments are {% comment %}

خپرول

Never {# #}. Not even on one line.

ولې: Django's template lexer regex has no DOTALL flag, so {# #} only closes on its own line. A multi-line one renders as visible page text, and if it contains a {% %} substring the lexer treats it as a real tag and every render crashes. Both have happened in production.

7. Positional {0} slots in translatable strings

خپرول

Any string that will be machine-translated uses {0}, {1} — never {name}.

ولې: MT engines translate or transliterate the word inside the braces, or drop a brace entirely. A numeric slot has no word to translate and survives intact. This silently broke about 10% of non-English rows on one site before anyone noticed.

8. Nothing is indexable until it is finished

خپرول

Pages ship noindex. Indexing is a deliberate opt-in by the owner, per site.

ولې: These sites share a wildcard domain. One spam tenant indexed on that wildcard damages every other tenant on it, and a half-finished page indexed on day one takes months to undo.

9. Build the thing, do not describe the thing

خبرتياوې

A page either does something useful or says something specific. A page that only describes a tool is not a page.

ولې: Thin wrappers around someone else's API are the clearest signal a quality classifier has. Real utility is what survives a core update.

11. Alt text and intrinsic dimensions on every image

خبرتياوې

Every <img> has alt text and explicit width/height.

ولې: Alt text is an accessibility requirement first and an indexing signal second. Missing dimensions cause layout shift, which is a Core Web Vitals failure on mobile — and mobile is what gets indexed.

12. Retired URLs return 410, verified

خپرول

A removed page returns 410 Gone, confirmed by an actual request after deploy.

ولې: A 404 lingers as a soft-404 for months; a 410 deindexes cleanly. And per-view dispatch often intercepts the request before the 410-returning view is ever reached, so the check has to be a real HTTP request, not a code read.

ولې دا يو لنډيز دی او نه يو ډول لارښود

یو قاعده چې یوازې په یو لارښود کې ژوند کوي یو وړاندیز دی - ماډل د وخت ډیر وخت تعقیب کوي او په آرامۍ سره پاتې نه کوي، او تاسو د ترافیک راپور کې درې میاشتې وروسته ومومئ. نو دا د کوډ په توګه چلیږي، وروسته له دې چې پاڼه لیکل کیږي او مخکې له دې چې ژوندي شي. یو پاڼه چې د بندولو قانون ناکاموي د دلیل سره بیرته ورکول کیږي او بیا لیکل کیږي. پایله د هر ډول ترلاسه کولو په اړه ده، نو تاسو کولی شئ وګورئ چې کوم چکونه روان دي.

او هېڅ نه لړيال کيږي تر هغه چې تاسو دا وواياست

هر سایټ د noindex پیل کوي. نه د default په توګه تاسو باید کشف کړئ - د قانون په توګه د لیټینټ پلي کول، ځکه چې دا سایټونه د ډومین شریکوي او یو بد ګاونډی په دې کې هرڅوک زیان رسوي. کله چې ستاسو سایټ د موندلو ارزښت لري، تاسو په ترتیباتو کې انډکس کول پیل کوئ او دا د کرول کولو پیل کوي.

د هر مخ د linter پایله د خپل ترلاسه ثبت شوی، او د ترلاسه شويو دي API په سر کې.

زما شرکت وړیا جوړ کړئ