cue-lang / docs-and-content

A place to discuss, plan, and track documentation on cuelang.org
6 stars 1 forks source link

docs/tour/basics/duplicate-fields should be retitled "Unification" #128

Closed jpluscplusm closed 4 months ago

jpluscplusm commented 6 months ago

What page were you looking at?

https://cuelang.org/docs/tour/basics/duplicate-fields/

What version of the site were you looking at?

https://github.com/cue-lang/cuelang.org/commit/3fba290b6e6b503514b07c81b85902f300859840

What did you do?

I went looking for the canonical page that introduces unification.

What did you expect?

That the page would be titled "Unification", as that's the most important concept it contains.

What did you see instead?

The page is titled "Duplicate fields". Which, whilst not wrong, doesn't get to the heart of the page's content.

Also

Making this change isn't just a page title change - it will involve rewording some prose and changing the order of the page's text.

jpluscplusm commented 5 months ago

Bumping this, as it just struck me again. Searching for "Unification" still doesn't make this page "pop" ...

jpluscplusm commented 4 months ago

Closed via https://github.com/cue-lang/cuelang.org/commit/9f3ad002707774702479b0b519c026e4d222dc8a