Home Home > Documentation
Sign up | Login

Archive for the ‘Documentation’ Category

« Older Entries

Cooking with DocBook

December 7th, 2011 by

Hi DocBook lovers,

browsed through a book, used your favorite search engine, or posted on LinkedIn, Xing, or the DocBook mailinglist to hunt for answers to your problems?

As an additional alternative, I’m happy to announce my latest project:

The DoCookBook Project
(released  under Creative Commons License)

The tongue-twisting name is a word play and picks up the two central topic about DocBook and cookbook.

(more…)

Posted in Documentation, Miscellaneous | 1 Comment »

osc11 slides and screen cast workshop kvm/libvirtd

September 19th, 2011 by

Just a quick note, my slides and screen cast about my recent openSUSE conference workshop about KVM/libvirtd are online at http://goo.gl/fQfql
Check at material subject

Tags: , , , , ,
Posted in Documentation, Events | Comments Off

fsck.ocfs2: I/O error on channel while performing pass 1

September 5th, 2011 by

When running fsck.ocfs2 if you get an error like below, turn off feature metaecc and run it again.

fsck -f -y /dev/drbd0
fsck from util-linux-ng 2.17.2
fsck.ocfs2 1.4.3
Checking OCFS2 filesystem in /dev/drbd0:
Label: vmimages
UUID: B5A45669962C4E40AE9FB2BF16184981
Number of blocks: 157281328
Block size: 4096
Number of clusters: 19660166
Cluster size: 32768
Number of slots: 4

/dev/drbd0 was run with -f, check forced.
Pass 0a: Checking cluster allocation chains
Pass 0b: Checking inode allocation chains
Pass 0c: Checking extent block allocation chains
Pass 1: Checking inodes and blocks.
extent.c: I/O error on channel reading extent block at 112162 in owner 516113 for verification
pass1: I/O error on channel while iterating over the blocks for inode 516113
fsck.ocfs2: I/O error on channel while performing pass 1

#disable metaecc (man tunefs.ocfs2 for more)
tunefs.ocfs2 --fs-features=nometaecc /dev/drbd0

#run fsck again
fsck -f -y /dev/drbd0

to re-enable it after completing fsck, run:
tunefs.ocfs2 --fs-features=metaecc /dev/drbd0

Posted in Documentation, Miscellaneous, Systems Management | Comments Off

Calibre Repository Moved

April 15th, 2011 by

Maybe not everybody knows it or it may be a bit too late, but nevertheless… the Calibre repository on home:thomas-schraitle:calibre has been moved to Documentation:Tools. It was necessary due to some internal reorganisation. The new location is now the official devel project.

Have fun! :-)

Tags: , ,
Posted in Build Service, Documentation, Packaging | Comments Off

openSUSE 11.4 & cheat sheet poster + dvd in Linux Magazine

April 9th, 2011 by

If you don’t get it already our 11.4 DVD and a great double faced poster are here
Linux-Maganize issue 126
(more…)

Tags: , , ,
Posted in Artwork, Boosters, Contrib, Distribution, Documentation, Education, Marketing | 6 Comments »

Status Hungarian openSUSE Documentation

November 17th, 2010 by

As I wrote last time, I’ve migrated our documentation to a public SVN server on BerliOS. There you can get the English sources of the official openSUSE documentation and some business products too.

Apart from Russian, I’m very happy that the Hungarian translation of the openSUSE documentation is underway! Thanks to Kálmán Kéménczy, he will publish the Hungarian documentation soon. Currently, some translatation, proofreading, and polishing have to be done, so stay tuned (see https://svn.berlios.de/svnroot/repos/opensuse-doc/trunk/documents/distribution/hu.)
By the way, the Hungarian books from the 11.1 and 11.2 release can be downloaded in the Hungarian portal.

If someone from the Hungarian community wants to help, please support Kálmán and contact him for futher details.

Thanks Kálmán, for your ongoing work! I’m sure, everybody appreciates your work, be it in the past, present, or future.

Tags: ,
Posted in Documentation, Localization | Comments Off

Merging SVN Repositories Explained

October 30th, 2010 by

Adding files to a SVN server is usually a task done in seconds. However, having several independent SVN repositories and wanting to “combine” them, this is not trivial—especially if you want to preserve the history.

The doc team had had three different, independent repositories on BerliOS (opensuse-ha-doc, opensuse-docmaker, and opensuse-lfl) all holding separate information. This was a bit silly, so my task was to consolidate them into opensuse-doc by keeping all history.

(more…)

Tags: , , ,
Posted in Documentation, Server, Systems Management | Comments Off

Read The Fabulous Manual

October 26th, 2010 by

We have a new place where we collect static documentation like manuals, user guides, quick start pages, developer documentation … and so on.
This new place is: rtfm.opensuse.org doc.opensuse.org.
Our “fabulous manuals” are also accessible at: doc.opensuse.org (in case you don’t like the word “fabulous”).

A few days ago Thomas Schraitle already wrote about this site before it was in a state that we wanted to announce – so sorry for any confusion this might have created.

This site is not meant to be a competitor to the documentation in the wiki. It was rather born from the need to have a central place to publish generated static documentation. Content on rtfm is not meant to be edited. If you want to contribute documentation we very welcome this in the wiki and encourage  you to link back to rtfm where applicable. The pages on rtfm are static but however they will be updated automatically upon changes (new releases of a project or product).

Currently we have published some great user guides and quick start pages for openSUSE (KDE, Gnome, Security, …) and SLES (AppArmor, Admin Guide, kvm, Xen, Security, …) as well as a user and vendor guide for WebYaST. There is also developer documentation available for YaST and Zypp (libzypp, satsolver) development.
In the next days or weeks we will add more documentation as soon as it is ready to be published.

Update:
We changed the domain name of that site. To read the fabulous manuals please use and link only to doc.opensuse.org. The domain docs.opensuse.org will be alias for it – please only link to doc and do not use rtfm anymore. Thanks for your appreciation.

Posted in Distribution, Documentation | 3 Comments »

RTFM!

October 23rd, 2010 by

Before and during the openSUSE conference, some nice people (Jens-Daniel, Jürgen, Darix) created the following site for you:

http://rtfm.opensuse.org http://doc.opensuse.org

Thank you guys! I like the thrilling name. ;-)

It’s a static page (at the moment?) and collects the current documentation from several products and projects. Probably you will see more to come in the next weeks.

Have fun!

Update (AJ since Thomas is ill) 2010-10-27: Based on the feedback received, we’re going to  change now rtfm.opensuse.org to docs.opensuse.org. So, you can reach the fine side under http://docs.opensuse.org and http://doc.opensuse.org.

Tags: ,
Posted in Documentation, Marketing, Usability | 11 Comments »

Documentation

October 13th, 2010 by

Hi folks,

this post is just request for all obs-packagers. Please, don’t forget write some documentation about your projects (which you maintain or develop). I mean, documentation for developers. This make more easy to understand logic of program, connection between some modules inside or interfaces between widget/applet and “system/hardware part”. For sure, comments in source code (or in changelog) help, but some times they give not so much clarity.

This is not so complicated to write one-two pages about project, which you hack. This also can save time of new developers. They will not ask you about architecture of project, and that will save your time too ;)

I don’t know how will be better to do it: use wiki (create a new page) or add just text-file in source project. Anyway it’s not so important where will be this documentation, main things that this documentation will be exist :)

Tags: ,
Posted in Build Service, Contrib, Documentation, Packaging, Usability | 1 Comment »

« Older Entries