Hi Roger, Am Samstag, 3. Dezember 2011, 01:34:52 schrieb Roger Luedecke:

That we are low in the polls says ...

Sorry, but I disagree. I don't think this poll has any relevance. It can be a lot of reasons why we are "low". One reason is that it is a Russian site so we can assume it is geographical focused on Russia. That means, it excludes all users who cannot read or understand Russian. That makes the hole poll very distorted. »There are three kinds of lies: lies, dirty lies and statistics.« :-)

... we need to make our documentation much more obvious and accesible.

+1 The documentation should be much more visible.

Its odd that I have to hunt through Novell site for the actual manuals. Further, though they can be installed from repos... they aren't obvious as to where they went.

Right, again, I fully agree with you. We've started in my team some initiatives to raise the visibility/awareness, but it needs some time to see the effects. Thanks for taking the time to care about documentation. :-) -- Gruß/Regards, Tom ---------------------------------------------------------------------- SUSE LINUX Products GmbH (o< Maxfeldstrasse 5 /\\ Documentation Specialist 90409 Nuernberg, Germany _\_v http://www.suse.com SUSE LINUX GmbH, GF: Jeff Hawn, Jennifer Guild, Felix Imendörffer, HRB 21284 -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

Hi,

[...]

...

Its odd that I have to hunt through Novell site for the actual manuals.

http://doc.opensuse.org gives the current manuals. Seems this is not well-known yet ;-(

Well, at least, if you go to http://software.opensuse.org/ you can see not only the Download Method, but also a link to "Documentation" in the third column. I don't know where Roger searched for the manuals so I've played with the search field. I've started with http://opensuse.org and entered "documentation". This drove me straight to http://en.opensuse.org/Documentation. Only the term "doc" was not clearly resolved. Roger, which URL did you use to search for documentation? -- Gruß/Regards, Thomas Schraitle ---------------------------------------------------------------------- SUSE LINUX Products GmbH (o< Maxfeldstrasse 5 /\\ Documentation Specialist 90409 Nuernberg, Germany _\_v http://www.suse.com http://lizards.opensuse.org/author/thomas-schraitle/ SUSE LINUX GmbH, GF: Jeff Hawn, Jennifer Guild, Felix Imendörffer, HRB 21284 (AG Nürnberg) -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

On Monday 05 December 2011 20:25:29 Roger Luedecke wrote:

For that matter, why aren't the manuals and such put in the users account under documents by default?

I like this idea. -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

On Monday, December 05, 2011 08:25:29 Roger Luedecke wrote:

...

I don't remember, it was a long time ago. Frankly, our website is not very noob friendly at all. It needs a major redesign. Just because something is there, doesn't mean its obvious or even known. For that matter, why aren't the manuals and such put in the users account under documents by default? Or maybe a quick DL link in the greeter.

