Spacebar Doesn't Always Create a Space
I'm enjoying a spiffy, new FM 9 template created for my group. It's great except for one quirk: The spacebar doesn't always create a space. Across all paragraph tags, hitting the spacebar does not create a space in the text at the cursor. If I place the cursor at the end of a word, and hit the spacebar, I'm simply moved to the next word but a space has not been created. If I place the cursor in the middle of a word and hit the spacebar, one space is created (creating two words), but additional taps on the spacebar do nothing. However, if I open a new FM document without importing the character tags from the new template, my spacebar works as it should within the default paragraph tags. Does anyone have any ideas? -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20110801/40bd068e/attachment.html>
warnings, cautions, notes in sw documentation
Hi hessiansx4, Here is how we define them in our doc: . Warning mention (+ pictogram): WARNING indicates a potentially hazardous situation which, if not avoided, can result in death or serious injury. . Caution mention (+ picto): CAUTION indicates a potentially hazardous situation which, if not avoided, can result in minor or moderate injury. . Caution mention (without picto): CAUTION, used without the safety alert symbol, indicates a potentially hazardous situation which, if not avoided, can result in equipment damage. We talk about "equipment damage" because our soft is used for remote equipment control. Mathieu. > Date: Sun, 31 Jul 2011 20:42:37 -0700 > From: hessiansx4 at yahoo.com > Subject: warnings, cautions, notes in sw documentation > To: framers at lists.frameusers.com > > Hello all! I've noticed that the legacy docs I'm currently working on use > notes and warnings (no cautions) for a software product. I asked why a > warning was used instead of a caution and was told: that's the way we do it > here. I've only used warnings when bodily harm could result from some action. > How are those of y'all in the sw world doing it? > ___ > > > You are currently subscribed to framers as bobitch at hotmail.com. > > Send list messages to framers at lists.frameusers.com. > > To unsubscribe send a blank email to > framers-unsubscribe at lists.frameusers.com > or visit > http://lists.frameusers.com/mailman/options/framers/bobitch%40hotmail.com > > Send administrative questions to listadmin at frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20110801/45e02c2a/attachment.html>
warnings, cautions, notes in sw documentation
Hi, The general convention (which is based on an ISO standard whose number I can't recall offhand) is that a "Warning" indicates the danger of death or injury to people; a "Caution" indicates some lesser risk, such as a loss of data; and a "Note" indicates some additional parenthetical or interesting information. Many companies don't see the need to apply any external standards to their software documentation so, in the real world, "that's the way we do it here" trumps all other standards, ISO or otherwise. David On 1 August 2011 04:42, hessiansx4 wrote: > Hello all! I've noticed that the legacy docs I'm currently working on use > notes and warnings (no cautions) for a software product. I asked why a > warning was used instead of a caution and was told: that's the way we do it > here. I've only used warnings when bodily harm could result from some > action. How are those of y'all in the sw world doing it? > ___ > > > You are currently subscribed to framers as dfarbey at yahoo.co.uk. > > Send list messages to framers at lists.frameusers.com. > > To unsubscribe send a blank email to > framers-unsubscribe at lists.frameusers.com > or visit > http://lists.frameusers.com/mailman/options/framers/dfarbey%40yahoo.co.uk > > Send administrative questions to listadmin at frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. > -- David Farbey - david at farbey.co.uk Mobile 07879 005 946 Web site/Blog <http://www.farbey.co.uk> Twitter <http://twitter.com/dfarb> LinkedIn <http://www.linkedin.com/in/informationdesign> -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20110801/d09ec361/attachment.html>
warnings, cautions, notes in sw documentation
The definition of Danger, Warning, Caution is defined by several organizations. I typically follow the ANSI Z535 standard. ANSI 35 and 53 are referenced by OSHA. However, OSHA hasn't updated their references to reflect the fact that ANSI combined these 2 standards into Z535 many years ago. Mathieu has the Danger and Warning definitions correct. They currently discourage the use of Caution for equipment damage although it is still acceptable. There's a new version being published next month that I suspect will eliminate Caution as an acceptable term for equipment damage. David also mentioned a mil spec that defines the terms and I know that ISO also has standards possible injury, although they don't reference the different levels of injury. With the attempted harmonization between ISO and ANSI, this may be additional changes in the forthcoming update. So you need to know the standards that your industry (and country) reference and apply those standards to your documents. It is also good practice (required?) that you state those definitions in your document. Brian David Spreadbury Sent by: framers-bounces at lists.frameusers.com 08/01/2011 08:28 AM To hessiansx4 at yahoo.com, framers at lists.frameusers.com, mathieu jacquet cc Subject RE: warnings, cautions, notes in sw documentation The use of Warnings, Cautions, and Notes, specifically Warnings and Cautions, are used differently in different technologies. Here are some links that may hep you to decide which use best fits your needs: http://www.techcommunicators.com/dkmanual/chap5015.html http://www.techcommunicators.com/emanuals/wrm/chap06/06-13_notes.htm http://www.stc-soc.org/quill/2004-05/warnings.html http://www.tpub.com/content/tentsshelters/TB-9-2320-360-13-P-2/TB-9-2320-360-13-P-20234.htm http://www.techwr-l.com/archives/0403/techwhirl-0403-00541.html http://goodtools.net/pages/SUNstyle/constr8.htm http://support.dell.com/support/edocs/systems/op990/en/SM/SFF/GUID-EA258A9C-D5EA-43BE-9A44-E8B52A0E594F.html And MIL-STD-38784C states: WARNINGS : Highlights an essential operating or maintenance procedure, practice, condition, statement, etc, which, if not strictly observed, could result in injury to, or death of, personnel or long term health hazards. CAUTIONS: Highlights an essential operating or maintenance procedure, practice, condition, statement, etc, which, if not strictly observed, could result in damage to, or destruction of, equipment or loss of mission effectiveness. NOTE: Highlights an essential operating or maintenance procedure, condition, or statement. Another thing that most people don't adhere to is that WARNINGS should come before CAUTIONS, which should come before NOTES, when any two, or all three, may apply to the following paragraph or section. --- On Mon, 8/1/11, mathieu jacquet wrote: From: mathieu jacquet Subject: RE: warnings, cautions, notes in sw documentation To: hessiansx4 at yahoo.com, framers at lists.frameusers.com Date: Monday, August 1, 2011, 5:33 AM Hi hessiansx4, Here is how we define them in our doc: . Warning mention (+ pictogram): WARNING indicates a potentially hazardous situation which, if not avoided, can result in death or serious injury. . Caution mention (+ picto): CAUTION indicates a potentially hazardous situation which, if not avoided, can result in minor or moderate injury. . Caution mention (without picto): CAUTION, used without the safety alert symbol, indicates a potentially hazardous situation which, if not avoided, can result in equipment damage. We talk about "equipment damage" because our soft is used for remote equipment control. Mathieu. > Date: Sun, 31 Jul 2011 20:42:37 -0700 > From: hessiansx4 at yahoo.com > Subject: warnings, cautions, notes in sw documentation > To: framers at lists.frameusers.com > > Hello all! I've noticed that the legacy docs I'm currently working on use notes and warnings (no cautions) for a software product. I asked why a warning was used instead of a caution and was told: that's the way we do it here. I've only used warnings when bodily harm could result from some action. How are those of y'all in the sw world doing it? ___ You are currently subscribed to framers as bemrich at phoenixcon.com. Send list messages to framers at lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscribe at lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/bemrich%40phoenixcon.com Send administrative questions to listadmin at frameusers.com. Visit http://www.frameusers.com/ for more resources and info. -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20110801/41d0e3a0/attachment.html>
thanks for your assistance on Warnings, Cautions, Notes - this list rocks!
RE: warnings, cautions, notes in sw documentation
The use of Warnings, Cautions, and Notes, specifically Warnings and Cautions, are used differently in different technologies. Here are some links that may hep you to decide which use best fits your needs: http://www.techcommunicators.com/dkmanual/chap5015.html http://www.techcommunicators.com/emanuals/wrm/chap06/06-13_notes.htm http://www.stc-soc.org/quill/2004-05/warnings.html http://www.tpub.com/content/tentsshelters/TB-9-2320-360-13-P-2/TB-9-2320-360-13-P-20234.htm http://www.techwr-l.com/archives/0403/techwhirl-0403-00541.html http://goodtools.net/pages/SUNstyle/constr8.htm http://support.dell.com/support/edocs/systems/op990/en/SM/SFF/GUID-EA258A9C-D5EA-43BE-9A44-E8B52A0E594F.html And MIL-STD-38784C states: WARNINGS : Highlights an essential operating or maintenance procedure, practice, condition, statement, etc, which, if not strictly observed, could result in injury to, or death of, personnel or long term health hazards. CAUTIONS: Highlights an essential operating or maintenance procedure, practice, condition, statement, etc, which, if not strictly observed, could result in damage to, or destruction of, equipment or loss of mission effectiveness. NOTE: Highlights an essential operating or maintenance procedure, condition, or statement. Another thing that most people don't adhere to is that WARNINGS should come before CAUTIONS, which should come before NOTES, when any two, or all three, may apply to the following paragraph or section. --- On Mon, 8/1/11, mathieu jacquet wrote: From: mathieu jacquet Subject: RE: warnings, cautions, notes in sw documentation To: hessian...@yahoo.com, framers@lists.frameusers.com Date: Monday, August 1, 2011, 5:33 AM Hi hessiansx4, Here is how we define them in our doc: . Warning mention (+ pictogram): WARNING indicates a potentially hazardous situation which, if not avoided, can result in death or serious injury. . Caution mention (+ picto): CAUTION indicates a potentially hazardous situation which, if not avoided, can result in minor or moderate injury. . Caution mention (without picto): CAUTION, used without the safety alert symbol, indicates a potentially hazardous situation which, if not avoided, can result in equipment damage. We talk about "equipment damage" because our soft is used for remote equipment control. Mathieu. > Date: Sun, 31 Jul 2011 20:42:37 -0700 > From: hessian...@yahoo.com > Subject: warnings, cautions, notes in sw documentation > To: framers@lists.frameusers.com > > Hello all! I've noticed that the legacy docs I'm currently working on use > notes and warnings (no cautions) for a software product. I asked why a > warning was used instead of a caution and was told: that's the way we do it > here. I've only used warnings when bodily harm could result from some action. > How are those of y'all in the sw world doing it? ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
warnings, cautions, notes in sw documentation
The use of Warnings, Cautions, and Notes, specifically Warnings and Cautions, are used differently in different technologies. Here are some links that may hep you to decide which use best fits your needs: http://www.techcommunicators.com/dkmanual/chap5015.html http://www.techcommunicators.com/emanuals/wrm/chap06/06-13_notes.htm http://www.stc-soc.org/quill/2004-05/warnings.html http://www.tpub.com/content/tentsshelters/TB-9-2320-360-13-P-2/TB-9-2320-360-13-P-20234.htm http://www.techwr-l.com/archives/0403/techwhirl-0403-00541.html http://goodtools.net/pages/SUNstyle/constr8.htm http://support.dell.com/support/edocs/systems/op990/en/SM/SFF/GUID-EA258A9C-D5EA-43BE-9A44-E8B52A0E594F.html And MIL-STD-38784C states: WARNINGS : Highlights an essential operating or maintenance procedure, practice, condition, statement, etc, which, if not strictly observed, could result in injury to, or death of, personnel or long term health hazards. CAUTIONS: Highlights an essential operating or maintenance procedure, practice, condition, statement, etc, which, if not strictly observed, could result in damage to, or destruction of, equipment or loss of mission effectiveness. NOTE: Highlights an essential operating or maintenance procedure, condition, or statement. Another thing that most people don't adhere to is that WARNINGS should come before CAUTIONS, which should come before NOTES, when any two, or all three, may apply to the following paragraph or section. --- On Mon, 8/1/11, mathieu jacquet wrote: From: mathieu jacquet Subject: RE: warnings, cautions, notes in sw documentation To: hessiansx4 at yahoo.com, framers at lists.frameusers.com Date: Monday, August 1, 2011, 5:33 AM Hi hessiansx4, Here is how we define them in our doc: . Warning mention (+ pictogram): WARNING indicates a potentially hazardous situation which, if not avoided, can result in death or serious injury. . Caution mention (+ picto): CAUTION indicates a potentially hazardous situation which, if not avoided, can result in minor or moderate injury. . Caution mention (without picto): CAUTION, used without the safety alert symbol, indicates a potentially hazardous situation which, if not avoided, can result in equipment damage. We talk about "equipment damage" because our soft is used for remote equipment control. Mathieu. > Date: Sun, 31 Jul 2011 20:42:37 -0700 > From: hessiansx4 at yahoo.com > Subject: warnings, cautions, notes in sw documentation > To: framers at lists.frameusers.com > > Hello all! I've noticed that the legacy docs I'm currently working on use > notes and warnings (no cautions) for a software product. I asked why a > warning was used instead of a caution and was told: that's the way we do it > here. I've only used warnings when bodily harm could result from some action. > How are those of y'all in the sw world doing it? -- next part -- An HTML attachment was scrubbed... URL: <http://lists.frameusers.com/pipermail/framers/attachments/20110801/793af516/attachment.html>
RE: warnings, cautions, notes in sw documentation
Hi hessiansx4, Here is how we define them in our doc: . Warning mention (+ pictogram): WARNING indicates a potentially hazardous situation which, if not avoided, can result in death or serious injury. . Caution mention (+ picto): CAUTION indicates a potentially hazardous situation which, if not avoided, can result in minor or moderate injury. . Caution mention (without picto): CAUTION, used without the safety alert symbol, indicates a potentially hazardous situation which, if not avoided, can result in equipment damage. We talk about "equipment damage" because our soft is used for remote equipment control. Mathieu. > Date: Sun, 31 Jul 2011 20:42:37 -0700 > From: hessian...@yahoo.com > Subject: warnings, cautions, notes in sw documentation > To: framers@lists.frameusers.com > > Hello all! I've noticed that the legacy docs I'm currently working on use > notes and warnings (no cautions) for a software product. I asked why a > warning was used instead of a caution and was told: that's the way we do it > here. I've only used warnings when bodily harm could result from some action. > How are those of y'all in the sw world doing it? > ___ > > > You are currently subscribed to framers as bobi...@hotmail.com. > > Send list messages to framers@lists.frameusers.com. > > To unsubscribe send a blank email to > framers-unsubscr...@lists.frameusers.com > or visit > http://lists.frameusers.com/mailman/options/framers/bobitch%40hotmail.com > > Send administrative questions to listad...@frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. ___ You are currently subscribed to framers as arch...@mail-archive.com. Send list messages to framers@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.