[opensuse] Portals for 11.1, 11.2, 11.3
This mail was posted by now in opensuse-wiki. opensuse-marketing ML and forums. Forums: http://forums.opensuse.org/english/community/opensuse-wiki-discussions/ Portals for 11.1, 11.2, 11.3 need content or fixes. http://wiki.opensuse.org/Portal:Distribution Seems to be fine. http://wiki.opensuse.org/Portal:11.1 We need all from scratch. http://wiki.opensuse.org/Portal:11.2 Partially done. It needs more content and maybe some cleanup. http://wiki.opensuse.org/Portal:11.3 We need all from scratch. Help docs for editing Portal pages will be added to the rest of the help pages as time permits. For now, if basic instructions below don't answer your questions, just ask. Basic is that content is added or edited in subpages using Edit link on the top right side of frame title line. Example: http://wiki.opensuse.org/Portal:11.2 Frame title: Related portals link edit Click edit and it will open http://wiki.opensuse.org/index.php?title=Portal:11.2/Related_portals&action=edit Do changes. Check how it looks like with "Show preview" button under the edit field. When satisfied, click "Save page" button. Saved page is now: http://wiki.opensuse.org/Portal:11.2/Related_portals You can see that is not the actual portal page. Click on link Portal:11.2 and you will be back to the: http://wiki.opensuse.org/Portal:11.2 Check layout of portal pages. New content should not go out of the frame, or garble the Portal page in any way. When all is done, please report here, so that someone from wiki team can review changes and approve them for publishing. We use http://www.mediawiki.org/wiki/Extension:FlaggedRevs that allows edits, but by default it shows only approved version (flagged as good) to the casual wiki visitors, so to make changes visible for everybody as soon as possible they need approval. -- Regards Rajko, -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Mon, 2010-07-05 at 14:25 -0500, Rajko M. wrote:
This mail was posted by now in opensuse-wiki. opensuse-marketing ML and forums. Forums: http://forums.opensuse.org/english/community/opensuse-wiki-discussions/
Portals for 11.1, 11.2, 11.3 need content or fixes.
http://wiki.opensuse.org/Portal:Distribution Seems to be fine.
http://wiki.opensuse.org/Portal:11.1 We need all from scratch.
http://wiki.opensuse.org/Portal:11.2 Partially done. It needs more content and maybe some cleanup.
OOC, how is 11.2 different from Distribution? -- Roger Oberholtzer OPQ Systems / Ramböll RST Ramböll Sverige AB Krukmakargatan 21 P.O. Box 17009 SE-104 62 Stockholm, Sweden Office: Int +46 10-615 60 20 Mobile: Int +46 70-815 1696 -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Tuesday 06 July 2010 01:15:40 Roger Oberholtzer wrote:
OOC, how is 11.2 different from Distribution?
Distribution portal should talk about distro in general, not about particular release. We started with idea to have current release introduced in Portal:Distribution, but then where we are going to present factory and old and still supported releases. Ditto, Portal:Distibution was re-purposed as master and each release and factory got their own portals. -- Regards Rajko, -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Tue, 2010-07-06 at 22:27 -0500, Rajko M. wrote:
On Tuesday 06 July 2010 01:15:40 Roger Oberholtzer wrote:
OOC, how is 11.2 different from Distribution?
Distribution portal should talk about distro in general, not about particular release.
We started with idea to have current release introduced in Portal:Distribution, but then where we are going to present factory and old and still supported releases. Ditto, Portal:Distibution was re-purposed as master and each release and factory got their own portals.
I think there should be a Portal page (sans the :xxx) that explains how all the Portal:xxx pages play together. After all, anyone who is at the Portal:xxx stage of finding things is probably new, and an explanation of how the Portal:xxx pages work together must be useful. Also, as you move to the different Portal:xxx pages, the menu of other Portal pages on the sides change in a not-so-very-useful (to me anyway) way. I did not note any logic to it. Other Portal:xxx pages came and went. So you could get to other Portal pages sometimes from the links on the right, and sometimes only by navigating back to some other page that had the Portal link you want. -- Roger Oberholtzer OPQ Systems / Ramböll RST Ramböll Sverige AB Krukmakargatan 21 P.O. Box 17009 SE-104 62 Stockholm, Sweden Office: Int +46 10-615 60 20 Mobile: Int +46 70-815 1696 -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Wednesday 07 July 2010 01:52:17 Roger Oberholtzer wrote:
I think there should be a Portal page (sans the :xxx) that explains how all the Portal:xxx pages play together. After all, anyone who is at the Portal:xxx stage of finding things is probably new, and an explanation of how the Portal:xxx pages work together must be useful.
That would be Help:Portal, but in general navigation between portals should be self documenting (intuitive). IMO, if it has to be explained then it is failed design.
Also, as you move to the different Portal:xxx pages, the menu of other Portal pages on the sides change in a not-so-very-useful (to me anyway) way. I did not note any logic to it. Other Portal:xxx pages came and went. So you could get to other Portal pages sometimes from the links on the right, and sometimes only by navigating back to some other page that had the Portal link you want.
It should be always from the links on the right and those links should be always in the same place. I like to have that navigation right at the top and that is how I change portals when I have time. Problem is that there is related content that should go first and then all other places that visitor may want to see, and of course there is always something else that is "the most important" for the particular topic. There are also design issues that are not solved and I hope that we will do that before a lot of content is added :) (Otherwise only scripts will help us to fix problems.) BTW, any detailed input is welcome, so that we can see what to do. -- Regards Rajko, -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Wed, 2010-07-07 at 22:41 -0500, Rajko M. wrote:
On Wednesday 07 July 2010 01:52:17 Roger Oberholtzer wrote:
I think there should be a Portal page (sans the :xxx) that explains how all the Portal:xxx pages play together. After all, anyone who is at the Portal:xxx stage of finding things is probably new, and an explanation of how the Portal:xxx pages work together must be useful.
That would be Help:Portal, but in general navigation between portals should be self documenting (intuitive). IMO, if it has to be explained then it is failed design.
I guess if one searches for Portal, the Help page could be listed first, followed by everything else. As well as being at the top of the links shown to the left. Is there a reliable system for knowing which pages will have help and what the help page will be called? There is no page called simply "Portal", but there is help for it. I hope is is not a matter of having to guess and see what help arrives. I ask because our own internal development wiki lacks a proper system of naming pages. Getting the developers to follow any system would be like the proverbial herding of cats. I am on the look-out for a brilliant wiki page naming scheme that is intuitive and useful, which would increase the chance that it actually gets used! Maybe you folk have cracked the mystery. -- Roger Oberholtzer OPQ Systems / Ramböll RST Ramböll Sverige AB Krukmakargatan 21 P.O. Box 17009 SE-104 62 Stockholm, Sweden Office: Int +46 10-615 60 20 Mobile: Int +46 70-815 1696 -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Thursday 08 July 2010 04:00:08 Roger Oberholtzer wrote: ...
I guess if one searches for Portal, the Help page could be listed first, followed by everything else. As well as being at the top of the links shown to the left.
Help page for browsing is classic example of failure in web design (IMO), but there must be help for those that have to create Portals. Our is located at: http://wiki.opensuse.org/Help:Portal It is very basic what portals are intended to be and how to create them. We use MultiBoilerplate extension [1] so we don't have to use {{subst:Template:Portal}} to create one, just select from drop down list that shows up when user attempts to create new page. Our MultiBoilerplate is improved (thanks to CBoltz) and can have different selection of templates for different namespace. Btw, list of namespaces is here: http://wiki.opensuse.org/Special:Search The Concept, Property and Type are used by Semantic MediaWiki extension, so nothing manually created should go there.
Is there a reliable system for knowing which pages will have help and what the help page will be called?
MediaWiki has whole namespace dedicated to help. The syntax is like in above link Help:<topic> . If you want that to be listed in search results, make it part of default search.
There is no page called simply "Portal", but there is help for it.
Such page can be created as aid for search of important topics outside the default search. We will do that some time after switch. For instance "Portal" page can list help articles related to portals and then list of all portals. That way it can be used in right side navigational bar of any portal. Other option is like http://en.wikipedia.org/wiki/Portal . In that case the help page and list of all portals can be created in "Protal:Portal" as it is not very likely that anyone would need that name for some openSUSE related topic.
I hope is is not a matter of having to guess and see what help arrives. I ask because our own internal development wiki lacks a proper system of naming pages. Getting the developers to follow any system would be like the proverbial herding of cats. I am on the look-out for a brilliant wiki page naming scheme that is intuitive and useful, which would increase the chance that it actually gets used! Maybe you folk have cracked the mystery.
Heh :) There is no mystery. See what your users do and try to: * put in help files what they do, or sane selection of their methods. * repeat time and again to use categories to tag articles so that is possible to find groups of articles that talk about the topic; the article that is not categorized is dead meat - no one will find it * the same about linking to other topics; article without links is hard to read for outsiders as to find explanations mentioned in other articles one has to browse general listings, that are not meant as browsing help Apropos magic naming scheme: http://shirky.com/writings/ontology_overrated.html That one helped me not to try too hard to herd the cats. Important topic will have supervision and attempts to bring in a common naming, but other will have to help themselves if they want to find readers. [1] List of all extensions used in a new wiki with links to upstream web pages is on http://wiki.opensuse.org/Special:Version . -- Regards Rajko, -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
participants (2)
-
Rajko M.
-
Roger Oberholtzer