From Rokymotion Wiki
note to myself: read http://www.wikipatterns.com/display/wikipatterns/Wikipatterns
Contents |
todo
- clean up structure
- put all articles into their categories
- delete really outdated stuff and things we don't need anymore
- new content
- create beautiful looking category pages or handmade overview pages for the main areas
- create missing content
- update outdated articles
- last step: modify start page to show the new structure and link to our overview pages
new contents
- Known Problems: like the xine 1.1.3 and amarok 1.4.4 and last.fm thing
- tutorial for real newbies
- move some trivial faq questions to it
- nice screenshots
- quotes from users about amarok (mainly from the mailing list), saying how great it is
cleanup
translations
- translations are outdated
- need to update english articles before translations
- wiki translation team?
Proposal for FAQ/Wiki restructurization
We're not yet sure which of those two :)
I'm for the first one -- hurra
ABOUT +What is Amarok +Brief description of Amarok's (best) features +Getting involved (development, promotion and artists, mostly just links) INSTALLATION +Different ways of installation +Distro-specific information (ev. Win & Mac) +Restricted formats FEATURES //List of articles about Amarok's features. They would tend to me more general, with more specific info inside. //Some examples: +Engines unmasked +All about Database Collection +Score and rating. +Music labeling. +Music formats playable by Amarok (digital and analog, \audiocd\) +DCOP +Streamed music +Remote collection, how to play music from other's PCs? (samba,nfs,/*daap?*/) / Collection sharing! +Amarok on the party - how to keep it simple, safe and stable. +Amarok's tricks - everybody's favorite (not so) hidden feature +Remote Amarok - various methods of controlling Amarok remotely (remote, bluetooth, telnet...) +LiveCD +Playlists +Make your Amarok prettier - all about appereance +Last.fm +CD burning +MEdia devices +More with less - scripts +Afraid to shoot strangers - Amarok and no KDE +Visualizations //You got the point... DEVELOPMENT +Getting involved in development (more detailed than one in ABOUT) +ISV information :) (scripts and themes) +Amarok "internal information" (APIs and that stuff) GETTING HELP +Sources of help (distro ml, amarok ml, forums...) +Known issues +All about backtraces COMMUNITY //Hell, lets just list it here //Or cut it out :D GETTING STARTED/HOT TOPICS //Probably should be on top of the page. //Resolution of the 5-10 most asked questions/problems //Most wanted information //Something like sticky threads on the forum. +Installation (simple english :)) +MP3 playback +something else...
Take two
Legend:
+ sub-category (or link, as you wish)
// text or comment
ABOUT //Some text about amarok +Features //Brief description of Amarok's (best) features +Getting involved INSTALLATION //Short introduction. Quick links to downloads page +All Amarok's feaures and their dependencies //aka what do I need for xXx +Downloads page //Where do we put restricted formats info? Under "All Amarok's feaures and their..."? FEATURES //List of categories which will contain articles on the same topic. //Catefories have to be detailed enough so users stop asking themselves "is my problem under GENERAL or PLAYBACK or XINE?" //As soon as one sees category he should know that his problem belongs there. //In random order: +Engines +Database +Score and rating. +Music labeling. +Music formats playable by Amarok // digital and analog, audiocd +DCOP +Streamed music +LiveCD +Playlists +Appearance +Last.fm +CD burning +Media devices +Scripts +Amarok with no KDE +Visualizations //maybe should go under appearance +Best Amarok tips and advices // for everything else //Did I forget something? DEVELOPMENT //I think pure links here would be fine +Getting involved in development (more detailed than one in ABOUT) +ISV information :) (scripts and themes) +Amarok "internal information" (APIs and that stuff) GETTING HELP //Introduction, sources of help +Known issues +All about backtraces COMMUNITY //Hell, lets just list it here //Or cut it out :D GETTING STARTED/HOT TOPICS //Probably should be on top of the page. //Links to hot stuff +MP3 playback +something else...
Wiki restructurization process:
1) Assign categories to all wiki entries
2) Update all content marked as OUTDATED
3) Read the content marked as OLD and decide if it should be deleted
4) Read all other pages and check if categories are assigned correctly. If not, (re)assign them, and update content if necessary.
Link to all wiki pages: [1]
Categories criteria:
- Old - pages which are old and therefore should be removed from wiki
- Outdated - pages which content is outdated, but still valuable. Should be updated and assigned to correct category.
- About - pages about Amarok. Introduction, or some other general information.
- Installation - pages about installation of Amarok, or some its part.
- Features - pages which describe some Amarok's feature
- Development - pages which talk about Amarok development, SVN, scripts or themes
- Community - lists of donors, and other fancy stuff
- Start - pages which content solves some important and frequent question, or is in some other valuable to newcomers
- FAQ - pages with content solves some problems, answers a question, or in some other way suitable for FAQ. Most of INSTALLATION falls into this category.
- RoKymotion - pages with promotional content, mostly announcements
- Idea - feature requests and mockups