Rockbox General > Rockbox General Discussion
Releases and website behaviour...
GodEater:
--- Quote from: Llorean on July 07, 2008, 12:26:27 PM ---Many softwares have a separate install guide.
--- End quote ---
Is there anything stopping us turning the Installation chapter in the manual into a seperate guide we could offer as well?
I'd still leave that section in the normal manual too - but it might be nice to have a "quick start" method for people ?
--- Quote from: Zardoz on July 07, 2008, 01:19:18 PM ---I'm not a developer needless to remark (in fact I might be Lloreans nemesis.) I'm more than willing to contribute to a reworking of the manual (I've spotted many grammatical and spelling mistakes, and I think I could be clearer in more basic English.
--- End quote ---
Start submitting patches then.
bluebrother:
--- Quote from: GodEater on July 07, 2008, 01:19:54 PM ---
--- Quote from: Llorean on July 07, 2008, 12:26:27 PM ---Many softwares have a separate install guide.
--- End quote ---
Is there anything stopping us turning the Installation chapter in the manual into a seperate guide we could offer as well?
I'd still leave that section in the normal manual too - but it might be nice to have a "quick start" method for people ?
--- End quote ---
In that case we should rework the current installation section first. Setting up a new build rule that builds only a segment of the manual (maybe create a new front page for that and leave out everything else but the installation section?) should be fairly easy then.
shotofadds:
--- Quote from: Llorean on July 07, 2008, 12:26:27 PM ---RBUtil is pretty prominent: If they read the manual, they find it. If we make it any more prominent, they'd find it before the manual, which is not ideal. The current method funnels them from "Front Page -> Manual -> RBUtil" which I think is the ideal order of events.
--- End quote ---
..which is fine, except the current front page text doesn't explicitly ferry people anywhere at all. I think an equally likely scenario (if not more so) is "Front Page -> Releases -> "oh..." -> Current Build -> Click the pretty picture of my player -> "oh.. what do I do with this .zip?"
If we expect people to read the manual first, we should at least say clearly "We'd really appreciate it if you read the manual before doing anything, thanks".
Llorean:
I find myself wondering, then, what you thought of these sentences from the same post:
--- Quote ---The only thing missing, I think, is an "installation" link in the documentation section that simply leads to a page saying "All installation instructions can be found in the manual, linked to in the bar on the left." People look for "installation" before they look for "manual" often enough just because usually a manual tells how to use something, not always how to install it. Many softwares have a separate install guide.
--- End quote ---
Note the use of the word "missing" suggesting I think that it is in fact a flaw that it isn't there...
shotofadds:
Of course, but I was trying to say that the link needs to be somewhere way more obvious than "in the documentation section".
Navigation
[0] Message Index
[#] Next page
[*] Previous page
Go to full version