LinuxMCE Forums

General => Developers => Wiki => Topic started by: bongowongo on August 28, 2011, 11:04:43 am

Title: Wikiworkgroup | Main topic
Post by: bongowongo on August 28, 2011, 11:04:43 am
People in the group

fibres
Techstyle
Task | Frontpage wiki
Klovell
Purps
Task | Frontpage wiki
BongoWongo
Task | Frontpage wiki
DragonK
Dan249
nzlneil
twodogs
frustrated
kezza
davegravy
Task | Frontpage wiki
          support in video creation

Congratulations all on joining the team and thank you for wanting to help.
If for some reason you are not willing or not able to participate anymore and if you got a task assigned.
Please tell us, it is better to know than to wait for nothing to happen.

It is better that we discuss here about general topics and distillate tasks here.
We will leave the post with topic "Workgroup Wiki/Manual " in the user-channel for recruiting purposes.

I have made a placeholder for our group in the wiki
http://wiki.linuxmce.org/index.php/Wikiworkgroup
Title: Re: Wikiworkgroup | Main topic
Post by: purps on August 28, 2011, 01:04:12 pm
Worth a read I reckon http://www.mythtv.org/wiki/MythTV:Manual_of_Style
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on August 28, 2011, 02:40:31 pm
Worth a read I reckon http://www.mythtv.org/wiki/MythTV:Manual_of_Style

Yes very nice.
I have a new task you may be interested in?
http://forum.linuxmce.org/index.php/topic,11910.0.html
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on August 28, 2011, 02:54:07 pm
Purps I see what you are doing in the

http://wiki.linuxmce.org/index.php/Draft_Main_Page

Maybe it is better to communicate you are on that project specific, and communicate your changes in the forum.
So it is easier to maintain?
If you reply with a yes, I will put you on that project.

I do this to keep overview, who is doing what and why?
Then it will be easier to keep track.
I want to prevent people from just jumping on pages and nobody knows what is happening or maybe "destroying" visions of others
That could lead to confrontations

That is why I am maybe a little nagging about rules etc..........

I am appreciating what you do, do not get me wrong.
Title: Re: Wikiworkgroup | Main topic
Post by: Techstyle on August 28, 2011, 06:42:14 pm
On that page it says "Purps: As well as screenshots, or even instead of, we should have images that show LMCE in the home.", with regard to this people could submit there in home pictures:

http://www.techstyleuk.co.uk/103_4624.JPG (http://www.techstyleuk.co.uk/103_4624.JPG)

Although mine is still under construction.  they probably do have to look more professional for the main page.

A good addition to the webpage would be the addition of the ability for users to upload their photos
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on August 28, 2011, 10:58:14 pm
Let's move the frontpage discussion to the proper task forum topic.
http://forum.linuxmce.org/index.php/topic,11905.0.html
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on August 28, 2011, 11:40:12 pm
Possy suggested that when we are done with a page we should put them in special catagory that tells the community it is approved and/or maintained by the workgroup.
Just like my "Bongo stamp of approval". But let's call it different.

I am open to suggestions

LMCE-Approved
WW-Approved
Title: Re: Wikiworkgroup | Main topic
Post by: purps on August 29, 2011, 02:29:10 am
Purps I see what you are doing in the

http://wiki.linuxmce.org/index.php/Draft_Main_Page

Maybe it is better to communicate you are on that project specific, and communicate your changes in the forum.
So it is easier to maintain?
If you reply with a yes, I will put you on that project.

I do this to keep overview, who is doing what and why?
Then it will be easier to keep track.
I want to prevent people from just jumping on pages and nobody knows what is happening or maybe "destroying" visions of others
That could lead to confrontations

That is why I am maybe a little nagging about rules etc..........

I am appreciating what you do, do not get me wrong.


I completely agree, I just had 20 minutes to kill before I went out and did a little bit, sorry I should have mentioned it first.

Whilst I think it makes sense to divide up the tasks to individuals or very small groups, I do think the main page should be a joint effort. I know everything will go through a review process ultimately, but still.
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on August 29, 2011, 02:31:56 am
Yes could be. But it was our first task :)
Just wanted to have some input and see what direction we should go.

This is new for me too ;)
Title: Re: Wikiworkgroup | Main topic
Post by: DragonK on August 29, 2011, 08:26:21 am
If for some reason you are not willing or not able to participate anymore and if you got a task assigned.
Please tell us, it is better to know than to wait for nothing to happen.


