General > Wiki
New LinuxMCE Documentation
JaseP:
I agree with Posde. Deleting an article may remove useful information, however obscure. Marking them as obsolete is better.
A similar thing happened to the MythTV wiki some time ago. Out of date information was removed. Basically, that eliminated the only available documentation on a small handful of hardware pieces,... available anywhere. Once that kind of information is lost, it's pretty much lost for good... as in Library of Alexandria lost...
As far as I've seen, the Wiki has a variety of "skins" that can be applied, from the basic default, to different layout and color schemes. So, it seems like some "theme" work has already been done. And, most people expect a wiki to look/work much like Wikipedia, by default at least. So, that kind of thing doesn't seem, to me at least, to be too big a priority.
I think the key is better indexing/organization, followed by edits for readability/simplicity and organization within the articles. Among the things that need more clarity for new users from the outset are; Networking structure & how-to, Basic system architecture (how the various software pieces fit together), Simple step-by-step tutorials for the most basic functionality, and a possibly a table for hardware compatibility (with links to the relevant articles and how-tos). It might be helpful to grade articles in terms of technical level (something like; basic, intermediate, advanced, expert & developer).
Before I started working on something else, I did a few very basic edits (some basic readability/updating, and starting a glossary page). I can do some things in a spare moment, or two, as well. My plate is pretty full, but wiki editing is/can be kind of a mind clearing diversion...
mcefan:
So far, I gather that these need to be addressed:
* updates
* removal of obsolete articles
* editing for readability/simplicity
* new users centered additions (such as Networking structure & how-to, Basic system architecture, Simple step-by-step tutorials for the most basic functionalities)
* technical level centered organization (basic, intermediate, advanced, expert & developer)
* categorization, indexing/organization
* a table of hardware compatibility connecting to corresponding linked articles
* consistent favorites navigation
* uniformity, standardization of articles
I will keep updating this list (probably on the wiki - it's more appropriate - check my user page http://wiki.linuxmce.org/index.php/User:Mcefan).
Please give the reasoning behind your suggestions so that everyone understands the issue.
If you would like to help in any of the above, please specify it.
Thank you.
mcefan:
I updated "Contributing to LMCE" to reflect the ongoing discussion.
mcefan:
To resolve the archival of old articles, we can simply move them to another namespace called "old articles".
I posted a page about it in the help namespace: http://wiki.linuxmce.org/index.php/Help:Namespace
There is enough information on that page for everyone.
mcefan:
There is an old 2010 proposal called "LinuxMCE.Org 2.0" here: http://wiki.linuxmce.org/index.php/LinuxMCE.Org_2.0
Suggestions are:
Purpose
The purpose of the new site is to provide a friendly, approachable face for LinuxMCE to new users. It must:
- Provide links to understandable descriptions of the software
- Present a user-friendly image of the site
- Present a pleasing aesthetic to augment the above two requirements
- Provide project news that affects users
- Provide a way to easily download the software
- Provide entry to the Forums
- Provide entry to the Wiki for detailed documentation
Menu Structure (and links to the copy pages)
- News
- About
- Documentation
- Forum
- Download
- Contact Us
Proposed Color Scheme
- Text: #000000
- Highlight: #123456
I integrated it to the list on my user page.
Navigation
[0] Message Index
[#] Next page
[*] Previous page
Go to full version