com]
Sent: Friday, February 16, 2007 8:48 AM
To: Sean Pollock; russ at weststreetconsulting.com; Randall C. Reed
Cc: framers at lists.frameusers.com
Subject: Outsourcing: Was Reasons to Structure
Out here in Silicon Valley, they tried outsourcing. They found that
using Tech Writers whose first langu
dea.
Sean
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On Behalf
Of Dodd, Frank J
Sent: Friday, February 16, 2007 5:33 PM
To: framers@lists.frameusers.com
Subject: RE: Outsourcing: Was Reasons to Structure
So what exactly is the pay range for a technical writer? I
To be very simplistic, we already do structure, though we do it in a
sloppy, and rules bereft manner. Normally we use visual structuring
of documents. In other words, formatting. Applying very strict rules
to formatting brings us closer to structured data. Until one day we
transfer those rules
To be very simplistic, we already do structure, though we do it in a
sloppy, and rules bereft manner. Normally we use visual structuring
of documents. In other words, formatting. Applying very strict rules
to formatting brings us closer to structured data. Until one day we
transfer those rules
, 2007 8:48 AM
To: Sean Pollock; [EMAIL PROTECTED]; Randall C. Reed
Cc: framers@lists.frameusers.com
Subject: Outsourcing: Was Reasons to Structure
Out here in Silicon Valley, they tried outsourcing. They found that
using Tech Writers whose first language wasn't English was a train
wreck.
16, 2007 8:48 AM
To: Sean Pollock; russ at weststreetconsulting.com; Randall C. Reed
Cc: framers at lists.frameusers.com
Subject: Outsourcing: Was Reasons to Structure
Out here in Silicon Valley, they tried outsourcing. They found that
using Tech Writers whose first language wasn't English
Jeremy H. Griffith wrote:
> Isn't that a tad harsh, Russ? My point, which you appear to have
> missed, is that (as Richard said) semantic markup is good, *and*
> that you can do it in unstructured Frame. Do you deny this fact?
Wholeheartedly. Semantic markup only exists if it is expressed in a
EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On
Behalf Of Sean Pollock
Sent: Thursday, February 15, 2007 8:57 PM
To: [EMAIL PROTECTED]; 'Randall C. Reed'
Cc: framers@lists.frameusers.com
Subject: RE: Reasons to structure: another point of view
I've written documentation in the Detroit area f
l Message-
From: framers-bounces+spolloc1=hotmail@lists.frameusers.com
[mailto:framers-bounces+spolloc1=hotmail.com at lists.frameusers.com] On
Behalf
Of russ at weststreetconsulting.com
Sent: Thursday, February 15, 2007 12:19 PM
To: Randall C. Reed
Cc: framers at lists.frameusers.com
Subject
tmail@lists.frameusers.com
[mailto:framers-bounces+spolloc1=hotmail.com at lists.frameusers.com] On Behalf
Of russ at weststreetconsulting.com
Sent: Thursday, February 15, 2007 12:19 PM
To: Randall C. Reed
Cc: framers at lists.frameusers.com
Subject: RE: Reasons to structure
If you work for a company
PROTECTED] On Behalf
Of [EMAIL PROTECTED]
Sent: Thursday, February 15, 2007 12:19 PM
To: Randall C. Reed
Cc: framers@lists.frameusers.com
Subject: RE: Reasons to structure
If you work for a company that doesn't accept qualified recommendations for
improvement from its staff, you should keep
I'm on the FM-DITA mailing list Art, and was invovled about a year or two
ago when it was just starting out.
I still keep on top of things, but in my last place we switched to AuthorIT
as it meet our needs. My current position already has a structured
FrameMaker setup, so I've missed the chance t
Jeremy H. Griffith wrote:
Isn't that a tad harsh, Russ? My point, which you appear to have
missed, is that (as Richard said) semantic markup is good, *and*
that you can do it in unstructured Frame. Do you deny this fact?
Wholeheartedly. Semantic markup only exists if it is expressed in a wa
"If you work in the tech industry and don't have time to learn, your fate is
sealed."
I know what you are saying, but you are presuming that learning how to use a
technology is more important than learning whether or not that technology is
cost-effective to me in my current situation.
On top of t
us
that can understand simple tools like structured Frame. You just need to have
the desire and understanding of how important it is.
Original Message ----
Subject: RE: Reasons to structure
From: "Randall C. Reed"
Date: Thu, February 15, 2007 9:11 am
To: ,
Russ Wes
I'm on the FM-DITA mailing list Art, and was invovled about a year or two
ago when it was just starting out.
I still keep on top of things, but in my last place we switched to AuthorIT
as it meet our needs. My current position already has a structured
FrameMaker setup, so I've missed the chance t
us
that can understand simple tools like structured Frame. You just need to have
the desire and understanding of how important it is.
Original Message ----
Subject: RE: Reasons to structure
From: "Randall C. Reed" <[EMAIL PROTECTED]>
Date: Thu, February 15, 2007 9:
otection.net at lists.frameusers.com
[mailto:framers-bounces+randall.reed=forceprotection.net at lists.frameuser
s.com] On Behalf Of russ at weststreetconsulting.com
Sent: Thursday, February 15, 2007 8:09 AM
To: framers at lists.frameusers.com
Subject: [BULK] RE: Reasons to structure
Importance: Low
Jeremy, I don&
All the reasons to use structured FrameMaker that people have submitted
focus on the net benefits, which is probably the main reason why you
would do this. However, here's a complementary take on it. As a lone
writer, I did all the work to write an EDD and convert my unstructured
doc to structu
You may want to look over, and play with, the FM DITA plug in. It's a
structured tool, obviously, but seems to be a rationally usable tool
rather than an entire philosophy.
Art
On 2/15/07, Gordon McLean wrote:
> "If you work in the tech industry and don't have time to learn, your fate is
> seale
One more reason, at least for my team, and I did not see this in the thread
(not directly said, anyway) is that we have a totally diff publishing model
here at FedEx. Our model is stood on its head, so to speak. By that, I mean
that our small group of writers function as a 'service bureau'. We are
Matt's question is, to some degree, academic and as a result list members
have made many valid points, some totally at odds with others. (Isn't that
the point of academia? :) In practice, the questions are: What will
structure do for *my* problems and what will it cost to implement?
I said the fo
Matt's question is, to some degree, academic and as a result list members
have made many valid points, some totally at odds with others. (Isn't that
the point of academia? :) In practice, the questions are: What will
structure do for *my* problems and what will it cost to implement?
I said the fol
m] On Behalf Of [EMAIL PROTECTED]
Sent: Thursday, February 15, 2007 8:09 AM
To: framers@lists.frameusers.com
Subject: [BULK] RE: Reasons to structure
Importance: Low
Jeremy, I don't think that is harsh at all. What I think is harsh is the
constant discouragement from learning and professional deve
All the reasons to use structured FrameMaker that people have submitted
focus on the net benefits, which is probably the main reason why you
would do this. However, here's a complementary take on it. As a lone
writer, I did all the work to write an EDD and convert my unstructured
doc to structu
One more reason, at least for my team, and I did not see this in the thread
(not directly said, anyway) is that we have a totally diff publishing model
here at FedEx. Our model is stood on its head, so to speak. By that, I mean
that our small group of writers function as a 'service bureau'. We are
0800
From: "Jeremy H. Griffith"
Subject: Re: Reasons to Structure
To: framers at lists.frameusers.com
Message-ID: <2ib7t2p94cn4i7lv0j116s5svf7bhpld1u at 4ax.com>
Content-Type: text/plain; charset=ISO-8859-1
On Wed, 14 Feb 2007 04:56:49 -0700, russ at weststreetconsulting.com
wrote
You may want to look over, and play with, the FM DITA plug in. It's a
structured tool, obviously, but seems to be a rationally usable tool
rather than an entire philosophy.
Art
On 2/15/07, Gordon McLean <[EMAIL PROTECTED]> wrote:
"If you work in the tech industry and don't have time to learn, y
"If you work in the tech industry and don't have time to learn, your fate is
sealed."
I know what you are saying, but you are presuming that learning how to use a
technology is more important than learning whether or not that technology is
cost-effective to me in my current situation.
On top of t
0800
From: "Jeremy H. Griffith" <[EMAIL PROTECTED]>
Subject: Re: Reasons to Structure
To: framers@lists.frameusers.com
Message-ID: <[EMAIL PROTECTED]>
Content-Type: text/plain; charset=ISO-8859-1
On Wed, 14 Feb 2007 04:56:49 -0700, [EMAIL PROTECTED]
wrote:
>Jeremy
On Wed, 14 Feb 2007 04:56:49 -0700, [EMAIL PROTECTED]
wrote:
>Jeremy Griffith wrote [referring to semantic markup]:
>
>>You can do the same with paragraph formats, too. But you can
>>do all that in UNstructured docs just as easily as in structured.
>>Maybe *more* easily, when you factor in the t
On Wed, 14 Feb 2007 04:56:49 -0700, russ at weststreetconsulting.com
wrote:
>Jeremy Griffith wrote [referring to semantic markup]:
>
>>You can do the same with paragraph formats, too. But you can
>>do all that in UNstructured docs just as easily as in structured.
>>Maybe *more* easily, when you
Matt,
I do both structured and unstructured. The need for that depends IMHO
on the contents and "structure" (or lack of) in the document(s).
However, where I have been using structure (and then I ususally set
all the formatting from within the EDD and avoid using paragraph
format tags), all updati
--- Charles Beck <[EMAIL PROTECTED]> wrote:
> Besides-with the caveat that I have not actually
> experienced *enforced* structured authoring, per
> sé-if you need to format a word or phrase for
> emphasis or for special recognition (such as bolding
> UI elements), don't you still have to tag that
>
No one has mentioned the potential for greatly
improving writer productivity, as well as eliminating
format overrides.
Once authors are up to speed on using the structure
view and the element catalog, they're freed from the
entire formatting burden (if the EDD specifies
context-based format rules
Ok, I'll hoof in line and sinker. I recently wrote a series of articles on
structured FrameMaker, and here's what I put under 'Why should I use structured
documents?'. The ordering is not significant, and some points have already been
covered by others:
. A much greater level of automation beco
Maxwell Hoffmann wrote:
> Matt,
>
> Another major benefit of structured FrameMaker is "context sensitive
> formatting," which I believe was mentioned before by another forum
> member. An added detail is that you can reuse "generic" element tags
> which will look dramatically different in different
That makes sense. Thanks.
-Original Message-
From: Ridder, Fred [mailto:fred.rid...@intel.com]
Subject: RE: Reasons to Structure
The point is that you tag a UI element as a UI element because it is a UI
element. You make it bold (or whatever) at a later point in the process based
on
--- Charles Beck wrote:
> Besides-with the caveat that I have not actually
> experienced *enforced* structured authoring, per
> s?-if you need to format a word or phrase for
> emphasis or for special recognition (such as bolding
> UI elements), don't you still have to tag that
> content somewhere?
Maxwell Hoffmann wrote:
Matt,
Another major benefit of structured FrameMaker is "context sensitive
formatting," which I believe was mentioned before by another forum
member. An added detail is that you can reuse "generic" element tags
which will look dramatically different in different contexts.
Matt,
Another major benefit of structured FrameMaker is "context sensitive
formatting," which I believe was mentioned before by another forum
member. An added detail is that you can reuse "generic" element tags
which will look dramatically different in different contexts.
In unstructured FrameMak
No one has mentioned the potential for greatly
improving writer productivity, as well as eliminating
format overrides.
Once authors are up to speed on using the structure
view and the element catalog, they're freed from the
entire formatting burden (if the EDD specifies
context-based format rules
Matt,
Another major benefit of structured FrameMaker is "context sensitive
formatting," which I believe was mentioned before by another forum
member. An added detail is that you can reuse "generic" element tags
which will look dramatically different in different contexts.
In unstructured FrameMak
That makes sense. Thanks.
-Original Message-
From: Ridder, Fred [mailto:[EMAIL PROTECTED]
Subject: RE: Reasons to Structure
The point is that you tag a UI element as a UI element because it is a UI
element. You make it bold (or whatever) at a later point in the process based
on how
>>MATT TODD <[EMAIL PROTECTED]> wrote:
>>[snip]
>>
>>So tell me...why structure documentation? I don't know enough
>>to answer that question, and neither do my bosses. What's so
>>great about it?
>>What capabilities does it offer that demand its use? Right now,
>>I'm just doing what I'm told, but
>>MATT TODD wrote:
>>[snip]
>>
>>So tell me...why structure documentation? I don't know enough
>>to answer that question, and neither do my bosses. What's so
>>great about it?
>>What capabilities does it offer that demand its use? Right now,
>>I'm just doing what I'm told, but it's always nice t
Matt,
I do both structured and unstructured. The need for that depends IMHO
on the contents and "structure" (or lack of) in the document(s).
However, where I have been using structure (and then I ususally set
all the formatting from within the EDD and avoid using paragraph
format tags), all updat
Jeremy Griffith, write:
You can do the same with paragraph formats, too. But you can
do all that in UNstructured docs just as easily as in structured.
Maybe *more* easily, when you factor in the time to set up your
structure, and to modify it when you make changes, which is major.
I've only
Ok, I'll hoof in line and sinker. I recently wrote a series of articles on
structured FrameMaker, and here's what I put under 'Why should I use structured
documents?'. The ordering is not significant, and some points have already been
covered by others:
. A much greater level of automation beco
Jeremy Griffith, write:
You can do the same with paragraph formats, too. But you can
do all that in UNstructured docs just as easily as in structured.
Maybe *more* easily, when you factor in the time to set up your
structure, and to modify it when you make changes, which is major.
I've only
s.com
Cc: MATT TODD
Subject: RE: Reasons to Structure
Sorry to be so delinquent in responding to this; I have my excuses.
Some of us actually LIKE the left-brain right-brain gear shifting and are quite
efficient at it. Mind you, I am a great proponent of structured authoring in
theory and a mise
unces+charles.beck=infor@lists.frameusers.com] On Behalf
Of Steve Rickaby
Sent: Monday, February 12, 2007 10:10 AM
To: framers at FrameUsers.com
Cc: MATT TODD
Subject: Re: Reasons to Structure
At 06:45 -0800 12/2/07, Rene Stephenson wrote:
> * Dynamic formatting: you can use structured FM t
On Tue, 13 Feb 2007 23:27:15 -0500, "Ridder, Fred" <[EMAIL PROTECTED]> wrote:
>The point is that you tag a UI element as a UI element because
>it is a UI element. You make it bold (or whatever) at a later point
>in the process based on how you choose to format the semantically
>tagged elements fo
On Tue, 13 Feb 2007 23:27:15 -0500, "Ridder, Fred"
wrote:
>The point is that you tag a UI element as a UI element because
>it is a UI element. You make it bold (or whatever) at a later point
>in the process based on how you choose to format the semantically
>tagged elements for a given delivera
t com)
Intel
Parsippany, NJ
-Original Message-
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of Charles Beck
Sent: Tuesday, February 13, 2007 11:16 PM
To: Steve Rickaby; framers@FrameUsers.com
Cc: MATT TODD
Subject: RE: Reasons to Structure
Sorry to be so delinquent in respondi
onday, February 12, 2007 10:10 AM
To: framers@FrameUsers.com
Cc: MATT TODD
Subject: Re: Reasons to Structure
At 06:45 -0800 12/2/07, Rene Stephenson wrote:
> * Dynamic formatting: you can use structured FM to create formats that
> behave differently depending on various surrounding factors, like
Matt,
All of the reasons for migrating to structure listed so far by other
members are excellent. Another consideration is that structure (with
containing elements and "context" for content) makes it much easier to
write more effective FrameMaker plug-ins. To quote a portion of a white
paper on ou
Matt,
All of the reasons for migrating to structure listed so far by other
members are excellent. Another consideration is that structure (with
containing elements and "context" for content) makes it much easier to
write more effective FrameMaker plug-ins. To quote a portion of a white
paper on ou
At 06:45 -0800 12/2/07, Rene Stephenson wrote:
> * Dynamic formatting: you can use structured FM to create formats that
> behave differently depending on various surrounding factors, like indent to a
> certain level if it follows X paragraph but to a different level if it
> follows Y paragraph
All right...tell me good, solid reasons why a company would want to
structure their documents. With my limited knowledge, I know structure
effectively controls styles, fonts, etc...but I could manage that myself
without structure. By extension, I know style control also controls
content location be
At 06:45 -0800 12/2/07, Rene Stephenson wrote:
> * Dynamic formatting: you can use structured FM to create formats that
> behave differently depending on various surrounding factors, like indent to a
> certain level if it follows X paragraph but to a different level if it
> follows Y paragraph
anks,
Max
--
Max Dunn
Silicon Publishing
-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED]
om] On Behalf Of Rene Stephenson
Sent: Monday, February 12, 2007 6:46 AM
To: MATT TODD; framers@lists.frameusers.com
Subject: Re: Reasons to Structure
Matt,
I'll start t
MATT TODD; framers at lists.frameusers.com
Subject: Re: Reasons to Structure
Matt,
I'll start the ball rolling, but I'm sure you'll get tons of responses
from folks more savvy about structure than myself. ;-)
* Dynamic formatting: you can use structured FM to create format
I think it depends on what you're doing and with how many people.
If you're all by yourself, and you only need PDF and one type of help
output...I don't really think there is a reason to go to structured authoring.
It's perfectly possible for you to handle all of it yourself. (I've been doing
i
I think it depends on what you're doing and with how many people.
If you're all by yourself, and you only need PDF and one type of help
output...I don't really think there is a reason to go to structured authoring.
It's perfectly possible for you to handle all of it yourself. (I've been doing
i
Matt,
I'll start the ball rolling, but I'm sure you'll get tons of responses from
folks more savvy about structure than myself. ;-)
* Dynamic formatting: you can use structured FM to create formats that behave
differently depending on various surrounding factors, like indent to a cer
Matt,
I'll start the ball rolling, but I'm sure you'll get tons of responses from
folks more savvy about structure than myself. ;-)
* Dynamic formatting: you can use structured FM to create formats that behave
differently depending on various surrounding factors, like indent to a certain
All right...tell me good, solid reasons why a company would want to
structure their documents. With my limited knowledge, I know structure
effectively controls styles, fonts, etc...but I could manage that myself
without structure. By extension, I know style control also controls
content location be
68 matches
Mail list logo