https://fedoraproject.org/w/index.php?title=User:Dafrito/Naming_conventions&feed=atom&action=historyUser:Dafrito/Naming conventions - Revision history2024-03-29T15:06:35ZRevision history for this page on the wikiMediaWiki 1.39.4https://fedoraproject.org/w/index.php?title=User:Dafrito/Naming_conventions&diff=183418&oldid=prevDafrito: Revisions, revisions2010-06-30T01:19:26Z<p>Revisions, revisions</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revision as of 01:19, 30 June 2010</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1">Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>I feel like there's <del style="font-weight: bold; text-decoration: none;">a </del>usability <del style="font-weight: bold; text-decoration: none;">concern </del>with some <del style="font-weight: bold; text-decoration: none;">of the article names </del>in the Fedora Project wiki. Here's a sample of some <del style="font-weight: bold; text-decoration: none;">that have irked me</del>:</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>I feel like there's usability <ins style="font-weight: bold; text-decoration: none;">issues </ins>with some <ins style="font-weight: bold; text-decoration: none;">articles </ins>in the Fedora Project wiki. Here's a sample of some <ins style="font-weight: bold; text-decoration: none;">of them</ins>:</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* [[Websites]]</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* [[Websites]]</div></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l6">Line 6:</td>
<td colspan="2" class="diff-lineno">Line 6:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* [[Overview]]</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* [[Overview]]</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>These should be renamed to be more indicative of their content. "Fedora" should be included for project pages, <del style="font-weight: bold; text-decoration: none;">and vague </del>non-wiki-like titles such as "Overview" should be renamed.</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>These <ins style="font-weight: bold; text-decoration: none;">pages </ins>should be renamed to be more indicative of their content. <ins style="font-weight: bold; text-decoration: none;">Specifically, </ins>"Fedora" should be included for project pages, non-wiki-like titles such as "Overview" should be renamed<ins style="font-weight: bold; text-decoration: none;">, and esoteric abbreviations like L10N should be expanded</ins>.</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* Websites -> [[Fedora Websites]]</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* Websites -> [[Fedora Websites]]</div></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l13">Line 13:</td>
<td colspan="2" class="diff-lineno">Line 13:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* Overview -> [[Fedora Project]] (or perhaps simply [[Fedora]])</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* Overview -> [[Fedora Project]] (or perhaps simply [[Fedora]])</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Most pages should not include Fedora, since the Fedora wiki implies a bias towards Fedora-related information. For example, I expect a page on [[Red Hat contributions]] to contain contributions that Red Hat has made to Fedora.</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Most pages should not include Fedora, since the Fedora wiki <ins style="font-weight: bold; text-decoration: none;">already </ins>implies a bias towards Fedora-related information. For example, I expect a page on [[Red Hat contributions]] to contain contributions that Red Hat has made to Fedora<ins style="font-weight: bold; text-decoration: none;">, so I feel like this is a suitable name</ins>.</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>I don't think this bias is strong enough <del style="font-weight: bold; text-decoration: none;">for our </del>project pages<del style="font-weight: bold; text-decoration: none;">, or ones that are very vague</del>. I'm not likely to assume that page called "Websites" is a project page since the name gives me no indication.</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>I don't think this bias is <ins style="font-weight: bold; text-decoration: none;">a </ins>strong enough <ins style="font-weight: bold; text-decoration: none;">reason to exclude it from </ins>project pages. I'm not likely to assume that page called "Websites" is a project page since the name gives me no indication<ins style="font-weight: bold; text-decoration: none;">. The repetition of "Fedora" and the capitalization in "Fedora Websites" in the URL reinforces the fact that the page is about a group called "Fedora Websites," rather than websites in Fedora</ins>.</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div><del style="font-weight: bold; text-decoration: none;">The repetition of "Fedora" and the capitalization in "Fedora Websites" in the URL gives me this indication. It reinforces the fact that the page is not just about "websites in Fedora" but rather about a proper noun called "Fedora Websites."</del></div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Redirects from "Fedora *" do not sufficiently solve the problem. The <ins style="font-weight: bold; text-decoration: none;">title on the </ins>article <ins style="font-weight: bold; text-decoration: none;">page </ins>will still be without "Fedora" and so will still evoke confusion. Tooltips shown by mousing over a link will also show <ins style="font-weight: bold; text-decoration: none;">this ambiguous </ins>title.</div></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div> </div></td><td colspan="2" class="diff-side-added"></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Redirects from "Fedora *" do not sufficiently solve the problem. The article<del style="font-weight: bold; text-decoration: none;">'s title </del>will still be without "Fedora" and so will still evoke confusion. Tooltips shown by mousing over a link will also show <del style="font-weight: bold; text-decoration: none;">the vague </del>title<del style="font-weight: bold; text-decoration: none;">. After all, redirects should redirect to a more specific or appropriate name, not a less appropriate one</del>.</div></td><td colspan="2" class="diff-side-added"></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Ordinarily, I wouldn't think the repetition of "Fedora" is necessary. http://fedoraproject.org/docs reads much better than http://fedoraproject.org/fedora_docs. This is because I read it as "the docs page in the Fedora Project" and I am not confused. More importantly, I don't have any learned expectations about its content.</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Ordinarily, I wouldn't think the repetition of "Fedora" is necessary. http://fedoraproject.org/docs reads much better than http://fedoraproject.org/fedora_docs. This is because I read it as "the docs page in the Fedora Project" and I am not confused. More importantly, I don't have any learned expectations about its content.</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Wiki pages do have learned expectations. When given a URL to a wiki page, I <del style="font-weight: bold; text-decoration: none;">learned </del>that the content will be an article, and the last part of the URL is the article title. This is why URLs like</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Wiki pages do have learned expectations. When given a URL to a wiki page, I <ins style="font-weight: bold; text-decoration: none;">expect </ins>that the content will be an article, and <ins style="font-weight: bold; text-decoration: none;">I expect </ins>the last part of the URL is the article title. This is why URLs like http://en.wikipedia.org/wiki/Wiki do not strike me as redundant or confusing. On the other hand, I ''would'' be confused if http://en.wikipedia.org/wiki/Overview contained an overview of the Wikipedia.</div></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>http://en.wikipedia.org/wiki/Wiki do not strike me as redundant or confusing. On the other hand, I ''would'' be confused if http://en.wikipedia.org/wiki/Overview contained an overview of the Wikipedia.</div></td><td colspan="2" class="diff-side-added"></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><br/></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Our wiki sadly violates these expectations. We name some articles using a "naive" convention, so the page's subject is ambiguous<del style="font-weight: bold; text-decoration: none;">. This is a prime example of cognitive dissonance</del>.</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Our wiki sadly violates these expectations. We name some articles using a "naive" convention, so the page's subject is ambiguous.</div></td></tr>
</table>Dafritohttps://fedoraproject.org/w/index.php?title=User:Dafrito/Naming_conventions&diff=183416&oldid=prevDafrito: A page on my opinions regarding naming conventions2010-06-30T01:05:19Z<p>A page on my opinions regarding naming conventions</p>
<p><b>New page</b></p><div>I feel like there's a usability concern with some of the article names in the Fedora Project wiki. Here's a sample of some that have irked me:<br />
<br />
* [[Websites]]<br />
* [[Women]]<br />
* [[L10N]]<br />
* [[Overview]]<br />
<br />
These should be renamed to be more indicative of their content. "Fedora" should be included for project pages, and vague non-wiki-like titles such as "Overview" should be renamed.<br />
<br />
* Websites -> [[Fedora Websites]]<br />
* Women -> [[Fedora Women]]<br />
* L10N -> [[Fedora Localization]]<br />
* Overview -> [[Fedora Project]] (or perhaps simply [[Fedora]])<br />
<br />
Most pages should not include Fedora, since the Fedora wiki implies a bias towards Fedora-related information. For example, I expect a page on [[Red Hat contributions]] to contain contributions that Red Hat has made to Fedora.<br />
<br />
I don't think this bias is strong enough for our project pages, or ones that are very vague. I'm not likely to assume that page called "Websites" is a project page since the name gives me no indication.<br />
<br />
The repetition of "Fedora" and the capitalization in "Fedora Websites" in the URL gives me this indication. It reinforces the fact that the page is not just about "websites in Fedora" but rather about a proper noun called "Fedora Websites."<br />
<br />
Redirects from "Fedora *" do not sufficiently solve the problem. The article's title will still be without "Fedora" and so will still evoke confusion. Tooltips shown by mousing over a link will also show the vague title. After all, redirects should redirect to a more specific or appropriate name, not a less appropriate one.<br />
<br />
Ordinarily, I wouldn't think the repetition of "Fedora" is necessary. http://fedoraproject.org/docs reads much better than http://fedoraproject.org/fedora_docs. This is because I read it as "the docs page in the Fedora Project" and I am not confused. More importantly, I don't have any learned expectations about its content.<br />
<br />
Wiki pages do have learned expectations. When given a URL to a wiki page, I learned that the content will be an article, and the last part of the URL is the article title. This is why URLs like<br />
http://en.wikipedia.org/wiki/Wiki do not strike me as redundant or confusing. On the other hand, I ''would'' be confused if http://en.wikipedia.org/wiki/Overview contained an overview of the Wikipedia.<br />
<br />
Our wiki sadly violates these expectations. We name some articles using a "naive" convention, so the page's subject is ambiguous. This is a prime example of cognitive dissonance.</div>Dafrito