Showing changes from revision #7 to #8:
Added | Removed | Changed
Here This are is (1) a copy of Acorn’s originalAcorn’s RISC OS 3.70 User Guide RISC OS 3.70 User Guide exported as aPDF that should be sufficient for people to start looking at what edits need to be made, made. and (2) the latest working version ofROOL’s RISC OS 5 User Guide.
The firstPDF 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 userguide@riscosopen.org. 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.
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 userguide@riscosopen.org address and include information about where they should appear in the User Guide. Toolsprites and iconsprites must be used as specified below in order for the whole manual to be consistent and for there to be consistency across the whole range of RISC OS books the ROOL publish. It is likely that most screenshots will need to be touched to some degree for that reason alone.
You must use the Sovereign as the desktop theme, Homerton 12 point as the desktop font and disable the Wimp’s background tiling for all screenshots because:
a) the icons are bold/iconic and when printed greyscale they can still be distinguished with good contrast
b) neutral window furniture prints well in greyscale
c) flat backgrounds to windows are preferable when printing
Images to should ensure be the supplied icons are still visible and print well in colour greyscale.PNG format and have no bleed area around them. Where menu trees are open the void space is solid white, not transparent.
Images should be supplied in 24bpp colour PNG format and 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.