Can you find the Documentation You Need

As the title can you find the documentation you need via the Opensuse pages.

I’ve always had a hard time finding the documentation I needed on the openSUSE WIKI. I usually take Gentoo-Wiki.com articles and reformulate them in my head for openSUSE.

I’m a big fan of cleaning up the wiki documentation. There is a lot of work (being done by diverse groups) going on in this area, and it may take some time to get it all consolidated. A lot of effort has been made, and there is even more effort needed to be done.

Like a lot of things in Linux, we are dealing with progress through anarchy. That complicates the documentation side of the house.

I think, for me, it is not necessarily a matter of finding it… it is a matter of searching for it. Sometimes I am too quick to ask instead of doing the research.

Mentally, research seems hard; although, it usually yields the answer quicker than waiting for someone to answer my question…

g

Since I can use the search button and I apparently have the magic of Google within’ me, I have no issues finding needed information.

Googles for a girl like daph, errr Chrysantine :wink:

Well, as an example I just recently found out that there is a nice page at openSUSE for Documentation and also Howto’s.
It was a nice surprise but I was thinking it would be good to have these items more in sight… especially for new visitors.

Others have also vented this in the forum and second oldcpu to clean up things but also get it a more ’ eye catching’ form.

Just my 2c,
Wj

Google is indeed very powerful when you have a specific thing you are looking for.

What nice about a well layed out site/wiki/etc is that you can browse through it finding nice things you are not specifically looking for but always wanted to know :wink:

Cheers,
Wj

Not directly about documentation, but this thread also reflects that the menu and site layout could do with some tweaking :slight_smile: www.opensuse.org - openSUSE Forums

andrewd18 wrote:

>
> FeatherMonkey;1819531 Wrote:
>> As the title can you find the documentation you need via the Opensuse
>> pages.
> I’ve always had a hard time finding the documentation I needed on the
> openSUSE WIKI. I usually take Gentoo-Wiki.com articles and reformulate
> them in my head for openSUSE.
>
>

I agree. I tend to wind up using the Ubuntu how-to information.

One problem I often find with Linux documentation is that it can be
unnecessarily long-winded; what should be a simple set of instructions
winds up challenging War and Peace for length. Even then, there’s always
seems to be one vital piece of information that is skipped over.

Would it be practical to have a simple step-by-step guide to setting up a
function, a server say, that would suit a majority of systems? Obviously,
all the other various options would have to be documented for the more
experienced user. When I assemble a flat-pack bookcase I only want to know
that pin A goes into socket B, not which rain-forest to get my timber from,
how to log it, season it, etc.


Graham P Davis, Bracknell, Berks., UK. E-mail: newsman, not newsboy.
“What use is happiness? It can’t buy you money.” [Chic Murray, 1919-85]

err… did somebody just edit the WIKI page? As soon as I try to enter in it loops me back to the ’ welcome ’ page…

I tended to search suseforums, and use that instead of using the wiki. For the more common things, the wiki page was always mentioned in the relevant thread.

Now, I will probably use google until this site has built up its content some more.

Ditto that, I often use the gentoo wiki as well, I’d love to see us get to that level, will just take some time.

One thing I would point out on a separate note to the members, is that by virtue of having access to post in this forum, everyone has access to add, modify or create content for the wikis. Not a solution for everything, just pointing it out as a reminder… :wink:

Cheers,
KV

Whilst I agree anyone can edit/add very few can delete or move.

To me at the moment it is a bit like a bargain basement bin. There’s some really nice nuggets of info in there but finding them involves a fair bit of rummaging.

At the moment the ones who say yes seem to be defaulting to using google as a search engine. Which sort of defeats the point.

Chrysantine wrote:
> Since I can use the search button and I apparently have the magic of
> Google within’ me, I have no issues finding needed information.

have you no issue with finding SuSE specific information??

like, can you google (or, before my question, search these fora) and
find the (or a way) way to disable ping in SuSE 10.3 ???

kindly,

DenverD
ps: i never did learn why that ability was removed from YaST…

Well yes because I would do it on iptables level so it would be quite easy to find a solution: disable ping iptables - Google Search

yep, i agree: forming useful google search strings depends on the user
having a good idea (and in this case knowing what iptables is, and how
they could be used)…

but, since (i’ve never met an iptable) and had said “disable ping in
SuSE 10.3” and “SuSE specific information” all of my search strings
included these items:

disable ping suse yast

which made for unsatisfactory results both via google AND every search
box i could find at Novell and openSuSE.org…which is kinda sad really!!

DenverD

:slight_smile:
Really good definition of the problem.

Wiki structure is just flat plate with a lot of articles on it. The only meta information that can make wiki structured are articles about content. From my favorite Portal, to indexes, redirects, disambiguation pages, lists, guides how to create content etc.

Second problem is local (not google) wiki search that needs some help to yield useful results. For instance, if you are looking for advice with NTFS read write access, you will probably type in search box ‘ntfs’ and that brings up article ‘NTFS’, which is good, but many basic search words will give a long list of articles that are sometimes barely relevant.

FeatherMouse calls idea to create Portal bandaid. To some extent it is right, Portal is one type of meta article from many types that Wikipedia is using. The Mediawiki software that is base for Wikipedia and openSUSE wiki, is similar to hard disk without file system. You can use hard disk as is, but it is hard to find files when you need them again.

I guess that together we can make openSUSE wiki “file system”.
Anybody with expertise that wants to lead ?

PS.
I guess that this discussion should continue in some other forum, on opensuse-wiki mail list, or possibly around some properly named wiki article.

Rajko.

This is a handy page for OpenSUSE documentation - Documentation - openSUSE

Magic31 wrote:

>
> err… did somebody just edit the WIKI page? As soon as I try to enter
> in it loops me back to the ’ welcome ’ page…

Did you log in openSUSE wiki?
You need Novell account that you can create using link Register.


Regards, Rajko
http://en.opensuse.org/Portal needs helpful hands.