On Wednesday 23 June 2010 17:13:59 Lubos Lunak wrote:

On Wednesday 23 of June 2010, Will Stephenson wrote:

...

BEGINS ==Repositories== Repositories are collections of Linux software. They can be used to extend your openSUSE installation with software that is not included in an openSUSE release for size or policy reasons, or to update it with newer software versions that were not available at the time of release. [Note: there are offline repositories as well (ie: DVD). ]

Repositories may contain software of any trust level and may replace important system packages as well as adding new software. In addition, by combining many different repositories and installing their software, conflicts between software versions may arise which cause some packages to be uninstalled.

Before registering arbitrary repositories to your openSUSE installation, you should consider these risks. The repositories suggested by the Community Repositories list in YaST's Installation Sources module are intended to be safe and free of conflicts. However, when installing or updating software you should always look at the proposed changes to make sure nothing is being added or removed that could compromise the integrity of your installation. If in doubt, do not continue.

==Debug packages== To help improve openSUSE, you can report bugs when a program crashes. The Dr Konqi application

People who need this page have no idea what the Dr Konqi application is. I suggest changing to 'The crash handler' or similar.

...

can install additional debug packages to improve the quality of this crash information. For openSUSE releases, these packages are contained in a separate repository due to their size. This repository is safe to add. [Note: this is not clear since you don't mention that safe repositiory]

I think this should give specific steps how to add the repository (add new repo->add->community repos->debug repo).

...

==Multimedia Software== Support for proprietary formats and codecs is not shipped out-of-the box in openSUSE. Please see the [http://software.opensuse.org/codecsCodecspage]

The URL is incorrect.

...

for more information on enabling proprietary formats. ENDS

Hmm. The ugly beast again :(. If I'm Joe No-Stupid-Patents-Country User who's started Amarok, got the MP3 dialog and is now viewing the page, I probably kind of have an idea what this is about, but I'm pretty unsure what to do, even though that's just enabling the Packman repo in the launched 'yast2 repositories'. The referenced http://software.opensuse.org/Codecs page doesn't say much on its own. The Fluendo workshop link won't help me at all, since, besides all the other hurdles, we default to Xine and not to GStreamer. The community information link is better, since there is a realistic chance I'll make it somehow, but it's not much better - I need to select the one out of two 'Restricted Formats' links at the bottom page that is correct and gets me to the pages I need.

Will, will you be able to grab Juergen and come up with something that actually has a reasonable chance the user gets to a usable result here?

Updated version incorporating your comments BEGINS ==Repositories== Repositories are collections of Linux software. They can be used to extend your openSUSE installation with software that is not included in an openSUSE release for size or policy reasons, or to update it with newer software versions that were not available at the time of release. [Note: there are offline repositories as well (ie: DVD). ] Repositories may contain software of any trust level and may replace important system packages as well as adding new software. In addition, by combining many different repositories and installing their software, conflicts between software versions may arise which cause some packages to be uninstalled. Before registering arbitrary repositories to your openSUSE installation, you should consider these risks. The repositories suggested by the Community Repositories list in YaST's Installation Sources module are intended to be safe and free of conflicts. However, when installing or updating software you should always look at the proposed changes to make sure nothing is being added or removed that could compromise the integrity of your installation. If in doubt, do not continue. ==Debug packages== To help improve openSUSE, you can report bugs when a program crashes. The crash handler can install additional debug packages to improve the quality of this crash information. For openSUSE releases, these packages are contained in a separate repository due to their size. This repository can be added by opening Software Repositories in YaST, Add a repository, select Community Repositories, check Main Repository (DEBUG), then select Ok. ==Multimedia Software== Support for some formats and codecs is not shipped out-of-the box in openSUSE. See the [http://opensuse-community.org/Restricted_Formats Restricted Formats] page for more information on enabling additional formats. ===Disclaimer / Warning=== The above link is to a non-openSUSE site. The linked sites are not under the control of Novell and Novell is not responsible for the contents of any linked site or any link contained in a linked site, or any changes or updates to such sites. Novell is providing these links to you only as a convenience, and the inclusion of any link does not imply endorsement by Novell of any linked site. ENDS -- Will Stephenson, KDE Developer, openSUSE Boosters Team SUSE LINUX Products GmbH - Nürnberg - AG Nürnberg - HRB 16746 - GF: Markus Rex -- To unsubscribe, e-mail: opensuse-kde+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-kde+help@opensuse.org

On Thursday 24 of June 2010, Patrick Shanahan wrote:

* Will Stephenson [06-24-10 11:47]:

...

===Disclaimer / Warning=== The above link is to a non-openSUSE site. The linked sites are not under the control of Novell and Novell is not responsible for the contents of any linked site or any link contained in a linked site, or any changes or updates to such sites. Novell is providing these links to you only as a convenience, and the inclusion of any link does not imply endorsement by Novell of any linked site. ENDS

This is good information, plain and factual, but makes it appear that openSUSE is a product of and/or under the direct control of Novell. Perhaps wording explaining that the "Dis/Warn" is due to Novell providing the hardware and web space and particular countries laws which preclude directly providing those applications. Or, if I am wrong about this, to at least give Novell credit for it's dues rather than control?

AFAIK currently Novell is legally responsible for openSUSE, so this is necessary. This will eventually change when openSUSE foundation is created. -- Lubos Lunak openSUSE Boosters team, KDE developer l.lunak@suse.cz , l.lunak@kde.org -- To unsubscribe, e-mail: opensuse-kde+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-kde+help@opensuse.org

On Monday 28 of June 2010, Lubos Lunak wrote:

On Thursday 24 of June 2010, Will Stephenson wrote:

...

Updated version incorporating your comments

Ok, we have about 2 days to finish this. The location of the actual files is https://svn.berlios.de/svnroot/repos/opensuse/trunk/infrastructure/help.o.o , first version is also attached. I have fixed the debug section to say how to enable the repo instead of adding it, and similarly I've added step-by-step instructions for community repos (there was another 11.3 review stating that ksuseinstall on its own doesn't really help that much :( ). Please review, comment, tomorrow it should go in and be synced to the server. I don't know how translations were done for 11.2 for the http://help.opensuse.org/kde4 page, does somebody know, can be still make it here for 11.3? Also somebody should update the restricted formats page linked from here to actually explain how to add the necessary xine stuff instead, would somebody take care of that (I obviously do not want to do that)? -- Lubos Lunak openSUSE Boosters team, KDE developer l.lunak@suse.cz , l.lunak@kde.org