Author Topic: Task | Draft Page Status  (Read 30148 times)

purps

  • NEEDS to work for LinuxMCE
  • ***
  • Posts: 1402
  • If it ain't broke, tweak it
    • View Profile
Re: Task | Draft Page Status
« Reply #15 on: September 17, 2011, 02: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.
1004 RC :: looking good :: upgraded 01/04/2013
my setup :: http://wiki.linuxmce.org/index.php/User:Purps

bongowongo

  • Moderator
  • wants to work for LinuxMCE
  • *****
  • Posts: 826
    • View Profile
Re: Task | Draft Page Status
« Reply #16 on: September 17, 2011, 04: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.

twodogs

  • Guru
  • ****
  • Posts: 224
    • View Profile
Re: Task | Draft Page Status
« Reply #17 on: September 17, 2011, 11: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, 11:39:18 pm by twodogs »
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

  • Moderator
  • wants to work for LinuxMCE
  • *****
  • Posts: 826
    • View Profile
Re: Task | Draft Page Status
« Reply #18 on: September 18, 2011, 02: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

davegravy

  • Addicted
  • *
  • Posts: 551
    • View Profile
Re: Task | Draft Page Status
« Reply #19 on: September 18, 2011, 03: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.

bongowongo

  • Moderator
  • wants to work for LinuxMCE
  • *****
  • Posts: 826
    • View Profile
Re: Task | Draft Page Status
« Reply #20 on: September 18, 2011, 12:11:29 pm »
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.

davegravy

  • Addicted
  • *
  • Posts: 551
    • View Profile
Re: Task | Draft Page Status
« Reply #21 on: September 18, 2011, 06: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.

purps

  • NEEDS to work for LinuxMCE
  • ***
  • Posts: 1402
  • If it ain't broke, tweak it
    • View Profile
Re: Task | Draft Page Status
« Reply #22 on: September 19, 2011, 12:47:00 pm »
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.
1004 RC :: looking good :: upgraded 01/04/2013
my setup :: http://wiki.linuxmce.org/index.php/User:Purps

bongowongo

  • Moderator
  • wants to work for LinuxMCE
  • *****
  • Posts: 826
    • View Profile
Re: Task | Draft Page Status
« Reply #23 on: September 20, 2011, 08:51:24 am »
http://wiki.linuxmce.org/index.php/Draft_Frequently_used_Command

Hi Purps, I tried to do the status page for this page.
Somehow the alignments do not work if you edit the status boxes specifically for the page.

purps

  • NEEDS to work for LinuxMCE
  • ***
  • Posts: 1402
  • If it ain't broke, tweak it
    • View Profile
Re: Task | Draft Page Status
« Reply #24 on: October 05, 2011, 10: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.
1004 RC :: looking good :: upgraded 01/04/2013
my setup :: http://wiki.linuxmce.org/index.php/User:Purps

Marie.O

  • Administrator
  • LinuxMCE God
  • *****
  • Posts: 3676
  • Wastes Life On LinuxMCE Since 2007
    • View Profile
    • My Home
Re: Task | Draft Page Status
« Reply #25 on: October 05, 2011, 03: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

bongowongo

  • Moderator
  • wants to work for LinuxMCE
  • *****
  • Posts: 826
    • View Profile
Re: Task | Draft Page Status
« Reply #26 on: October 16, 2011, 10: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.