December 2009 - openSUSE Wiki - openSUSE Mailing Lists

[opensuse-wiki] Volunteers for Article Transition
by Rupert Horstkötter 21 Dec '09

21 Dec '09

Team, JFYI, this "call for contributors"[1] has been posted some days ago to forums.o.o - I link to it here as it certainly also applies to list subscribers. So far, the following forum contributors ... caf4926 hcvv buckesfeld oldcpu Hard_Sphere Confuseling ... stepped up. I list contributors here to document the volunteers we have. These people should then be invited to our mentoring session, to be scheduled, (Remy, you may do the session please) to explain [2] to them in order to get started fully aware of the actual standards we defined. [1] http://forums.opensuse.org/tech-news/428612-wiki-transition-call-contributo… [2] http://en.opensuse.org/Transition_Guidelines#Articles_Transition Best, R -- Rupert Horstkötter, open-slx gmbh openSUSE Board Member openSUSE Community Assistant http://en.opensuse.org/User:Rhorstkoetter Email: rhorstkoetter(a)opensuse.org Jabber: ruperthorstkoetter(a)googlemail.com -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

3 2

[opensuse-wiki] Forum squad introductions.
by Mike Gentry 20 Dec '09

20 Dec '09

Jonathan_R requested that we introduce ourselves. I'm Mike (sometimes AKA confuseling), a one year or so Linux user, but a moderately technical computer user for many years. I don't have anything I'd call a 'specialism' yet, but my Linux uses include general netbook (eeepc) use and tinkering, word processing / spreadsheets / dtp / diagrams (mostly all related to my degree), a MoinMoin personal wiki I've set up for keeping notes on the same (so wiki syntax is at least vaguely familiar...), and quite a lot of mucking around with grub, trying various different distros. I'm also just starting to get back into coding, having learned a bit of C/C++ years ago, and now trying to learn Ruby on Netbeans (assuming it survives Oracle :( ). I'm also dabbling in LaTeX, but not sure how long that'll last... I'm a native English speaker, and am generally reckoned good with language - so I suppose I anticipate that, rather than anything technical, being my main use. Hello! [I apologise if there's already a thread for this, this would be my first mailing list, and my first attempts to get Thunderbird and googlemail to play together - so I could well be quite far out of the loop...] -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

7 14

[opensuse-wiki] Style Guide: handling devices
by Mike Gentry 20 Dec '09

20 Dec '09

Re: previous thread; I see that it is suggested that the style guide is discussed here. http://en.opensuse.org/OpenSUSE_Wiki_Guidelines Is there a policy on device identifiers, such as '/dev/sda', and how they should be represented in the wiki? If there isn't, with reference to this thread; http://forums.opensuse.org/looking-something-other-than-support/426354-urge… Using 'sd's as an example, it seems to me that it might be sensible to have a policy of always rendering the first device mentioned as 'sdx', the second 'sdy', and the third 'sdz', unless N>3 devices are named, in which case picking the last N letters of the alphabet. This has the advantage of being consistent, of echoing common usage (we think of 'x' as being something we substitute - you could even emphasise that by making it italic) and therefore obvious to new users, and of being extremely unlikely to correspond to actual devices - particularly important as people will copy / paste commands like 'dd' or 'rm' into terminals, and possibly bring a carriage return with them, as discussed in the thread. Removing explicit carriage returns is also mentioned in the thread - I guess that can only help. -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

3 3

[opensuse-wiki] wiki.o.o is ready
by Frank Sundermeyer 19 Dec '09

19 Dec '09

Hi, we finally made it - wiki.opensuse.org is ready for the transition. Many thanks to my colleague Matt Ehle who took care of setting up the wiki, installed all extensions and took care of everything else admin related. I have put a brief text on the starting page, explaining the purpose of the wiki and providing some useful links. Feel free to add more to that page. PLEASE NOTE: * Once the wiki will go into the public, we will switch the starting page to http://wiki.opensuse.org/OpenSuSE_Wiki_Welcome (this can be done via configuration). So the main portal page will go to openSuSE Wiki Welcome rather than to the current home page "Main Page) * add Bug reports, Enhancement and Change requests to http://wiki.opensuse.org/Bug_Reports_/_Enhancement_and_Change_Requests this will make it much easier for me to track them! Happy transitioning ;-). -- 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: Markus Rex, HRB 16746 (AG Nuernberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

5 5

[opensuse-wiki] Minutes and AIs - Wiki Team Meeting, December Sunday, 6th
by Rupert Horstkötter 18 Dec '09

18 Dec '09

Team, here are the Meeting Minutes and the AI assignments of our Wiki Team Meeting on the 6th of December 2009 at 19:00 UTC. I'd like to encourage everyone interested in contributing to the actual transition to contact the respective assignees for AIs listed below. We need every helping hands to ensure a smooth transition into the new wiki instance and thus your help is certainly much appreciated by the wiki team. That said I encourage everyone to read the transcript at http://en.opensuse.org/Wiki_Team/Meetings/2009_12_06-transcript - it's not feasible to cover every fine detail of the discussion we had. 1. New instance and extensions - Assignee: Frank, Matt We'll have our new wiki instance with the requested extensions at DNS wiki.o.o (most likely along with an additional playground instance) available soon - approx. ETA is end of this week. Requesting of additional MediaWiki extensions should be done until then (at the latest), please contact Frank. Once the new instance is available we'll start with the actual transition .. our focus is the english wiki at first glance .. de, fr, es should be processed once the english one is done .. we'll reach out to sysadmins of other language-specific wikis to discuss what to do with those (start from scratch or migrate existing content according to the transition plan of the english one). 2. Templates - Assignee: Rajko, Remy, Shayon - The work to re-organize the available wiki-templates is done to 98% - they are now listed in a visually appealing way and explained at http://en.opensuse.org/Daily_templates - Remy got started with the Article template http://en.opensuse.org/openSUSE:Article_Template we'll adopt to existing pages before migrating them into the new instance. The intention is to come up with a consistent design for openSUSE end-user documentation. The reader will appreciate a consistent look&feel while accessing the openSUSE wiki. Furthermore the approach to link related articles and useful background information on top of every page highers the general usablity for the end-user (for more details on this, please read the meeting transcript). Input on the Article template, ideas to improve it and general brainstorming input is appreciated. - Remy also got started with a Portal Template http://en.opensuse.org/openSUSE:Portal_Template 3. QA - FlaggedRevs & Wiki Forum - Assignee: Rajko, Rupert FlaggedRevs MediaWiki extension (details: transcript) will be our QA flagship in combination with the Wiki-Forum as a proofreading/approval platform for new articles as well as new Draft FlaggedRevs revisions of articles. Remaining issue here is how to efficiently link the forums and the FlaggedRevs approach. Rupert and Rajko are responsible to investigate the opportunities we have to "automagically" create vbulletin forums threads for new articles/new draft FlaggedRevs revisions of articles. We'd appreciate to have it working that way - If that turns out to be impossible, we need to investigate sufficient workarounds. Input from vBulletin/MediaWiki/FlaggedRevs professionals is much appreciated here. 4. New wiki structure - Assignee: Henne, Rajko Henne proposed a new structure for the wiki on the list earlier and we'll use it within the new instance (maybe with minor adjustments). Rajko raised some questions at http://en.opensuse.org/User:Rajko_m/wip and proposed the creation of additional namespaces (openSUSE wiki use besides distro documentation) .. this is a very valuable idea to diminish the current mess of content in the wiki. Only valuable end-user documentation should be delivered to the reader. 5. Transition Guidelines/plan - Assignee: Rajko, Remy We need a transition plan that documents and clearly sorts the several steps we need to achieve to ensure a smooth transition. We already discussed (more or less) the whole process during the transition meeting but we value to have a master document for the whole team. Assignees come up with this document and everyone is asked to contribute to the initial draft provided by Rajko and Remy. The Transition guide needs to cover the procedure on how to actually do the transition and how to proceed with Checked_Pages (selecting of articles to migrate/articles to throw away, adopt selected articles to our Quality standards from a usability, design, formulation and conception perspective, adopt the new Article template to ensure consistent design of existing documentation and then finally migrate and so on and so forth) - I won't write the actual transition Guidelines now :-) 6. Guidelines for editors - Assignee: Rupert, Rajko, Remy The current situation of available documentation on how to edit the wiki, how to design articles, how to properly use templates and such is both messed up and hardly accessible for new editors. This situation at best discourage people to contribute to the wiki and we urgently need to change this. As discussed and decided earlier in the process we need Guidelines for editors that are easily accessible at the new main Portal and that cover the very basics - the document should be readable in at least 5-10 minutes and the new editor should know how to get started contributing. Shayon took the time to list documantation we have in this regard (Help namespace etc.) and provided an overview at http://en.opensuse.org/User:Wwarlock/Worklog#Imp_links_over_the_Wiki The new Guidelines should both give a quick overview and provide an opportunity to dive into more deatiled information Shayon listed. Furthermore we need to scan the available documentation we have and merge, re-work, fine-tune and summarize. The creation of Guidelines is assigned as team work for the whole wiki team (e.g. Rupert provides input on QA - Wiki forum), Rajko and Remy are responsible to come up with an initial draft document everyone else contributes to. Please add things I maybe missed and ask if something isn't clear! Again, please (re-)read the transcript of our meeting at http://en.opensuse.org/Wiki_Team/Meetings/2009_12_06-transcript - we're currently in a very mission-critical phase of the Usability Concept and it's particularly important that everyone involved is fully aware of the process we implement. We have the opportunity to come up with something really awesome and valuable for the openSUSE community IF we all act upon the decided process. Let's do this and be sure to work hand in hand as much as possible. Thanks, R -- Rupert Horstkötter openSUSE Community Assistant http://en.opensuse.org/User:Rhorstkoetter Email: rhorstkoetter(a)opensuse.org Jabber: ruperthorstkoetter(a)googlemail.com -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

3 4

[opensuse-wiki] New wiki host: Final preparations
by Frank Sundermeyer 18 Dec '09

18 Dec '09

Hi Team, before officially announcing the new wiki instance (wiki.opensuse.org) there are still a few things to do or to clarify. see http://wiki.opensuse.org/Special:Version for details PLEASE: Do not start adding content to wiki.o.o, yet. Let's wait until everything is in place (hopefully some time this week). However, you are welcome to test the new wiki - please delete articles once you do not need them. I will delete every remaining article before we officially start. Preferred place for testing should be your user page (I will not delete pages in the USER namespace). 1. Sysop: ---------- I think Javier Jonathan Rajko Remy Rupert Shayon Sascha Spyhawk (I do not know the real name ;-)) should have sysop rights in the new wiki. Agreed? Have I forgotten someone? Since you have to have been logged in once, before I can make you sysop, please log in at http://wiki.opensuse.org/ ASAP. Once you have done so, drop me a note including your wiki login name. In case of problems logging in, please delete all opensuse cookies. 2. Home page: ----------------- Do you want to keep the right column or should I remove it? How should the wiki homepage be named? 3. Namespaces: -------------- ATM we have the same namespaces as on en.o.o (SDB / SDB_Discussion, FAQ, howto). Let me know if you want to keep these and which ones I should add. 4. FlaggedRevs ------------------ Configuration: Rajko, any hints/input from your side is welcome. CSS: I will try to adapt the CSS to our skin. User Rights: Who should have which permissions in FlaggedRevs? Please see http://www.mediawiki.org/wiki/Extension:FlaggedRevs#User_rights 5. Lucene Search ---------------- This is the only requested extension that is currently not installed. Adding this would require a considerable change to the server configuration. We have tested the SphinxSearch extension (Sphinx is even faster than Lucene). The only difference I noticed was an increase in speed. The search interface remains the same, and the result list is sorted a bit differently than with the standard wiki search. Apart from that, no changes. Honestly I do not see any benefits using an external search engine rather than performance (and that AFAIK has never been a problem). Whatsmore, the internal wiki search has improved, too, since MediaWiki 1.5.8 6. Use of Semantic MediaWiki ---------------------------- Has anything been decided on this topic? 7. Everything I missed ---------------------- If there is any other thing you need (configuration option, skin, css) let me know. -- 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: Markus Rex, HRB 16746 (AG Nuernberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

11 29

[opensuse-wiki] Image problem solved
by Frank Sundermeyer 18 Dec '09

18 Dec '09

Hi, JFYI: Linuxsusefan discovered a serious problem with images >100kb that had been uploaded after the wiki update not being displayed. This probem has been solved. --------------- zur Information: Linuxsusefan hatte herausgefunden, dass Bilder > 100kb, die nach dem Wiki Update hochgeladen wurden, nicht dargestellt wurden. Das Problem is jetzt gelöst. -- 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: Markus Rex, HRB 16746 (AG Nuernberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

1 0

[opensuse-wiki] AI2, AI 5 & AI6 Status report
by Remy Marquis 16 Dec '09

16 Dec '09

Hi, Here is a status report regarding wiki transition AI #2, #5 and #6. AI#2 : Templates --------------------- I've cleaned more Template, added a few useful templates. The list of "standardized" templates can be found here : http://en.opensuse.org/openSUSE:Template_Messages A proposition for the article template that should be hopefully become a standard through the wiki is here : http://en.opensuse.org/openSUSE:Article_Template The basic structure is, as following : - Navigation bar (optional) - Introduction (Intro-frame) - Knowledge bar (version, prerequisite articles, links to more general help) - Body - See also section (related articles that might interest the reader, external links) Please give comment feedback. It's still WIP, but I must admit that I've actually no idea how to improve it at this stage. Any help regarding this issue is welcomed. A proposition by Shayon for the Portal template that should become the entry point to diverse sub-project (YaST, Libzypp, BuildService, Education, ..) can be found here : http://en.opensuse.org/openSUSE:Portal_Template and http://en.opensuse.org/openSUSE:Portal_Template/Example I think that Shayon is preparing a second proposition (which is still WIP as far as I know). AI#5 : Wiki Guidelines --------------------------- I've cleaned, merged the bunch of articles that were talking about Guidelines. The new "Wiki Guidelines" can be accessed here : http://en.opensuse.org/openSUSE:Wiki_Guidelines It is divided in 5 essential parts : - Style Guide (main structure, general usubility, basic elements) - Template Guide (basic info about Template and common template description, see AI#2) - Tag Guide (maintenance, cleanup tag, deletion policy) - Categorization Guide. This is still in early stage at the moment and need to be developed. Following a discussion with Rajko_m and Shayon, it might be useful to define a pre-selected list of categorization tags (ie, [[category:KDE]]) to help to properly categorize articles when migrating, but this need some extra time to prepare. - Translation Guide (how to provide a localized wiki) Shayon also proposed a NavBox linking to all Guidelines (General Guideline, Artwork, Trademark, etc) : http://en.opensuse.org/Template:Guidelines A specific portal dedicated to openSUSE Guidelines and Policies might also be a good idea in the new wiki instance. As always, please comment. I believe that huge improvements can still be done here. AI#6 : Transition Guidelines ----------------------------------- A step-to-step transition guideline is available here : http://en.opensuse.org/Transition_Guidelines This is also in a early stage and input from all participants is required. Some comments from Shayon can also be found at the bottom, before the proposed wiki structure. Also, about the "Content Check" pages: Some page (~150) have been manually checked and tagged with "Passed QA check". However, this tag only indicate that the page content is not rubbish, but the format might need improvement to match the to-be-finalized Wiki Guidelines. I guess a second check, which include a format check, might be necessary for all pages. Please note that I won't be available to work on wiki this week. Keep the good work during my absence :) Regards, R. -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

5 13

[opensuse-wiki] Official colour chart
by Jan-Olof Eriksson 16 Dec '09

16 Dec '09

Hello Does anyone know where are official hex colour chart for wiki? J-O.E -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

2 1

[opensuse-wiki] wiki update: Status report
by Frank Sundermeyer 14 Dec '09

14 Dec '09

Hi, I'd like to give you a short status overview of where we are with the wiki upgrade. If you have other issues with the wiki you would like to see fixed, please let me know by writing an email to webmaster(a)opensuse.org. A big thank you to my colleague Matt who fixed most of the bugs. Fixed issues: 1. Caching Due to caching errors either wrong pages or pages in a wrong language have been delivered. This issue has been solved. 2. No thumbnail generation 3. File uploads not working 4. Missing Images on the Japanese wiki 5. No PDF (and other file formats) upload 6. SDB articles are missing Namespaces for SDB, howtos and FAQ were not configured 7. No subpages 8. </li> tags visible on the starting page 9. Two green lines at the end of each page 10. InputBox extension missing Initially we had problems with InputBox, but it works now Work in progress: 1. Missing sponsor images Already fixed on de and en, I will do the other language wikis later today 2. New wiki instance wiki,opensuse.org 3. Installation of new extensions Feedback wanted: 1. Recent changes link no longer working from left nav I wasn't able to get this working again, so I removed the link. Seems this page can only be accesses via Special:Spacialpages. If you are a MediaWiki template guru and know how to solve this issue, drop me a note. 2. Edit-toolbar is not available Has this been available in the past? I cannot remember having seen it. Nor have I found a way to enable/disable it (apart from the user prefrences, of course) -- 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: Markus Rex, HRB 16746 (AG Nuernberg) "Reality is always controlled by the people who are most insane" Dogbert -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-wiki+help(a)opensuse.org

2 2