Le 11/04/2014 14:26, Lars Kruczynski a écrit :
Hi,
I have noticed that the documentation for openSuse is terribly organized and in many cases outdated. For a newcomer who visits opensuse.org, the first thing they have to click on to get help is "Discover It", which is not very relevant to directing someone new to the wiki. There should be simple designations, such as "Help", "Wiki", "Support" on the main page, or something as such. Once you click on "Discover it", you're directed to a page with a hodgepodge discombobulated kerfuffle of information a new person to openSUSE is most likely not going to find useful. When you click on "Discover It" and are taken to "Main_Page", the title "Main Page" should be titled something relevant. On the main page, the topics "Project" and "Distribution" don't have to be in separate sections, and why is "Wiki" at the bottom? That makes zero sense.
I can't even begin to touch on the problems with the complete mess the entire wiki is, but let's do an example. I'm a new user, and I click on "Discover It". How does it make any sense that when clicking on "Discover It" and being taken to the Main_Page wiki, that when clicking on the "wiki" link on the left sidebar, you're then taken to "Wiki > Portal:Wiki"? So, now we're in "Portal:Wiki". We're displaed with a big long mess of explaining structure. How is this relvant to helping a new user, or even an experienced one? It isn't. In the right pain, we're shown "help pages" and "Navigation". So, if the new user got this far which they probably haven't, let's say they click on "13.1" in the right sidebar, because that's the version they have installed or are having trouble installing. We learn that openSUSE is "stabilized", "networked", "evolved", "polished", and the list goes on. That's all find and dandy, but now the user has to scroll all the way down to the bottom of the page to actually find something which may be relevant to the problem they are having. Let's say the use is having a problem with PulseAudio. Nothing relevant to PulseAudio can be found, and still to this day, I can't find where the documentation to PulseAudio is without searching for it on Google. Getting support for openSUSE shouldn't be this painstakingly difficult, and there needs to be be a discussion had about how awful it is right now. If the documentation is bad, people aren't going to want to use the distribution. I am doing some edits to pages in order to improve the ones written in broken English, but I am one little guy and I am unable to do it all myself. There needs to be a concerted effort to get the documentation better than any other distribution, and the stuff needs to be easy to find, easy to navigate, and easy to read. I don't have access to the Main Page, but this is the first thing that needs improvement, and the "Discover It" needs to go.
Thank you,
Lars Kruczynski
I totaly agree : the OpenSUSE doc is very bad. I can help, if I am not alone. I love documentation work, at work and at home :) -- : ` _..-=-=-=-.._.--. Dsant, from Lyon, France `-._ ___,..-'" -~~` __') forum@votreservice.com jgs `'"---'"`>>"'~~"~"~~>>'` =====================```========```======== -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org