Michal Kubecek (mkubecek@suse.cz) wrote:

Mon Dec 16 2013 11:12:14, Adam Spiers wrote:

...

Of course we still see people getting this wrong on a regular basis, but googling for "SUSE capitalization" doesn't reveal anything helpful. IMHO we need a wiki page covering the One Absolute Truth, and also a bit of the history behind it. I found this thread from 2005:

Seriously?

Yes.

Is _this_ what prevents the distribution from being the greatest and most popular?

No. I never said it was.

After my experience with 13.1, I hardly think so...

Then we agree on that point. But that's not relevant to this discussion. -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org

On Tue, 17 Dec 2013 21:19:51 +0100, Carlos E. R. wrote:

It also insist on saying that at the start of a sentence the correct spelling is "OpenSUSE".

This isn't something that needs a technical solution, IMHO, but a style guide solution. The solution would be that sentences shouldn't start with "openSUSE," but should avoid being structured that way. If they must, then the phrase to use is: "The openSUSE distribution" or some variation that avoids putting "openSUSE" at the start of the sentence. But we don't have a formal writing style guide (or indeed an informal one). We also have the problem of it being spelled "OpenSUSE" on wikis in general, because page titles are often automatically capitalized. I guess the place to start this discussion isn't with "let's fix the problem of openSUSE capitalization," but rather "do we have a multi- lingual writing style guide that can address these types of issues?" As a professional writer, I find that when there's a style guide that spells out things like this, that leads to fewer questions. A good one to look at as a reference, honestly, is the Microsoft Manual of Style, 4th Edition. Novell and SUSE have a style guide for open source documentation authoring that might be a better place to start: http://www.novell.com/documentation/osauthoring/ This isn't as comprehensive as some (like the Microsoft guide, which gets into specific word usage, interface elements, and so on), but it's a starting point. A more comprehensive guide used by Novell, SUSE, and NetIQ is available online at: http://www.novell.com/documentation/beta/docguides/styleguide/data/ bktitle.html While it's labeled as beta, it's not, it's actively used by the internal writing teams. Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org

On Wed, 18 Dec 2013 14:27:15 +0100, Thomas Schraitle wrote:

...

But we don't have a formal writing style guide (or indeed an informal one).

For documentation, we have one: http://svn.opensuse.org/svn/opensuse-doc/trunk/documents/styleguide/en

That's good to know - I wasn't aware this was available. :) Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org

686f6c6d (686f6c6d@googlemail.com) wrote:

On Mon, Dec 16, 2013 at 12:12 PM, Adam Spiers wrote:

...

[…] Shouldn't there be a page

https://en.opensuse.org/Capitalization

or something?

JFYI: In the spirit of continuous, small improvements, I've created that page now, which only redirects to the existing http://en.opensuse.org/Help:Style#openSUSE_spelling (;

Excellent, thanks! I only just saw this ... I've added a small bit of history to that section, and cited some references. -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org