Klaas is redesigning the greeter, talk with him (CC'ed).

For the web pages, it's a wiki - and changes are welcome,

Andreas Ah, ok. I had been working on trying to port kaptan from Pardus. Frankly

On Tuesday, December 06, 2011 10:36:34 AM Andreas Jaeger wrote: though, that hasn't gone so well since I simply can't seem to figure out how OBS works. I was thinking of trying my hand at making a QML Plasma based greeter. In regards to the documentation issues, and greeter see the following: https://features.opensuse.org/313048 https://features.opensuse.org/313049 https://features.opensuse.org/312894 https://features.opensuse.org/313050 https://build.opensuse.org/project/show?project=home%3AShadowolf7%3Akaptan The wiki is a disaster IMHO. I think we need more automation, to autolink things such as if an article references a technology, the wiki will automatically turn that into a link. Or make a popup for possible matches. For that matter, it may not hurt to make a scriptamajig that will pull articles off Wikipedia to flesh out areas that aren't populated. -- Roger Luedecke openSUSE Ambassador Ind. Repairs and Consulting **Looking for a C++ etc. mentor*** -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

Hi AJ, On Mon, Dec 5, 2011 at 4:55 PM, Andreas Jaeger wrote:

http://doc.opensuse.org gives the current manuals. Seems this is not well-known yet ;-(

How about on Novell Page? http://www.novell.com/documentation/ openSUSE 12.1 Docs does not have its PDFs version there yet(?) It is good if user can have the documentations in printed version than the online. Thanks. Best regards, -- Andi Sugandi. -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

Hi, On Sat, Dec 17, 2011 at 11:45 AM, Manu Gupta wrote:

On Sat, Dec 17, 2011 at 9:27 AM, Andi Sugandi wrote:

...

How about on Novell Page?

http://www.novell.com/documentation/

openSUSE 12.1 Docs does not have its PDFs version there yet(?)

It is good if user can have the documentations in printed version than the online.

Filing a bug report under infrastrcutrure is the fastest way imo.

https://bugzilla.novell.com/show_bug.cgi?id=737505 Please correct me if I filled it in wrong way. Thanks. Best regards, -- Andi Sugandi. -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

On Sat, Dec 17, 2011 at 12:04 PM, Roger Luedecke wrote:

...

Hi AJ,

On Mon, Dec 5, 2011 at 4:55 PM, Andreas Jaeger wrote:

...

http://doc.opensuse.org gives the current manuals. Seems this is not well-known yet ;-(

How about on Novell Page?

http://www.novell.com/documentation/

openSUSE 12.1 Docs does not have its PDFs version there yet(?)

It is good if user can have the documentations in printed version than the online.

Thanks.

Best regards, -- Andi Sugandi. -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org I could never find them on our own domain. I got them from Novell, assuming

On Saturday, December 17, 2011 10:57:34 AM Andi Sugandi wrote: that was where they were kept. Which I always thought was a bit backwards. We have too many sub-domains and not enough clarity in what they contain and how to reach them from the front page. We should add a nice navigation bar to the front page, with emphasis on usability for the new-user/consumer.

Top Bar->Support->Documentation The top navigation bar is a global menu

-- Roger Luedecke openSUSE Ambassador Riverside, California ***Looking for C++ Mentor*** -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

-- Regards Manu Gupta -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

On 19.12.2011 16:10, Frank Sundermeyer wrote:

I have updated doc.opensuse.org, so now the manuals can be downloaded/viewed in various formats. I have also updated

Thanks a lot! --kdl -- kind regards, -o) German Wiki Team Kim Leyendecker /\\ Documentation& marketing www.opensuse.org _\_v leyendecker@opensuse.org ===================================================== my GPG Key: 664265369547B825 | IRC: k-d-l Twitter: kim_d_ley | Wiki-Username: openLHAG openSUSE - Linux for open minds - get it free today! -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

On Tue, 20 Dec 2011 07:33:55 +0700 Andi Sugandi wrote: Hi,

On Mon, Dec 19, 2011 at 10:10 PM, Frank Sundermeyer wrote:

...

I have updated doc.opensuse.org, so now the manuals can be downloaded/viewed in various formats. I have also updated http://en.opensuse.org/SDB:Official_documentation

Thanks, this is great news.

How did actually you do to convert the docbook to PDF format (in case someone wants to translate them to other languages)?

we are using a tool called daps (DocBook Authoring and Publishing Suite, formerly known as susedoc) that the SUSE doc team maintains and develops. daps is currently available in the BuildService from the Documentation:Tools project. An official 12.1 package is on the way and we will soon (hopefully in January) publish the project on SourceForge.

And is it allowed to translate these documents to other languages?

Sure it is ;-). While German translation is done by SUSE, the community provides translations to Dutch, French, Hungarian, Japanese, Brasilian Poprtuguese and Russian. We provide SVN access, tools and technical support for translators. We have a mailinglist opensuse-doc and an IRC channel on freenode (#opensuse-doc) where you can learn more about translations and daps. You are welcome to join us. -- 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: Jeff Hawn, Jennifer Guild, Felix Imendörffer, HRB 16746 (AG Nürnberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org

On Tue, Dec 20, 2011 at 2:24 PM, Frank Sundermeyer wrote:

On Tue, 20 Dec 2011 07:33:55 +0700 Andi Sugandi wrote:

[..]

...

How did actually you do to convert the docbook to PDF format (in case someone wants to translate them to other languages)?

we are using a tool called daps (DocBook Authoring and Publishing Suite, formerly known as susedoc) that the SUSE doc team maintains and develops. daps is currently available in the BuildService from the Documentation:Tools project. An official 12.1 package is on the way and we will soon (hopefully in January) publish the project on SourceForge.

I think susedoc package is already available in official 12.1 oss repository: http://paste.opensuse.org/86757157 [OOT] But I wonder why susedoc should require Inkscape to be installed? http://paste.opensuse.org/44708850 Fill new bug for it?

...

And is it allowed to translate these documents to other languages?

Sure it is ;-). While German translation is done by SUSE, the community provides translations to Dutch, French, Hungarian, Japanese, Brasilian Poprtuguese and Russian. We provide SVN access, tools and technical support for translators.

We have a mailinglist opensuse-doc and an IRC channel on freenode (#opensuse-doc) where you can learn more about translations and daps. You are welcome to join us.

Hopefully I'll start working on it before the end of this month.. =) Best regards, -- Andi Sugandi. -- To unsubscribe, e-mail: opensuse-marketing+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-marketing+owner@opensuse.org