Talk:LinuxMCE.Org 2.0

From LinuxMCE
Revision as of 01:33, 16 June 2008 by Perspectoff (Talk | contribs)

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.