| T.R | Title | User | Personal
Name | Date | Lines |
|---|
| 220.1 | Not required | REORG::SEARLE | | Tue Nov 07 1989 19:43 | 10 |
| We asked whether our project (Rdb/VMS) was required to put our 'quick
reference guide' online to qualify as a complete doc set. The answer
was no, not if the same information is available elsewhere in the
doc set.
So, pocket guides are not required. There's no separate doctype for
pocket guides that I know of. Wha happens when you run the sources for
your pocket reference through the ONLINE doctype?
Kirk
|
| 220.2 | you can still do it if it's not required | AITG::WARNER | It's only work if they make you do it | Wed Nov 08 1989 13:15 | 27 |
| While you can't put a workstation in your pocket, it might be nice to have a
quick guide that you could iconify and leave hanging around in your icon box.
Definitely should change the name to something like Quick Reference, though.
What happens when you run your sources through the ONLINE doctype? Try it!!!
You'll probably have to add some symbolic names.
Another alternative: create a RAGS metafile that contains all the pocket
information in one screen, and make it a formal figure. Then you could have all
the information visible at one time without scrolling (if you can display it
all without making the print too tiny).
You could have a DECW$BOOK like this:
________________________________________
<HEAD1>(Quick Reference Guide\q_ref)
<P>>REFERENCE>(cheat_sheet) provides a quick reference to (?). You can iconify
this figure and keep it in your icon box for help with (?).
<FIGURE>(Quick Reference Guide\cheat_sheet)
<FIGURE_FILE>(bookreader\xxxxx.DECW$BOOKFIG\xx)
<X>(Reference guide (figure))
<ENDFIGURE>
|
| 220.3 | easy job | AITG::WARNER | It's only work if they make you do it | Wed Nov 08 1989 19:23 | 13 |
|
I put our pocket guide online this afternoon -- it took about 45 minutes.
I had to add a title page and copyright page, and <LMF> tags.
I changed each formal table to an informal table, and added a <HEAD1> before
each table. This way, the TOC lists all the tables although they aren't formal
tables, and there are no hotspots to click on; it's all there on the screen.
I think it was a good idea to add the guide to the Bookreader documentation. I
loaned someone my pocket guide and never got it back. 8^)
Ross
|