purps
NEEDS to work for LinuxMCE
  
Posts: 1269
If it ain't broke, tweak it
|
 |
« Reply #15 on: September 17, 2011, 01:27:34 pm » |
|
I've just viewed this page on my netbook for the first time, and the text is wrapping in a stupid way, probably due to the stupid way in which I have done it. I will change this also.
|
|
|
|
|
Logged
|
|
|
|
|
bongowongo
|
 |
« Reply #16 on: September 17, 2011, 03:36:51 pm » |
|
I agree on the colours for the version info, will change that shortly.
Regarding the page type, I see no reason why both can't be displayed as per the example. Doesn't make sense to split pages up just for the sake of it - if there is RELEVANT background information to an instruction, or vice versa, then fine, just have both.
Makes sense. Ok, I will wait till you modified all, so we can finalise it.
|
|
|
|
|
Logged
|
|
|
|
|
twodogs
|
 |
« Reply #17 on: September 17, 2011, 10:28:15 pm » |
|
A lot of our current wiki articles assume a level of knowledge that many beginning and intermediate users do not possess (i.e. change the polarity on the flux capacitor and Bob's your uncle - it works!). I find that really irritating. If I knew as much as the author, I probably wouldn't be reading his wiki article. So it might be nice to include some verbiage in the template on the preferred level of detail. Something like...
"Wiki articles should be written with beginning users in mind. Readers should be provided an overview of what they are doing before being given a laundry list of steps to perform. If the overview already has already been covered elsewhere, a link to that source would be helpful. If no overview exists, then an introductory paragraph might eliminate repeated cries for assistance in the forums."
This is a pretty simple thing that will pay off in a big way. It makes LinuxMCE less intimidating to new users, so we will increase our user-base. It will also allow users to graduate more rapidly from beginner, to intermediate, to advanced, to developer. A larger and smarter user-base is nothing but good.
|
|
|
|
« Last Edit: September 17, 2011, 10:39:18 pm by twodogs »
|
Logged
|
http://greenrenovation.wordpress.com/home-automation/system: ASUS P5N7A-VM integrated GeForce 9300 E5200 processor Fusion 5 lite HDTV card 2G RAM SYBA SY-PCI15001 6-port serial card Denon AVR 3805 LG 42" Plasma Gyration GYR3101 Cisco SPA3102 analog telephone adapter Cisco 7971G IP phone/orbiter
|
|
|
|
bongowongo
|
 |
« Reply #18 on: September 18, 2011, 01:06:39 am » |
|
A lot of our current wiki articles assume a level of knowledge that many beginning and intermediate users do not possess (i.e. change the polarity on the flux capacitor and Bob's your uncle - it works!). I find that really irritating. If I knew as much as the author, I probably wouldn't be reading his wiki article. So it might be nice to include some verbiage in the template on the preferred level of detail. Something like...
"Wiki articles should be written with beginning users in mind. Readers should be provided an overview of what they are doing before being given a laundry list of steps to perform. If the overview already has already been covered elsewhere, a link to that source would be helpful. If no overview exists, then an introductory paragraph might eliminate repeated cries for assistance in the forums."
This is a pretty simple thing that will pay off in a big way. It makes LinuxMCE less intimidating to new users, so we will increase our user-base. It will also allow users to graduate more rapidly from beginner, to intermediate, to advanced, to developer. A larger and smarter user-base is nothing but good.
It makes sense. I just reveiced a link from the dev's that was to difficult for me. Maybe make a class Novice Intermediate Expert
|
|
|
|
|
Logged
|
|
|
|
|
davegravy
|
 |
« Reply #19 on: September 18, 2011, 02:25:54 am » |
|
In addition to the 3 levels mentioned, what about a "needs simplification" tag for novice level articles that aren't simple enough.
|
|
|
|
|
Logged
|
|
|
|
|
bongowongo
|
 |
« Reply #20 on: September 18, 2011, 11:11:29 am » |
|
If a target reader is a novice it should be able to read it If it is not the writer will just have to take another class.
|
|
|
|
|
Logged
|
|
|
|
|
davegravy
|
 |
« Reply #21 on: September 18, 2011, 05:04:10 pm » |
|
Not sure if I described my idea very well.
I'm thinking:
3 levels of intended audience (novice, intermediate, advanced) AND for articles that are intended for novice/intermediate users, but are clearly not simple enough for that group, a "needs simplification" tag.
That way if a wiki editor comes across an article that is intended for novice users and it is too complicated, he can tag it as such, and then the article author knows he needs to do more work to simplify things. It's a notice system to the author.
|
|
|
|
|
Logged
|
|
|
|
purps
NEEDS to work for LinuxMCE
  
Posts: 1269
If it ain't broke, tweak it
|
 |
« Reply #22 on: September 19, 2011, 11:47:00 am » |
|
I do agree that the pages should be written for the novice, and something need to be in place to ensure that this happens. What twodogs said to do is vital - I will think about creating a wiki template/standards page and start getting things like this in it.
With regards to marking the pages as novice/intermediate/advance, is that not a bit overkill? Who decides what is intermediate and what is advanced? I completely understand the need for it, but isn't there already a wiki feature in place that says "this page is a stub" and "this page requires simplification", etc? I've seen this on wikipedia before, but I have never known how one would flag this up.
|
|
|
|
|
Logged
|
|
|
|
|
|
purps
NEEDS to work for LinuxMCE
  
Posts: 1269
If it ain't broke, tweak it
|
 |
« Reply #24 on: October 05, 2011, 09:38:05 am » |
|
Yes I am going to lay it out in a different way, tables within tables perhaps. I've been experimenting with different browsers on different devices and the current layout is definitely no good.
|
|
|
|
|
Logged
|
|
|
|
|
posde
|
 |
« Reply #25 on: October 05, 2011, 02:47:39 pm » |
|
A note of advice: When setting up templates and pages, always remember the KISS principle. Make sure that
a) writers can easily setup pages without needing to dig around in obscure formatting b) make sure stuff is linked to categories as much as possible
|
|
|
|
|
Logged
|
|
|
|
|
bongowongo
|
 |
« Reply #26 on: October 16, 2011, 09:18:14 pm » |
|
In my opinion, the page status should present fixed choices in a drop down menu. But I am not sure how this will work with the wiki.
|
|
|
|
|
Logged
|
|
|
|
|