- openSUSE Documentation

[opensuse-doc] Concerns on New 11.4 Start-Up Manual
by P.B. Lecavalier 06 Apr '11

06 Apr '11

I just looked at the new Start-up guide for 11.4, and I would like to voice my concerns about these changes. On a personal note: I switched to Linux some two years ago from Windows to openSUSE 11.1. I read all of the then Start-Up guide, and I learned a lot with it, especially due to its rich sections on installation, setup and its primer on the bash shell. Without these, there is no way that the installation process and the administration of the system would have been clear enough for me to have the system to work. And I believe that a primer in bash shell is of an absolute necessity for anyone who is going to act as the system administrator. There is no "graphical" sudo nor su for many tasks that you might encounter. Of course, if you are writing a guide to the attention of the guy who is just a "limited user" on the system, then there is no need to go into that gore about administrative stuff. But for the newcomer to Linux who does not have an available guru to do everything for him, that new guide is rather useless. Now the core of the new guide is: KDE, Gnome and LibreOffice primers. Ok. Let me ask you a question. When Windows 95 came out, did you need a book to use this interface? I did not, and I am not in computer science. I think it is good to provide such documentation, but this is really reference stuff! The reason why I liked the previous Start-Up guide is that it would be a concise introduction to Linux and openSUSE, without very obvious stuff like "how to use a desktop interface". This is not anymore the case. Besides, why put KDE and Gnome quickstart within the same guide? Why would someone learn both?? Also, I really don't see how an introduction to openSUSE is related to LibreOffice. This is already available on Windows, then not so much relevant to the "transition guy", and, more importantly, it is definitely not operating system stuff. What one expects to find in the manual of an operating system is certainly not a primer on office software... Could be good for an 'Applications' manual. But there was one such guide! So what was wrong with this? I am well aware that setup and shell basics are there in the reference guide. But, if you think like a newcomer, you have NO IDEA at all of what it is that you should go learn first, because these subjects all sound like equally intriguing black magic. I can expect this: "All the Reference Guide? It's 650 pages, you're crazy?! Too complex for me. I give up! Gonna stay on Windows. Not a geek." So we are sorely missing a first-stop shopping guide to openSUSE for the penguin student. By the way, I notice that you kept the troubleshooting part in it. But this is heavy shell usage. How can you ask someone to do terminal stuff without ever introducing that? This is inconsistent. For the power user who is new to Linux and is interested to learn the basics of this OS, I believe that it is important to keep available a guide like that which used to be "Start-up" guide. Without a decent Getting started guide, if I were new to Linux right now, I would likely look for another distribution. Note on design: Concerning the pdf documents, I notice that the last few versions of the manuals are all in sans-serif font. I urge you to consider getting the text body in a serif font (see 11.1 manuals). Sans-serif font is inappropriate for the body text, for it is less comfortable on the eye. On the other hand, serif font is appropriate for titles. The vast majority of print documents are in a serif font, and the pdf document should fit the purpose of printing, unlike the html version. Philippe Baril Lecavalier -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 1

[opensuse-doc] "su" versus "su -" = "su -l" = "su --log" was: [opensuse-factory] Trouble starting yast2 from terminal
by pistazienfresser (see profile) 26 Mar '11

26 Mar '11

To: opensuse-doc(a)opensuse.org CC: opensuse-factory(a)opensuse.org = http://lists.opensuse.org/opensuse-factory/2011-03/msg00298.html Am 10/03/11 10:47, schrieb Vincent Untz: [...] > Use "su -", not "su". I'm actively wondering if there's any reason to > keep the "su" default behavior around. It just keeps harming us again > and again. [...] > > Vincent > Hi Vincent, hi Frank, hello all, I think this should at least be reflected in the documentation. But there is used the su program without even mentioning the login shell ( --log/ -l/ -) option: Reference > Chapter 21. Shell Basics > 21.4. Becoming Root > 21.4.1. Using su http://doc.opensuse.org/products/opensuse/openSUSE/opensuse-reference/cha.n… I rate the hole reworking and expand the printed/book like manuals was a great operation (that should be mentioned in the 'highlights' article of 11.4). But maybe it some background (like: su versus su- ; what are gnomesu, kdesu, gksu, gksudo, xdg-su -c "[command]", ....like?) and explanations could be done in the wiki (at least as an unstable/stage version before including it/parts of it to the manuals)? Compare also: on the su/su - issue http://forums.opensuse.org/english/get-technical-help-here/pre-release-beta… and following http://forums.opensuse.org/english/other-forums/community-fun/opensuse-wiki… and following On the basics and concepts of security http://lists.opensuse.org/opensuse-doc/2011-03/msg00001.html and following Regards Martin (pistazienfresser) -- - Martin Seidler - openSUSE profile: https://users.opensuse.org/show/pistazienfresser -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

1 1

[opensuse-doc] openhelp conference
by Jos Poortvliet 21 Mar '11

21 Mar '11

