[opensuse-project] Suggestions and critiques from a little group of desktop users
Hi All, I'm hawake, i work to the Italian translation of the wiki, and I'm writing here just to share some thoughts about openSUSE assuming the point of view of a desktop user. In the following list i've collected not just my suggestions and critics but also those of all my friends that I converted to openSUSE 13.1 (after a migration from Ubuntu 13.10, which was unstable... :S ). I hope to be useful to all of you guys contributing to make openSUSE better day by day. I've distinguished 6 main categories. Communication. First of all, as pointed out in other discussions, the communication between developers and community is fundamental. I don't want to reopen this discussion here, i just want to tell you that many non-expert users perceive this lack of communication because they found ambiguous posts around the web and obviously in particular on social networks. BTW I think that the lesson has been learned and we (as a Community of supporters + Developers) are improving. ;) Installation. Installing openSUSE is not a difficult task for someone who can manage installation of a Windows OS but during the partitioning phase there are too many advanced options that are useless and scary for most part of our desktop users [0]. For example, you could hide some of these advanced options (like RAID, tmpfs, NFS, LVM and "Use Btrfs as default filesystem") under an "Advanced options" entry, or redesign that part of the installer so that the basic partition screen has a simpler layout. Software installation. Software.opensuse.org is very nice, I think it could be useful to have it accessible from the desktop because not all users know that it exists (and they use untrusted RPMs found through Google...). In fact it should be an important part of our marketing strategy. System configuration. There is a bit of confusing redundancy between some settings available through YaST and through the settings manager of a DE (for instance printer installation/configuration). We should modify the settings manager of supported DE to tell to the user when are needed root privileges, so that when it's necessary to open YaST. For instance the installation of proprietary stuff for HP printers. Help. I think that the openSUSE Activedoc Start Up guide should be accessible offline as default and in a simple way from desktop. For example, take a look at Ubuntu, you go to the shutdown menu (top-right of the screen) and you have an entry that opens a new window with the common questions about desktop usage (Unity in this case, [1] [2] ): video drivers, printers, information about the desktop environment and how to use it etc.. We still have shortcuts for KDE4, GNOME3 and so on, but they don't bring to Activedoc (which is well written) and is a little bit confusing because they bring to the SDB or HCL (not to an index of ready to use and problem-oriented guides). "Online help" links yet to the Novell documentation for openSUSE 11.0 which is translated only in german [3] and very... very outdated. So here, in the Italian wiki, we are discussing about how we should modify that SDB pages to allow the user to easily find solutions to common problems but we can't modify help.opensuse.org. So it's up to you. Interestingly the Gentoo documentation it's much more problem-solving oriented with an index very complete, see for example [4]. I know that pages like that one are very scary, but they collect a set of useful key questions right at the beginning of the page. I think that layouts like that one should be further studied (obviously not blindly applied!) to improve the usability and accessibility of our wiki. Other. Last but not least, I also report here two annoying issues: SUSE ImageWriter it is not automatically setup to use the file filter *.* (so the unexpert user is unable to see ISO images -> read all of my friends asked me how to use it); after the installation from the 4 GB ISO image, YaST does not automatically disable the DVD local repository, so the user have to handle with YaST's repository manager. In conclusion, all of my friends are enjoying openSUSE and they are using it both for work or study because of its stability, all DE equally supported, YaST, Zypper and someone (like me) really appreciate that is pure FOSS without privacy issues. Although it needs some little refinements to the user-experience as I said before but nothing impossible to do. Thank you and keep up the good work! :) Best regards, hawake [0] http://www.mediafire.com/view/jocz56r29yude8d/screenshot25modificata.png# [1] http://www.mediafire.com/view/bzrrpdgxejvxy9w/screenshot21.png# [2] http://www.mediafire.com/view/92n6youe70rmxxn/screenshot24.png# [3] http://www.novell.com/documentation/opensuse110/ [4] https://wiki.gentoo.org/wiki/AMD64/FAQ -- Linux user number 433087 Linux registered machine number 351448 http://linuxcounter.net/ -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On 27 March 2014 23:14, G G <hawake@gmail.com> wrote:
Hi All, I'm hawake, i work to the Italian translation of the wiki, and I'm writing here just to share some thoughts about openSUSE assuming the point of view of a desktop user. In the following list i've collected not just my suggestions and critics but also those of all my friends that I converted to openSUSE 13.1 (after a migration from Ubuntu 13.10, which was unstable... :S ). I hope to be useful to all of you guys contributing to make openSUSE better day by day.
I've distinguished 6 main categories.
Communication. First of all, as pointed out in other discussions, the communication between developers and community is fundamental. I don't want to reopen this discussion here, i just want to tell you that many non-expert users perceive this lack of communication because they found ambiguous posts around the web and obviously in particular on social networks. BTW I think that the lesson has been learned and we (as a Community of supporters + Developers) are improving. ;)
Installation. Installing openSUSE is not a difficult task for someone who can manage installation of a Windows OS but during the partitioning phase there are too many advanced options that are useless and scary for most part of our desktop users [0]. For example, you could hide some of these advanced options (like RAID, tmpfs, NFS, LVM and "Use Btrfs as default filesystem") under an "Advanced options" entry, or redesign that part of the installer so that the basic partition screen has a simpler layout.
Software installation. Software.opensuse.org is very nice, I think it could be useful to have it accessible from the desktop because not all users know that it exists (and they use untrusted RPMs found through Google...). In fact it should be an important part of our marketing strategy.
System configuration. There is a bit of confusing redundancy between some settings available through YaST and through the settings manager of a DE (for instance printer installation/configuration). We should modify the settings manager of supported DE to tell to the user when are needed root privileges, so that when it's necessary to open YaST. For instance the installation of proprietary stuff for HP printers.
Help. I think that the openSUSE Activedoc Start Up guide should be accessible offline as default and in a simple way from desktop. For example, take a look at Ubuntu, you go to the shutdown menu (top-right of the screen) and you have an entry that opens a new window with the common questions about desktop usage (Unity in this case, [1] [2] ): video drivers, printers, information about the desktop environment and how to use it etc.. We still have shortcuts for KDE4, GNOME3 and so on, but they don't bring to Activedoc (which is well written) and is a little bit confusing because they bring to the SDB or HCL (not to an index of ready to use and problem-oriented guides). "Online help" links yet to the Novell documentation for openSUSE 11.0 which is translated only in german [3] and very... very outdated. So here, in the Italian wiki, we are discussing about how we should modify that SDB pages to allow the user to easily find solutions to common problems but we can't modify help.opensuse.org. So it's up to you. Interestingly the Gentoo documentation it's much more problem-solving oriented with an index very complete, see for example [4]. I know that pages like that one are very scary, but they collect a set of useful key questions right at the beginning of the page. I think that layouts like that one should be further studied (obviously not blindly applied!) to improve the usability and accessibility of our wiki.
Other. Last but not least, I also report here two annoying issues: SUSE ImageWriter it is not automatically setup to use the file filter *.* (so the unexpert user is unable to see ISO images -> read all of my friends asked me how to use it); after the installation from the 4 GB ISO image, YaST does not automatically disable the DVD local repository, so the user have to handle with YaST's repository manager.
In conclusion, all of my friends are enjoying openSUSE and they are using it both for work or study because of its stability, all DE equally supported, YaST, Zypper and someone (like me) really appreciate that is pure FOSS without privacy issues. Although it needs some little refinements to the user-experience as I said before but nothing impossible to do.
Thank you and keep up the good work! :)
Best regards, hawake
[0] http://www.mediafire.com/view/jocz56r29yude8d/screenshot25modificata.png# [1] http://www.mediafire.com/view/bzrrpdgxejvxy9w/screenshot21.png# [2] http://www.mediafire.com/view/92n6youe70rmxxn/screenshot24.png# [3] http://www.novell.com/documentation/opensuse110/ [4] https://wiki.gentoo.org/wiki/AMD64/FAQ
--
Hello hawake, I'm not going to reply to your points immediately, partially because I want more time to digest your feedback, and partially because I'm really interested in what other people think of your points and expect that will shape some of my feelings on the topic But I wanted to write this email to state that I really appreciate the thought and effort you (and others) have clearly put in this email, and the professional and constructive way you've put your thoughts across. Emails like this is how good changes get started, thank you - Richard openSUSE Board Member -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
I really like the focus on the users point of view, particularly the new ones. Imo it helps to view the project with "fresh eyes". As an user myself, even if since 2005, I must admit sometimes I have difficulties to understand the decision making flow and what are the decisions themselves. But sure, the communication effort is evident. Even in my experience software.opensuse.org is often little-known, a pity, it's really useful particularly after the redesign (thumbnails, unsupported sources hidden by default, etc.). Really worried about the documentation area as a whole, and the wiki particularly. It's really difficult to find what you search for if you don't know your way. Caig -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Mon, 31 Mar 2014 20:00:18 +0200, Caig wrote:
Really worried about the documentation area as a whole, and the wiki particularly. It's really difficult to find what you search for if you don't know your way.
Modern thinking about documentation is very different than the traditional "installation guide/reference guide" sort of stuff. Most users don't want to read a user guide from cover to cover these days - they want help for the task at hand, rather than to try to absorb a firehose of information all at once from a guide and then to try to apply it to a live system. It's almost like a "tutorial mode" within the DE might be more useful. This is similar to a trend that's seen in support as well - customers and users don't want to research an answer, they just want to ask about it. In the forums, we see the same questions over and over (that's how I got started in support forums 20+ years ago anyways - I didn't really know anything special, I just saw questions that had already been asked and answered, and I remembered the answers I'd seen), rather than people reading the sticky posts that already have their questions answered. And it's far, far worse on Facebook, where there's no structure or anything - but users want to ask questions there regardless of the fact that they're not helping populate a knowledge base. They just want their question answered, regardless of who has to spend time answering the same questions multiple times. It's all about convenience. Coming back to documentation, the same thing applies. Good documentation is paired with good UX design, where the UI is intuitive and not needing descriptive text (after all, who doesn't know that a password field is "where you enter your password" - but so much documentation actually spells that out). It needs to be task- oriented, and ideally locatable at the time that it's needed. Of course, for a single application, that's not a big issue to sort out. For an entire operating system, that's another matter entirely. I'm not sure how you solve that, unless you have an interactive tour of each DE (or each of the popular DEs). Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On 2014-04-08 23:30, Jim Henderson wrote:
Modern thinking about documentation is very different than the traditional "installation guide/reference guide" sort of stuff.
Most users don't want to read a user guide from cover to cover these days - they want help for the task at hand, rather than to try to absorb a firehose of information all at once from a guide and then to try to apply it to a live system. ... that they're not helping populate a knowledge base. They just want their question answered, regardless of who has to spend time answering the same questions multiple times.
But the people answering those questions do need the documentation, and read it at some time ;-) -- Cheers / Saludos, Carlos E. R. (from 13.1 x86_64 "Bottle" at Telcontar)
On Wed, 09 Apr 2014 00:30:01 +0200, Carlos E. R. wrote:
On 2014-04-08 23:30, Jim Henderson wrote:
Modern thinking about documentation is very different than the traditional "installation guide/reference guide" sort of stuff.
Most users don't want to read a user guide from cover to cover these days - they want help for the task at hand, rather than to try to absorb a firehose of information all at once from a guide and then to try to apply it to a live system. ... that they're not helping populate a knowledge base. They just want their question answered, regardless of who has to spend time answering the same questions multiple times.
But the people answering those questions do need the documentation, and read it at some time ;-)
Well, that's the hope, but usually knowledge like that is "tribal knowledge" rather than learned from a book. Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On 2014-04-09 00:45, Jim Henderson wrote:
On Wed, 09 Apr 2014 00:30:01 +0200, Carlos E. R. wrote:
But the people answering those questions do need the documentation, and read it at some time ;-)
Well, that's the hope, but usually knowledge like that is "tribal knowledge" rather than learned from a book.
Nah, how else could we have the joy of telling them to RTFM? :-PP (joking!) -- Cheers / Saludos, Carlos E. R. (from 13.1 x86_64 "Bottle" at Telcontar)
On 09/04/14 07:30, Jim Henderson wrote:
On Mon, 31 Mar 2014 20:00:18 +0200, Caig wrote:
Really worried about the documentation area as a whole, and the wiki particularly. It's really difficult to find what you search for if you don't know your way. Modern thinking about documentation is very different than the traditional "installation guide/reference guide" sort of stuff.
Most users don't want to read a user guide from cover to cover these days - they want help for the task at hand, rather than to try to absorb a firehose of information all at once from a guide and then to try to apply it to a live system.
[pruned] Wrong! :-) You are not listening. You are proffering *your* ideas on what *you* believe people *should* be doing - or what should occur for *you* to find it more convenient for yourself :-) . The above was from a FWD post which is telling everyone what the people at the "receiving end" - "the sharp end of the stick" - are feeling, thinking, expressing, and wanting. I have read some parts of the openSUSE "wiki" when looking for information and I find it to be semi-literate in nature, too small in print, and "all over the place" when trying to find information. And is ancient history, not current to what is "now". (And, of course, now I will be asked to provide examples of what "is ancient history" - sigh :-( .) If you want to see what I consider to be most helpful documentation on a Linux distribution have a look at the ones for Ubuntu: https://help.ubuntu.com/community and especially: https://launchpad.net/ Both clearly set-out, in easy to read font. BC -- A civilisation is judged by how it treats the most vulnerable. Lauren Smith - 30 January 2014 -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Wed, 09 Apr 2014 16:36:25 +1000, Basil Chupin wrote:
On 09/04/14 07:30, Jim Henderson wrote:
On Mon, 31 Mar 2014 20:00:18 +0200, Caig wrote:
Really worried about the documentation area as a whole, and the wiki particularly. It's really difficult to find what you search for if you don't know your way. Modern thinking about documentation is very different than the traditional "installation guide/reference guide" sort of stuff.
Most users don't want to read a user guide from cover to cover these days - they want help for the task at hand, rather than to try to absorb a firehose of information all at once from a guide and then to try to apply it to a live system.
[pruned]
Wrong! :-)
You are not listening.
You are proffering *your* ideas on what *you* believe people *should* be doing - or what should occur for *you* to find it more convenient for yourself :-) .
If I were looking for something more convenient for me, I'd be doing away with the documentation entirely because I don't find I need it (other than the occasional man page). What I'm describing is an industry trend. I actually /do/ write technical documentation for a living, so I watch the trends and see what users and customers do and desire. They don't want something that describes that a password field is "where you enter a password". That type of descriptive documentation is, by and large, entirely useless to users, because the UI tells them that that's the value that goes in the field.
The above was from a FWD post which is telling everyone what the people at the "receiving end" - "the sharp end of the stick" - are feeling, thinking, expressing, and wanting.
Yes, and I understand that entirely. I see what you're trying to do, and quite honestly, if you have something to say to me, I wish you'd say it in a constructive way rather than trying to "make a point" by doing this. It's not helpful nor does it particularly add to this discussion.
I have read some parts of the openSUSE "wiki" when looking for information and I find it to be semi-literate in nature, too small in print, and "all over the place" when trying to find information. And is ancient history, not current to what is "now".
Yes, I agree. That's one of the downsides of OSS development - you tend not to have professional writers writing documentation, and in general coders tend to want to write code rather than documentation - so good documentation can be very hard to come by unless the project (whichever project it is) makes documentation a priority and gives it specific attention.
(And, of course, now I will be asked to provide examples of what "is ancient history" - sigh :-( .)
If you want to see what I consider to be most helpful documentation on a Linux distribution have a look at the ones for Ubuntu:
https://help.ubuntu.com/community
and especially:
Both clearly set-out, in easy to read font.
Because Ubuntu caters to new users, and apparently has made documenting things in a way that's digestable for new users a priority. That doesn't mean, though, that users will tend to dig into a documentation set rather than, for example, visit the Ubuntu forums and ask a question, even if it's covered in the documentation and even if it's easy to find. The trend (and I'm not saying /every/ user does this, that's not a 'trend') is that the user goes for what is most convenient for them - to ask a question and wait to be told the specific answer they need rather than have to even search for it. The only way to effectively combat that behaviour is to make the information more conveniently available than even asking a question. Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
2014-04-09 18:09 GMT+02:00 Jim Henderson <hendersj@gmail.com>:
The trend (and I'm not saying /every/ user does this, that's not a 'trend') is that the user goes for what is most convenient for them - to ask a question and wait to be told the specific answer they need rather than have to even search for it. The only way to effectively combat that behaviour is to make the information more conveniently available than even asking a question.
I see too the many users requesting over and over the same questions. More difficult is to see how many users just find by themselves the answers they need. Probably some of them use the wiki (or try to do so), if the statistics available here http://en.opensuse.org/Special:Statistics are reliable, in the last 24h (20:00 - 20:00 CET) the English wiki received ~50937 visits (I save the data since some times). At least a fraction should be real users. There will be always the "lazy" users, but a more user-oriented* wiki could be useful at least for the rest (even to give a link to the lazy ones :P). Wiki context-reachability (from YaST for example) probably it's too difficult/not doable. * For example (borrowing ideas from the first thread message): - right-to-the-point guide (the SDB...the potentially more useful namespace currently hidden by the search default settings...) - easier instructions (GUI way) in the first place and then, if really needed, the more cryptic ones for the geeks (that probably don't need them...) Caig -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Fri, 11 Apr 2014 21:30:31 +0200, Caig wrote:
2014-04-09 18:09 GMT+02:00 Jim Henderson <hendersj@gmail.com>:
I see too the many users requesting over and over the same questions. More difficult is to see how many users just find by themselves the answers they need.
Practically impossible, really, because while you might have page hits, you don't know what they were looking for, or if they found the answer on the specific page they visited.
Probably some of them use the wiki (or try to do so), if the statistics available here http://en.opensuse.org/Special:Statistics are reliable, in the last 24h (20:00 - 20:00 CET) the English wiki received ~50937 visits (I save the data since some times). At least a fraction should be real users.
Sure, you'll always have some robots that are indexing or scraping the site.
There will be always the "lazy" users, but a more user-oriented* wiki could be useful at least for the rest (even to give a link to the lazy ones :P).
In a little over 20 years of doing online support, I can say that while there always have been lazy users who have just asked rather than doing some research first, this trend has increased from what I've seen. What's more, it's exacerbated by the fact that many users don't provide enough information (some because they don't know what to provide, even in terms of basic information - like DE or oS version), so it takes several exchanges to get the information needed to make a proper diagnosis. Many just don't know how to ask effective questions, so we get the functional equivalent of "my thing's broke." Often times, users with some experience will actually try to include useful information, but often times will only guess about the problem rather than describing what they're actually seeing (or including actual screen output). "I get an error message" is far too common, without either context or the actual text of the error message.
Wiki context-reachability (from YaST for example) probably it's too difficult/not doable.
* For example (borrowing ideas from the first thread message): - right-to-the-point guide (the SDB...the potentially more useful namespace currently hidden by the search default settings...) - easier instructions (GUI way) in the first place and then, if really needed, the more cryptic ones for the geeks (that probably don't need them...)
I think, perhaps, what we need to do is put together some sort of "new user survey" to find out the sorts of things new users find they need to know or would like to learn about. We know, for example, that installation of multimedia codecs is something we see a lot of requests for help for, and as most of us are very seasoned at adding the Packman repo and switching the packages over to that repo (installing whatever it is we need from there when relevant), it's not as clear-cut to a new user as it is for the experienced user. But what we need to identify is what leads a new user to ask (for example) on Facebook rather than the forums (or to even read the sticky that explains multimedia to them) or to go to the wiki. Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
Le 11/04/2014 21:30, Caig a écrit :
There will be always the "lazy" users, but a more user-oriented* wiki could be useful at least for the rest
I think it's the way choosen some time (years?) ago, and it's a wrong way. wiki are searched by google or it's own search engine, and admins have to focus on this. then wiki are *written* by volunteers that can't know the desired structure and shouldn't have to worry about. I stopped writing on the wiki when it became necessary to organize it. "wiki organization" is contradictory by essence. just now the forum archives do the job of the wiki. It's perfectly nice to have a *documentation* web site, different from the wiki and well organized, but this have to be done by a documentation staff, not by random user - I think something similar is on the way for openSUSE jdd -- http://www.dodin.org -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Fri, 11 Apr 2014 23:12:10 +0200, jdd wrote:
Le 11/04/2014 21:30, Caig a écrit :
There will be always the "lazy" users, but a more user-oriented* wiki could be useful at least for the rest
I think it's the way choosen some time (years?) ago, and it's a wrong way.
wiki are searched by google or it's own search engine, and admins have to focus on this.
then wiki are *written* by volunteers that can't know the desired structure and shouldn't have to worry about. I stopped writing on the wiki when it became necessary to organize it.
"wiki organization" is contradictory by essence. just now the forum archives do the job of the wiki.
It's perfectly nice to have a *documentation* web site, different from the wiki and well organized, but this have to be done by a documentation staff, not by random user - I think something similar is on the way for openSUSE
I somewhat agree and somewhat disagree. I've always thought that a wiki could be structured, but the structuring needs to be handled by a dedicated team, with the content provided by volunteers. But the volunteers need to have some input into the structure, too. There's a strong need for a "team" to write like this. Structure, though, is a high-level idea in a structured wiki. I've seen them successfully implemented using twiki, for example, and I think something like that could work for us here. The Povray project uses a structured wiki for its documentation, in fact (they use Mediawiki - I initially helped them set it up for that purpose). There are some special tags they use so the wiki forms the basis for a single-sourced documentation set. It actually works pretty well. Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
2014-04-11 22:54 GMT+02:00 Jim Henderson <hendersj@gmail.com>:
On Fri, 11 Apr 2014 21:30:31 +0200, Caig wrote:
2014-04-09 18:09 GMT+02:00 Jim Henderson <hendersj@gmail.com>:
I see too the many users requesting over and over the same questions. More difficult is to see how many users just find by themselves the answers they need.
Practically impossible, really, because while you might have page hits, you don't know what they were looking for, or if they found the answer on the specific page they visited.
sure (sadly of course)
I think, perhaps, what we need to do is put together some sort of "new user survey" to find out the sorts of things new users find they need to know or would like to learn about.
I really like the idea: focus on the users (and potentially new contributors, the future of the project) 2014-04-12 0:28 GMT+02:00 Jim Henderson <hendersj@gmail.com>:
On Fri, 11 Apr 2014 23:12:10 +0200, jdd wrote:
Le 11/04/2014 21:30, Caig a écrit :
There will be always the "lazy" users, but a more user-oriented* wiki could be useful at least for the rest
I think it's the way choosen some time (years?) ago, and it's a wrong way.
wiki are searched by google or it's own search engine, and admins have to focus on this.
then wiki are *written* by volunteers that can't know the desired structure and shouldn't have to worry about. I stopped writing on the wiki when it became necessary to organize it.
"wiki organization" is contradictory by essence. just now the forum archives do the job of the wiki.
It's perfectly nice to have a *documentation* web site, different from the wiki and well organized, but this have to be done by a documentation staff, not by random user - I think something similar is on the way for openSUSE
I somewhat agree and somewhat disagree.
I've always thought that a wiki could be structured, but the structuring needs to be handled by a dedicated team, with the content provided by volunteers.
But the volunteers need to have some input into the structure, too. There's a strong need for a "team" to write like this.
+1 writing/updating pages (even a single one a single time) and keeping all the wiki structured (or grouped if structured sounds heavy/too limiting) are two different tasks. Even to avoid duplication of effort like these for example - http://en.opensuse.org/SDB:LAMP_setup and http://en.opensuse.org/SDB:Linux_Apache_MySQL_PHP - http://en.opensuse.org/SDB:Apper and http://en.opensuse.org/SDB:Apper_troubleshooting or poor orphans barely discoverable http://en.opensuse.org/Special:LonelyPages Caig -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Sun, 13 Apr 2014 17:27:28 +0200, Caig wrote:
I think, perhaps, what we need to do is put together some sort of "new user survey" to find out the sorts of things new users find they need to know or would like to learn about.
I really like the idea: focus on the users (and potentially new contributors, the future of the project)
Well, ideally most of the documentation that's on the website should be targeted at new users, I think. The focus for new contributors is somewhat different, depending on the nature of the contribution they want to make.
+1 writing/updating pages (even a single one a single time) and keeping all the wiki structured (or grouped if structured sounds heavy/too limiting) are two different tasks. Even to avoid duplication of effort like these for example - http://en.opensuse.org/SDB:LAMP_setup and http://en.opensuse.org/SDB:Linux_Apache_MySQL_PHP - http://en.opensuse.org/SDB:Apper and http://en.opensuse.org/SDB:Apper_troubleshooting or poor orphans barely discoverable http://en.opensuse.org/Special:LonelyPages
Exactly - that's why structure is needed - you end up with duplication, and with duplication, you have the serious potential for multiple conflicting ways to handle things. While there may be multiple ways to do things, for new users particularly, the simplest way to get things going is with the simplest procedure. Understanding the interdependencies between different parts of a knowledge domain is also important in order to build a flow. Even if a user starts with implementing LAMP, they might need some prerequisite knowledge on Apache, MySQL, or PHP. If there aren't references like that, then users end up frustrated because they'll read an instruction and say "but I don't know how to do that - where do I go look?" and they can't find it. Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Sun, 2014-04-13 at 18:33 +0000, Jim Henderson wrote:
I think, perhaps, what we need to do is put together some sort of "new user survey" to find out the sorts of things new users find they need to know or would like to learn about.
I really like the idea: focus on the users (and potentially new contributors, the future of the project) There is an existing survey: the search terms used on the opensuse site. Most opensuse users, I imagine, go there first when they need information.
After that you could try the most popular google search phrases including the word opensuse. David -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Sun, 13 Apr 2014 21:21:15 +0100, Administrator wrote:
On Sun, 2014-04-13 at 18:33 +0000, Jim Henderson wrote:
I think, perhaps, what we need to do is put together some sort of "new user survey" to find out the sorts of things new users find they need to know or would like to learn about.
I really like the idea: focus on the users (and potentially new contributors, the future of the project) There is an existing survey: the search terms used on the opensuse site. Most opensuse users, I imagine, go there first when they need information.
You might be surprised. But while I agree that that's valuable data, that's not really a "survey". Surveys have more structure to them than just raw data.
After that you could try the most popular google search phrases including the word opensuse.
After having read the search terms that land people at various websites (some blogs even post them periodically), I'm not sure that that would be quite as useful. For example, read the "Road to Popehat" posts at popehat.com. :) Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
2014-04-13 20:33 GMT+02:00 Jim Henderson <hendersj@gmail.com>:
On Sun, 13 Apr 2014 17:27:28 +0200, Caig wrote:
I think, perhaps, what we need to do is put together some sort of "new user survey" to find out the sorts of things new users find they need to know or would like to learn about.
I really like the idea: focus on the users (and potentially new contributors, the future of the project)
Well, ideally most of the documentation that's on the website should be targeted at new users, I think. The focus for new contributors is somewhat different, depending on the nature of the contribution they want to make.
yes, i explained badly the thought (language doesn't help). I just think the focus on the users ( on their point of view, I believe this is the general meaning of the hawake's first message) can help to engage them. And potentially some of them will give back the attention to the project as contributors. Caig
+1 writing/updating pages (even a single one a single time) and keeping all the wiki structured (or grouped if structured sounds heavy/too limiting) are two different tasks. Even to avoid duplication of effort like these for example - http://en.opensuse.org/SDB:LAMP_setup and http://en.opensuse.org/SDB:Linux_Apache_MySQL_PHP - http://en.opensuse.org/SDB:Apper and http://en.opensuse.org/SDB:Apper_troubleshooting or poor orphans barely discoverable http://en.opensuse.org/Special:LonelyPages
Exactly - that's why structure is needed - you end up with duplication, and with duplication, you have the serious potential for multiple conflicting ways to handle things. While there may be multiple ways to do things, for new users particularly, the simplest way to get things going is with the simplest procedure.
Understanding the interdependencies between different parts of a knowledge domain is also important in order to build a flow. Even if a user starts with implementing LAMP, they might need some prerequisite knowledge on Apache, MySQL, or PHP. If there aren't references like that, then users end up frustrated because they'll read an instruction and say "but I don't know how to do that - where do I go look?" and they can't find it.
Jim
-- Jim Henderson Please keep on-topic replies on the list so everyone benefits
-- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
-- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
On Tue, 15 Apr 2014 22:16:45 +0200, Caig wrote:
yes, i explained badly the thought (language doesn't help). I just think the focus on the users ( on their point of view, I believe this is the general meaning of the hawake's first message) can help to engage them. And potentially some of them will give back the attention to the project as contributors.
That's certainly true - and a beneficial side-effect. :) Jim -- Jim Henderson Please keep on-topic replies on the list so everyone benefits -- To unsubscribe, e-mail: opensuse-project+unsubscribe@opensuse.org To contact the owner, email: opensuse-project+owner@opensuse.org
participants (8)
-
Administrator -
Basil Chupin -
Caig -
Carlos E. R. -
G G -
jdd -
Jim Henderson -
Richard Brown