LinuxMCE Forums
General => Developers => Wiki => Topic started 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
-
Worth a read I reckon http://www.mythtv.org/wiki/MythTV:Manual_of_Style
-
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
-
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.
-
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
-
Let's move the frontpage discussion to the proper task forum topic.
http://forum.linuxmce.org/index.php/topic,11905.0.html
-
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
-
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.
-
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 ;)
-
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
-
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?
- Maybe it's best to assign some persons who reads/controls the articles?
I'm active in a non-profit association, and there we've got 5 people who read our articles on language, structure...
Since English isn't my native language, i know some thing can be written better. :-X
- And maybe some guys who follow up the layout?
Not the structure, but keep the same titles, style of graphs...
ps My personal documentation of linuxmce: http://www.oniria.be/pri/index.php/linux/233-linuxmce
-
Bongowongo, have you had any luck reading up on the MediaWiki stuff?
-
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 :)
-
OK cool :)
-
I put some more substance in the following page
http://wiki.linuxmce.org/index.php/Wikiworkgroup
-
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.
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).
-
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
- get a good template to work with, and to be honest I suck at templates.
If the template is there we have a good and easy basis for the gruntwork. This needs research - Redesigning the front page, because the frontpage is non standard so it doesn't depend heavily on a template, it can be done now.
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.
-
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.
-
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
-
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.
-
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?
-
I can start trying to establish a new wiki structure if I can get set up with a wiki administrator password.
-
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?
-
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
-
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.
-
I'm Twodogs in the wiki, yes. And I'm logged into the IRC channel.
-
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/)
-
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.
-
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.
-
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?
-
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)
-
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.
-
Below is my recommendation for the Telecom main page. Is this on track?
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
-
Looks good to me.
-
twodogs,
create the telecom page you've outlined and I will add it to the favourites subsection I added to the sidebar.
-
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
-
done
-
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?
-
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.
-
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?
-
You missed adding "networks" to the favourites sidebar
-
fixed
-
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.
-
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?
-
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.