Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions STANDARDS.md
Original file line number Diff line number Diff line change
Expand Up @@ -237,8 +237,18 @@ block or reference an `assets/` file. The per-project-type docs
type-specific skeletons.

**Rendering rules (measured, not assumed).** Each of these was found by
rendering a README through `gh api /markdown` and looking at the page;
none of them are visible while reading the markdown source.
rendering a README and looking at the page; none of them are visible
while reading the markdown source.

**Render it the way a README is rendered.** `gh api /markdown` takes a
`mode`, and the two modes disagree about the thing most of these rules
are about. `mode: "gfm"` is *comment* semantics: every single newline
becomes a `<br>`, and no heading anchors are emitted. `mode: "markdown"`
is what a README gets: newlines inside a paragraph join, and headings
carry the anchors that in-page links depend on. *Measured on one file:
116 `<br>` outside code under gfm, zero under markdown.* Verifying a
README under gfm shows you a page no reader will see — and it hides
exactly the line-collapse the next rule is about.
Comment on lines +243 to +251

- **The README is not the fold on a GitHub repository page.** *Measured
on a 1090 px-wide capture: the README began ~1080 px down; the first
Expand Down
14 changes: 12 additions & 2 deletions STANDARDS.tr.md
Original file line number Diff line number Diff line change
Expand Up @@ -241,8 +241,18 @@ bloğu ya da `assets/` referansı şart. Proje-tipi rehberleri
tip-spesifik iskeletlerle yeniden ifade eder.

**Render kuralları (ölçüldü, varsayılmadı).** Aşağıdakilerin hepsi bir
README'yi `gh api /markdown` ile render edip sayfaya BAKARAK bulundu;
hiçbiri markdown kaynağı okunurken görünmüyor.
README render edilip sayfaya BAKARAK bulundu; hiçbiri markdown kaynağı
okunurken görünmüyor.

**README nasıl render ediliyorsa öyle render et.** `gh api /markdown`
bir `mode` alıyor ve iki mod, bu kuralların asıl konusunda birbirine
zıt. `mode: "gfm"` YORUM semantiğidir: her tek satır sonu `<br>` olur ve
başlık çapası hiç üretilmez. `mode: "markdown"` README'nin aldığıdır:
paragraf içindeki satırlar birleşir, başlıklar sayfa-içi linklerin
dayandığı çapaları taşır. *Tek dosyada ölçüldü: gfm'de kod dışında 116
`<br>`, markdown'da sıfır.* README'yi gfm ile doğrulamak, hiçbir okurun
görmeyeceği bir sayfaya bakmaktır — üstelik bir sonraki kuralın konusu
olan satır-çökmesini tam da gizler.
Comment on lines +247 to +255

- **GitHub repo sayfasında fold README değildir.** *1090 px genişlikte
ölçüldü: README ~1080 px aşağıda başlıyor; ilk ekran dosya listesi ve
Expand Down
5 changes: 3 additions & 2 deletions overlay/PUBLISHED-VERDICT.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,8 @@ defends.**

# Repo-Name

[badge row — ALL badges on ONE source line, EVERY badge linked]
[badge row — EVERY badge linked; source lines may be separate,
they join in a paragraph]
Comment on lines +70 to +71

*[tagline — one italic sentence]*

Expand Down Expand Up @@ -213,7 +214,7 @@ when a cross-reference dies.
## 10. Checklist

- [ ] Hero alone on the first screen; no second image competing
- [ ] Badge row on one source line, every badge linked
- [ ] Every badge in the row is a link
- [ ] Lede names the runtime ("Python", "stdlib-only") — grep for it
- [ ] Status stamp above the fold, full `## Status` in the lower third
- [ ] `## Run it` present, fenced, language-tagged, and offline
Expand Down
2 changes: 1 addition & 1 deletion project-type/TOOL.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ a tool-flavoured skeleton:

# tool-name

[badge row — one source line, every badge linked]
[badge row — every badge linked]

*[tagline — one italic sentence]*

Expand Down