Hi all, Anyone thinks it's valuable to visit the openhelp conference*? Please CC me, I'm not on the list ;-) Cheers, Jos *http://openhelpconference.com/

1 0

Re: [opensuse-doc] openSUSE 11.4 manuals ready for translation / 11.4 changes
by pistazienfresser (see profile) 10 Mar '11

10 Mar '11

CC: opensuse(a)opensuse.org To: http://lists.opensuse.org/opensuse-doc/2011-03/msg00000.html * From: Frank Sundermeyer <fs@xxxxxxx> * Date: Tue, 1 Mar 2011 16:03:02 +0100 * Message-id: <20110301160302.6ef5a827(a)pythagoras.suse.de> > #### 11.4 Changes ###### > > > Start-Up: > --------- > For 11.4 we completely revamped that Start-Up guide. It now consists of > 5 chapters derived from the former quickstarts: > > * Installation > * KDE > * GNOME > * LibreOffice > * Help & Troubleshooting > > The first 3 chapters have been shipped as separate Quickstart with > former openSUSE versions (filenames are the same as before). The > LibreOffoce part is new, the Help & Troubleshooting remains in the > Start-Up. > > Reference: > ---------- > Most of the stuff that has been in previous Start-Up versions has been > moved/merged into the Reference Guide. > > Files having been added from old Start-Up: > > * xml/inst_yast2.xml > * xml/yast2_hw.xml > * xml/yast2_sound.xml > * xml/yast2_scanner.xm > * xml/newbie_bash.xml > * xml/newbie_perm_i.xml > * xml/newbie_bash_commands_i.xml > * xml/nm.xml > * xml/nm_kde.xml > * xml/nm_gnome.xml I have just given a new user (who as got his system a bit ruined) a link to: Novell: openSUSE 11.2 Start (html) > 6.1 Benutzerkonzept > 6.1.1 Unterschiedliche Benutzerrollen http://www.novell.com/de-de/documentation/opensuse112/book_opensuse_startup… witch equates to openSUSE Start-Up > Chapter 6. Basic Concepts http://doc.opensuse.org/products/opensuse/openSUSE_113/opensuse-startup/cha… form Start-Up (Date 09 Mar 2011) http://doc.opensuse.org/products/opensuse/openSUSE_113/opensuse-startup Have I only not been able to find the passages in the new Reference or the new Startup or do you think something like it is not more necessary? I would doubt that it would be really wise to drop basics like that completely. Regards Martin -- - Martin Seidler - openSUSE profile: https://users.opensuse.org/show/pistazienfresser -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 2

[opensuse-doc] openSUSE 11.4 manuals ready for translation / 11.4 changes
by Frank Sundermeyer 01 Mar '11

01 Mar '11

Hi, the English openSUSE 11.4 manuals have been finished and are now ready for translation. The XML sources are available from https://svn.berlios.de/svnroot/repos/opensuse-doc/trunk/documents/distribut… ### Tagging #### In case you would like to make a tag in SVN of your current translations (which probably is 11.3), there is a script in the susedoc package, that helps. In order to be able to build books when checking out the tag, you should tag the complete set (includig books that have npot been translated) Below is an example (replace any occurences of <UPPERCASE> with 1. cd into directory you want to tag 2. Run /usr/share/susedoc/bin/trunkcopy.sh -o <PATH TO WORKIN COPY>/opensuse-doc/trunk/documents/distribution \ -t tags/documents/openSUSE11.3 \ --svnroot "https://svn.berlios.de/svnroot/repos/opensuse-doc" \ --osuffix "<YOUR LANGUAGE E.G. de>" \ --nonovdoc \ <LIST OF ENV FILES> #### 11.4 Changes ###### Start-Up: --------- For 11.4 we completely revamped that Start-Up guide. It now consists of 5 chapters derived from the former quickstarts: * Installation * KDE * GNOME * LibreOffice * Help & Troubleshooting The first 3 chapters have been shipped as separate Quickstart with former openSUSE versions (filenames are the same as before). The LibreOffoce part is new, the Help & Troubleshooting remains in the Start-Up. Reference: ---------- Most of the stuff that has been in previous Start-Up versions has been moved/merged into the Reference Guide. Files having been added from old Start-Up: * xml/inst_yast2.xml * xml/yast2_hw.xml * xml/yast2_sound.xml * xml/yast2_scanner.xml * xml/newbie_bash.xml * xml/newbie_perm_i.xml * xml/newbie_bash_commands_i.xml * xml/nm.xml * xml/nm_kde.xml * xml/nm_gnome.xml New Guides ---------- Two new guides have been added: * System Ananlysis & Tuning Guide (problem detection, resolution and optimization) * Virtualization with KVM (kvm, libvirt, qemu-kvm) Deleted Guides -------------- * KDE User Guide * GNOME User Guide * Application Guide Very good and up-to-date documentation for these topics is available upstream: KDE: http://userbase.kde.org/ GNOME: http://library.gnome.org/ Therefore we decided to replace these three guides with manuals coverings more complex and less well documented topics (KVM and Tunung, see above). -- Regards Frank Frank Sundermeyer, Technical Writer, Documentation SUSE Linux Products GmbH, Maxfeldstr. 5, D-90409 Nuernberg Tel: +49-911-74053-0, Fax: +49-911-7417755; http://www.opensuse.org/ SUSE Linux Products GmbH, GF: Markus Rex, HRB 16746 (AG Nuernberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

