From this page you can download a PDF version of the working copy of the User Guide. It is based on Acorn’s original RISC OS 3.70 User Guide exported as a PDF that should be sufficient for people to start looking at what edits need to be made.
The PDF was generated from RISC OS Open’s master FrameMaker document, which was copied straight off a DO (the Acorn Drawing Office) backup CD. There only seemed to be one issue number in there so is presumed to be the latest. As far as we can tell, Acorn didn’t print the 3.70 User Guide on paper, it was only ever released as HTML (likely exported from FrameMaker).
We have uploaded the Acorn document to allow the community to assist RISC OS Open with the work involved in updating this (rather large!) document to address everything that has changed in RISC OS 5, which is almost twenty years of development. From time to time, ROOL will update the working version of the RISC OS 5 User Guide, as updates are folded into the master document.
This is our suggested plan of attack for bringing the User Guide fully up to date:
Our strong suggestion here is that the community would be most valuable contributing to items 4, 5, 6 and 14 of the above. Please send submissions to email@example.com. If anyone wishes to be added to the userguide@ email address, so they too get a copy of emails sent to that address, let us know – via an email to that address. There is also a forum thread for general discussion of this work.
Please read and adhere to the Tech Pubs Style Guide – for example, the text needs to use the correct tense, with no Americanizations, and you certainly don’t want no double negatives. You may suggest further subediting standards not covered in that guide by adding to the page User Guide style conventions. The Editor may leave suggestions in clear or, if not agreed with, struck through.
Each new or updated chapter should be created as a child of this wiki page to allow community updates. Discussion relating to updates can be held on the forum thread.
Please avoid putting too much work into the formatting of the wiki pages; ROOL will need to redo all of this when the work is folded into the master document so anything more than a gentle hint in the wiki pages will just create more work for ROOL (unformatting it all first).
Email any updated/new images to the firstname.lastname@example.org address and include information about where they should appear in the User Guide. As the icon set has changed since the RISC OS 3 User Guide it is likely that most screenshots will need to be touched to some degree.
Before capturing screenshots you must
These settings must be used for the whole manual to be consistent and for there to be consistency across the whole range of RISC OS books that ROOL publish. They are chosen so the icons are easily visible and print well in greyscale.
Images should be supplied in 24bpp colour PNG format with have no bleed area around them. Where menu trees are open the void space is solid white, not transparent.
Once an updated image is submitted to ROOL, please mark the relevant location(s) in the wiki document as “updated” so other community members know not to generate/update the same images.
The page User Guide update submissions provides a growing list of topics that correspond either to existing Chapters or to newly required Chapters which are the subject of volunteers’ updates.
User Guide small corrections is a page on which contributors can log small editing errors (e.g. spelling and punctuation) that they have spotted in the current draft User Guide. Please report potential corrections under the date of the User Guide version you are reading, together with the sequential page number (of the PDF), the ‘printed’ page number, and some immediate context (rather than a line number).