Talk:LinuxMCE.Org 2.0

From LinuxMCE
Revision as of 02:53, 18 March 2009 by Seer (Talk | contribs) (New section: Is this stale info?)

Jump to: navigation, search

There are many problems with the site.

1) It has been written in terrible English -- misspelled words abound and proper grammar is nearly non-existent. For example, "survailance" should be "surveillance". (A simple dictionary goes a long way.)

2) Only a small portion of the program is actually documented.

3) The changes in the program are not documented and "legacy" instructions are left on the page.

4) There is a lot of "fluff" in the documentation that is meaningless. You can't write "the program can do this and this and this!!!" when only one person has ever been able to do it. Hyperbole misleads the users.

Still, the Wiki is evolving in the right direction, slowly.

If the intent is to correct the main page, then you should get some help from the contributors to the Wiki.

I worked documenting code for an American defense contractor -- the problems with LinuxMCE documentation are not unique. Most programmers are terrible at documentation.

If you want good documentation, you must have a dedicated documenter and one programmer to whom the documenter can ask questions.

Why not just use the Wiki?

Why not just use the Wiki?

It is better written and has the benefit of many user input anyway.

Menu listing...

One VERY important part of the Linux MCE (or any system really) is the Hardware Compability List (HCL)

This should have its own Menyitem on the Front page.

Is this stale info?

I noticed that this page hasn't been edited in over 6 months. Is anybody on this? Is the current linuxmce.org site the "2.0" version? I personally would love to add some code to mix, but right now I'm playing catch up, so I thought I'd help out with the wiki. I'd ready to write new copy for the home page. I'd also be into writing the "sales pitch" and "What is LinuxMCE" docs for the non-techie. So who has write access to that page? Who is in the "design committee" (the people that would have to say "yes" to any new design changes)? Seer 02:53, 18 March 2009 (CET)