1 0

[opensuse-doc] Re: WebYaST User Guide
by Juergen Weigert 27 Jan '11

27 Jan '11

On Jan 26, 11 19:24:21 +0200, Kostas Koudaras wrote: > Thanks a lot for all the information,everything seems to work. > I uploaded 15 of the 22 .po and as it goes I'll have it all ready by > the end of the other week. > Please give it a look to see if I made anything wrong in the upload or > anything else and please let me know about it. > That's it for now > Kostas You did good. Thanks for contributing! Although I have no idea if the language is really greek. And I guess, I'll have to simply trust you that you really say something about webyast there :-) cheers, JW- -- o \ Juergen Weigert paint it green! __/ _=======.=======_ <V> | jw(a)suse.de back to ascii! __/ _---|____________\/ \ | 0911 74053-508 __/ (____/ /\ (/) | _____________________________/ _/ \_ vim:set sw=2 wm=8 SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nuernberg) SuSE. Supporting Linux since 1992. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

1 0

[opensuse-doc] Re: [opensuse-project] WebYaST User Guide
by Juergen Weigert 21 Jan '11

21 Jan '11

On Jan 21, 11 01:08:39 +0200, Kostas Koudaras wrote: > > > I made an account at Berlios and Kostas Boukouvalas(Greek localization > team-leader) sent me the webyast.tar.gz yesterday so that I can start > and today I almost finished the webyast-base-ui.el.po I added Kostas Boukouvalas to the opensuse-doc team, his login name was easy to find. I could not find yours. Please tell me. > I am expecting some definitions on how to make a proper translation > from him and it'll be ready soon, also I started and some other .po > files. > Now if you can tell me anything you think it can help me you are more > than welcome... sure. > You could create the opensuse-doc/trunk/documents/webyast/gr and tell > me how I can upload the files I finish. I've created that. You best start by checking out the empty directory, using svn checkout svn+ssh://YOURNAME@svn.berlios.de/svnroot/repos/opensuse-doc/trunk/documents/webyast Replace YOURNAME with your login name. I probably need to add you to the team before you can do the checkout. The next commands are: cd webyast/gr tar xvf .../webyast.tar.gz svn add * svn ci -m 'initial checkin ...' If you are unfamiliar with svn, let us know. You can also try to catch the team on #opensuse-doc(a)irc.freenode.net cheers, JW- -- o \ Juergen Weigert paint it green! __/ _=======.=======_ <V> | jw(a)suse.de back to ascii! __/ _---|____________\/ \ | 0911 74053-508 __/ (____/ /\ (/) | _____________________________/ _/ \_ vim:set sw=2 wm=8 SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nuernberg) SuSE. Supporting Linux since 1992. -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

1 0

[opensuse-doc] Acess on Berlios SVN
by Luiz Fernando Ranghetti 28 Dec '10

28 Dec '10

Hi guys, Could someone grant me acess on berlios SVN, specially in the to be created pt_BR folder? Regards, Luiz -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

3 8

[opensuse-doc] JFYI: openSUSE 11.4 project has been started
by Frank Sundermeyer 27 Dec '10

27 Dec '10

Hi, today I have started the openSUSE 11.4 documentation project by setting properties and adjusting the set at https://svn.berlios.de/svnroot/repos/opensuse-doc/trunk/documents/distribut… The last "11.3 revision" in SVN is 2277--it will be released as an online update for 11.3 soon. This revision is also copied to the tags directory in SVN, see https://svn.berlios.de/svnroot/repos/opensuse-doc/tags/documents/openSUSE_1… If you are still translating 11.3 manuals, please either use this tag or trunk revision 2277 for checking out the English sources. -- Regards Frank Frank Sundermeyer, Technical Writer, Documentation SUSE Linux Products GmbH, Maxfeldstr. 5, D-90409 Nuernberg Tel: +49-911-74053-0, Fax: +49-911-7417755; http://www.opensuse.org/ SUSE Linux Products GmbH, GF: Markus Rex, HRB 16746 (AG Nuernberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

1 0

[opensuse-doc] Just a little question
by Luiz Fernando Ranghetti 27 Dec '10

27 Dec '10

Hi guys! Just a little question: Now that we move to berlios and I see some translations being made (ja, ru, hu) how the corrections are propagated to the translated xmls? For example: yast-repair was dropped from openSUSE and the en xmls where corrected today: http://svn.berlios.de/wsvn/opensuse-doc/trunk/?op=revision&rev=2272&peg=2272 How this change (or any other) will be propagated to its counterparts on ja, hu, etc? Will be some automatic way or translate teams should make a diff from time to time and include the changes by hand? Regards, Luiz -- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 2