Bongo,

Once we've decided on the layout, then I can assist in changing the current pages.

Karel
Title: Re: Wikiworkgroup | Main topic
Post by: brononius on August 31, 2011, 01:50:11 pm
If you want, I can help.

I believe strongly in a dummy installations manual. And since I'm a dummy today... ;)
Blocks (media, automation, server, security...) and how to configure the simple things (adding rooms, lights, dhcp, orbiter, scenario's...).
More in depth technical stuff belong in the forum, maybe with some shortcuts from the wiki to interesting topics?




ps My personal documentation of linuxmce: http://www.oniria.be/pri/index.php/linux/233-linuxmce
Title: Re: Wikiworkgroup | Main topic
Post by: purps on September 08, 2011, 12:00:21 pm
Bongowongo, have you had any luck reading up on the MediaWiki stuff?
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on September 08, 2011, 12:02:41 pm
No Purps, I am a bit lacking.
I thought I could do this last weekend. I will do it coming weekend, to give some more swing to the whole project :)
Title: Re: Wikiworkgroup | Main topic
Post by: purps on September 08, 2011, 12:05:53 pm
OK cool :)
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on September 22, 2011, 02:36:30 am
I put some more substance in the following page
http://wiki.linuxmce.org/index.php/Wikiworkgroup
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on September 29, 2011, 12:27:19 am
Bongo,

I'm guessing that there are a few people who are really working hard on this, but a lot of your team is in wait mode. If you could give us your idea of the path to completion, then others could get to work. We could shift from a sequential effort to a parallel effort. In another post, you asked everyone to identify obsolete wiki articles. That's too broad. But if you said "Twodogs, go through all the Telecom wiki articles and identify the obsolete ones", then I could say "yes, boss".
So, even though we might not have the wiki structure in place yet, I think we should identify who will be responsible for what chapters. That's what I was getting at in my previous post. I don't care if you use the timeline I suggested - maybe someone else has a better idea. I just think that this is a big job and we need to get lots of people working on it.


Quote
Bongo, give us your idea of what we are embarking upon. I suggested a sequence a few weeks ago where you would be the supervisor, and the rest of us would be the worker bees. It also seems like you are asking for us to do things that I thought would come much later (rewrites and new content). I think the sequence below makes your life a whole lot easier and would get us up and running faster.

    Create the new wiki structure/framework (programming skills required)
    Identify the chapter leads (maybe one or two chapters per volunteer)
    Have each chapter lead fill out his chapter by cut/paste from existing content. The first level would come mainly from the manual. Second and third levels would mostly be wiki articles. This would be more of a sorting effort instead of a huge rewrite (which could take forever).
    Release the new wiki. Beers for everyone. There would not be much new content, but at least people could finally find what they are looking for (our biggest problem).
    Improve/Maintain. Once we have everything properly sorted and organized, we will discover many areas for improvements. This is where we can draft rewrites. The chapter leads can start tracking down the experts and asking for updates (making every effort to avoid bugging the devs).
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on October 02, 2011, 11:49:20 pm
Bongo,

I'm guessing that there are a few people who are really working hard on this, but a lot of your team is in wait mode. If you could give us your idea of the path to completion, then others could get to work. We could shift from a sequential effort to a parallel effort. In another post, you asked everyone to identify obsolete wiki articles. That's too broad. But if you said "Twodogs, go through all the Telecom wiki articles and identify the obsolete ones", then I could say "yes, boss".
So, even though we might not have the wiki structure in place yet, I think we should identify who will be responsible for what chapters. That's what I was getting at in my previous post. I don't care if you use the timeline I suggested - maybe someone else has a better idea. I just think that this is a big job and we need to get lots of people working on it.



Hi Twodog, I am new at this too, and I have been away for some days.
So I am picking up where I left of.

What I want to do first is get a good basis, purps has been coming along quite well but I guess he is busy now too.

look at this page
http://wiki.linuxmce.org/index.php/Wikiworkgroup


I also got some critisism from phenigma that my approach of making draft pages of existing pages is not a good idea. I would really like hear people's take on this.


Title: Re: Wikiworkgroup | Main topic
Post by: purps on October 04, 2011, 11:04:53 pm
Please accept my apologies for the slackness, just quit my job (don't worry, I now have another) and house hunting has started again. I will finish off the bits I started ASAP, as well as the main page.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on October 05, 2011, 05:58:27 am
I wasn't trying to accuse my new friends of slackness. I was just feeling kind of slack myself. I know all about life transitions - we moved to Denver, ripped down and rebuilt half the house, and I'm looking for a new job (unfortunately I can't say I have one now!)

twodogs
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on October 05, 2011, 07:57:20 am
Please accept my apologies for the slackness, just quit my job (don't worry, I now have another) and house hunting has started again. I will finish off the bits I started ASAP, as well as the main page.

Did you see my posts regarding the "draft page status"
And I want to focus on a wiki template, so others can start using them.
Title: Re: Wikiworkgroup | Main topic
Post by: purps on October 05, 2011, 10:48:11 am
I wasn't trying to accuse my new friends of slackness. I was just feeling kind of slack myself. I know all about life transitions - we moved to Denver, ripped down and rebuilt half the house, and I'm looking for a new job (unfortunately I can't say I have one now!)

twodogs

No that's not what I meant, I was only talking personally, just don't want you guys to think I have lost interest. And yes, I have read your blog with great interest.

Did you see my posts regarding the "draft page status"
And I want to focus on a wiki template, so others can start using them.

I just responded, will look at that first.

Will attack the template next. Does anything exist at this moment in time? Will the instructions as to how to approach the writing of the article be included (language, pronoun use, etc) or would this be a separate page?
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on October 23, 2011, 12:33:27 am
I can start trying to establish a new wiki structure if I can get set up with a wiki administrator password.
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on October 24, 2011, 05:56:16 am
I can start trying to establish a new wiki structure if I can get set up with a wiki administrator password.

Is your name twodogs in the wiki?
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on October 24, 2011, 11:04:58 am
I have opened an IRC channel on freenode
It is called #linuxmce-wiki.

Please join.

Also twodogs could you join the channel so we can talk through your plans
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on October 27, 2011, 05:54:22 am
I'll try to catch you on IRC. Basically, I'd like to create a new sidebar on the main wiki page with a few headings and subheadings in order to model our proposed wiki format.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 01, 2011, 07:22:01 pm
I'm Twodogs in the wiki, yes. And I'm logged into the IRC channel.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 02, 2011, 11:30:29 pm
Here is what I'm talking about. Look at the left to see a new "Contents" sidebar. Clicking an item in the sidebar reveals a drop down menu. The second picture shows what happens when you click "media". All wiki articles relating to media are linked to the various subheadings. The sidebar is always visible and all content is no more than 2 clicks away.

(http://img710.imageshack.us/img710/9708/wikimod1.jpg) (http://imageshack.us/photo/my-images/710/wikimod1.jpg/)

(http://img838.imageshack.us/img838/3935/wikimod2.jpg) (http://imageshack.us/photo/my-images/838/wikimod2.jpg/)


Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 03, 2011, 12:09:40 pm
I am not sure it is easily possible to have the sub-headings displayed dynamically. And I don't think it is really needed. As I wrote in IRC, please provide the necessary landing pages that should be called from your first level of content, and I will change the sidebar accordingly.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 03, 2011, 01:47:32 pm
The drop down sidebars are not strictly necessary, but I think they make things a whole lot easier for users. It would provide a site map always in view. Its not practical to shift all the second level sidebar items up to the first level - too many of them. Not trying to make work for people which is why I was volunteering to give it a try. Here is a link...

http://www.mediawiki.org/wiki/Thread:Project:Support_desk/Drop-down_Sidebar

As for the landing pages, I think it is basically all wiki content. Again I'm not trying to overwhelm anyone with busywork. I thought we could dole out responsibility for the different sections to our wiki volunteers.
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 05, 2011, 11:34:41 am
How about, as a start, you provide the main set of articles for the first level of headings, to get going? As soon as you have those, I shall modify the sidebar accordingly, and we take it from there?
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 05, 2011, 03:24:45 pm
LMCE Installation Instructions (with pictures/videos)

LMCE Operation Instructions (with pictures/videos)

Core/Hybrid
http://wiki.linuxmce.org/index.php/Category:Cores
http://wiki.linuxmce.org/index.php/Category:Mainboards
http://wiki.linuxmce.org/index.php/Category:Graphic_Cards
http://wiki.linuxmce.org/index.php/Category:Video
http://wiki.linuxmce.org/index.php/Category:Network_Adapters
http://wiki.linuxmce.org/index.php/Category:Soundcards
http://wiki.linuxmce.org/index.php/Category:RAID_Controller
http://wiki.linuxmce.org/index.php/Category:Cases
http://wiki.linuxmce.org/index.php/Category:Input
http://wiki.linuxmce.org/index.php/Category:TV_Cards

Media Directors
http://wiki.linuxmce.org/index.php/Category:Media_Directors
http://wiki.linuxmce.org/index.php/Category:Barebones
http://wiki.linuxmce.org/index.php/Category:Laptops
http://wiki.linuxmce.org/index.php/Category:Nettops

Network
http://wiki.linuxmce.org/index.php/Category:Networking
http://wiki.linuxmce.org/index.php/Category:Network_Attached_Storage
http://wiki.linuxmce.org/index.php/Category:Storage
http://wiki.linuxmce.org/index.php/Category:Network_Adapters
http://wiki.linuxmce.org/index.php/Category:Routers

Control
http://wiki.linuxmce.org/index.php/Category:Remote_Controls
http://wiki.linuxmce.org/index.php/Category:Orbiters
http://wiki.linuxmce.org/index.php/Category:Bluetooth
http://wiki.linuxmce.org/index.php/Category:Serial
http://wiki.linuxmce.org/index.php/Category:USB
http://wiki.linuxmce.org/index.php/Category:Infrared
http://wiki.linuxmce.org/index.php/Category:PDA
http://wiki.linuxmce.org/index.php/Category:Symbian_Series_60_mobile
http://wiki.linuxmce.org/index.php/Category:Touchscreen
http://wiki.linuxmce.org/index.php/Category:WebPads

Media
http://wiki.linuxmce.org/index.php/Category:Displays
http://wiki.linuxmce.org/index.php/Category:Projectors
http://wiki.linuxmce.org/index.php/Category:TV_Cards
http://wiki.linuxmce.org/index.php/SlimDevices_/_Logitech_Squeezebox
http://wiki.linuxmce.org/index.php/Use_a_satellite/cable_box_with_the_PVR
http://wiki.linuxmce.org/index.php/Control_a_TV_or_cable/satellite_box

Automation (lights, climate, irrigation)
http://wiki.linuxmce.org/index.php/Category:Automation
http://wiki.linuxmce.org/index.php/Category:PLCBUS
http://wiki.linuxmce.org/index.php/Category:RF_Control

Security
http://wiki.linuxmce.org/index.php/Category:Security
http://wiki.linuxmce.org/index.php/Category:Cameras
http://wiki.linuxmce.org/index.php/Category:Surveillance_Cameras
http://wiki.linuxmce.org/index.php/Category:Video_Capture_Boards

Telecom
http://wiki.linuxmce.org/index.php/Category:Telecom
http://wiki.linuxmce.org/index.php/Category:IP_Phones

Scenarios/Events
http://wiki.linuxmce.org/index.php/Media_Scenarios

User pages
http://wiki.linuxmce.org/index.php/Category:User_Setups

Wiki Tutorial (Adding and Administering Content)
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 05, 2011, 07:43:01 pm
Twodogs,

thanks.

Create a page for each of the main headings, with a short summary, and describing with a one liner each of the links you provide. THAT summary page will be linked off the sidebar.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 05, 2011, 11:35:06 pm
Below is my recommendation for the Telecom main page. Is this on track?

Quote
Telecom (need sidebar link)
LinuxMCE uses Asterisk software to provide very powerful and flexible telephone integration. Examples:
- Get a VOIP phone line provider and an IP Phone (the Cisco 7970 even doubles as an orbiter).
- Get a VOIP phone line provider and Analog Telephone Adapter (ATA) to use a standard phone.
- Use an ATA with a regular telephone line.

Phone Lines
Connecting to VOIP/SIP providers.
Link - http://wiki.linuxmce.org/index.php/Category:Phone_Lines

Analog Telephone Adapters
Hardware devices that enable standard telephones to interface with LinuxMCE and VOIP phone lines.
Link - need new wiki category

IP Phones

Telephones that connect directly to the LAN.
Link - http://wiki.linuxmce.org/index.php/Category:IP_Phones

Telecom Tutorials

Wonderful tips and tricks for telecom usage.
Link - need new wiki category
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 06, 2011, 01:21:56 am
Looks good to me.
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 06, 2011, 08:05:07 pm
twodogs,

create the telecom page you've outlined and I will add it to the favourites subsection I added to the sidebar.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 08, 2011, 01:51:18 pm
Here are a few more for the sidebar.

http://wiki.linuxmce.org/index.php/Core_Hybrid
http://wiki.linuxmce.org/index.php/Media_Directors
http://wiki.linuxmce.org/index.php/Orbiters_and_Remotes
http://wiki.linuxmce.org/index.php/Networks
http://wiki.linuxmce.org/index.php/Media
http://wiki.linuxmce.org/index.php/Automation
http://wiki.linuxmce.org/index.php/Home_Security
http://wiki.linuxmce.org/index.php/Telecom
http://wiki.linuxmce.org/index.php/Category:User_Setups
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 08, 2011, 06:43:42 pm
done
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 08, 2011, 07:58:01 pm
Awesome.

Two tasks now loom:
1. Sort the articles in "Hardware" and "Tutorials" and link them to the new pages.
2. Delete "dead" categories and obsolete pages.

We should probably be pretty brutal about item 2 - the more categories we have, the greater the chance that users will misfile articles. I'd even recommend emptying the "hardware" and "tutorials" categories by moving all the articles to our new wiki structure. The size and alphabetical organization of these categories makes them almost useless, IMO. For example, I have been looking for many moons for info on "text to speech". I finally found it right there under "M" for "Make Announcements". Our new structure will permit us to tag hardware and tutorials by function, rather than by name. 

The conservative approach would be to first tag the articles for the new wiki categories, then to make sure everyone is happy, then to delete them from the hardware and tutorials categories. The problem with this approach is that it will be a major PITA to open each of the hundred of articles and tag them, then to go back and reopen the same articles and remove the links to hardware and tutorials categories. Thoughts?
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 08, 2011, 08:01:18 pm
I am a gatherer. I much prefer to KEEP tags that we have, and add to them instead of removing existing tags and replace them with something else. The more links one has the better it is imho.
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 08, 2011, 08:07:16 pm
Then I'll just add the new tags and keep the old ones. Since I'll be looking at every wiki article ever written, what should I do if I find one that contains no content or is terminally outdated or stupid?
Title: Re: Wikiworkgroup | Main topic
Post by: twodogs on November 09, 2011, 10:32:51 pm
You missed adding "networks" to the favourites sidebar
Title: Re: Wikiworkgroup | Main topic
Post by: posde on November 09, 2011, 10:52:08 pm
fixed
Title: Re: Wikiworkgroup | Main topic
Post by: purps on December 16, 2011, 02:41:52 pm
Apologies for the radio silence, busy with being evicted, and trying organise moving into our new home before we are on the streets *headdesk*

I like the new wiki front page, much simpler. However what do we think about putting in some more links to the installation instructions? I realise it is marked as a favourite on the side bar, but this is only for 810.

Cheers,
Matt.
Title: Re: Wikiworkgroup | Main topic
Post by: bongowongo on December 16, 2011, 03:13:03 pm
No problem, sounds very serious, being evicted........

Maybe in the top box about the status of 0810 and 1004 we can make a clickable link going to the 0810 version installation wiki or the 1004 installation wiki?
Title: Re: Wikiworkgroup | Main topic
Post by: mcefan on October 01, 2012, 06:30:48 am
I am not sure it is easily possible to have the sub-headings displayed dynamically.
It's possible. There's an extension for that. You can drill down right from the menu. It's dynamically built from the existing categories. The categories ARE the structural components of the wiki.
It does not have to be in the sidebar, it can be a separate page. Very necessary though, I would not have a wiki without it. It's easier to dynamically drill than navigate by opening several pages. It's also faster, and more comprehensive.


I am a gatherer. I much prefer to KEEP tags that we have, and add to them instead of removing existing tags and replace them with something else. The more links one has the better it is imho.
The problem with this is that the categories are the structure, so, we HAVE to recategorize as suggested http://forum.linuxmce.org/index.php/topic,11909.msg85208.html#msg85208

However, the categorization has to be exhaustive for each article. Each article must be tagged with all relevant categories.


Lets pretend that I insisted that the Homerun should go under TV, and you insisted that it appear under NAS We could put it in both places, just as current wiki articles can be set up to appear in "tutorials" and "hardware". But I suggest we avoid duplication if possible. ... If we have a 3-level structure, and if the index is always present at the left of the screen, then it is almost impossible to get lost.

There is a reason why shopping sites keep track of what you click on and make suggestions on what you should look at next, or what other people did following what you just did: thinking flows by association.
An article should be in as may categories at necessary.

If I just completed my install, it's just natural for me to wonder "what else" I should install before leaving the installation phase.