The last FM 7.x projects I worked on were perennially losing cross-refs,
just in day-to-day book building operations.
Not to mention changes in chapters themselves.
If it could be truly automated, maybe... but sitting down to a list of
hundreds of unresolved cross-refs isn't a great way to start your day.
Art Campbell
art.campb...@gmail.com
"... In my opinion, there's nothing in this world beats a '52 Vincent and a
redheaded girl." -- Richard Thompson
No disclaimers apply.
DoD 358
On Tue, Jun 15, 2010 at 12:56 PM, Combs, Richard
<richard.co...@polycom.com>wrote:
> Avraham Makeler wrote:
>
> > Hi Art. Thanks for the response.
> >
> > >> First, if I were you, I'd resist this. I think it's unnecessary and
> > could
> > become a potential maintenance nightmare.
> >
> > >> I think it's unnecessary
> > I think this is standard fare in programmer's and API reference guides.
> So
> > they want what they see elsewhere.
>
> Agreed. In online programmer/API documentation, users expect references to
> other classes, methods, functions, etc., to be links to them. Although I
> suspect/hope "every other word" is something of an exaggeration. :-)
>
> > >> could become a potential maintenance nightmare.
> > That is definitely a point. It never occurred to me before; maybe because
> > none such document that I ever worked on ever actually realized that
> > horrifying potential in practice.
>
> If you use FM cross-references, I don't see why it would ever become a
> maintenance problem. Presumably, all these cross-references would use the
> <$paratext> building block to retrieve the text of a heading pgf that
> contains the name of the software object being referenced. If a function's
> name changes from getAnotherFoo to getNextFoo, you change the name in the
> heading, and FM updates all the xrefs to that heading automagically.
>
> As for automating your task, it could be done with FrameScript (
> www.framescript.com) or FrameAC (
> www.mekon.com/index.php/pages/knowledge_zone/frameac/products/technologies/manage).
> Since you have VB experience, the latter makes more sense for you if you
> want to "roll your own." Alternatively, you might want to get a quote from
> Rick Quatro (www.frameexpert.com) for a custom FrameScript solution.
>
>
> Richard G. Combs
> Senior Technical Writer
> Polycom, Inc.
> richardDOTcombs AT polycomDOTcom
> 303-223-5111
> ------
> rgcombs AT gmailDOTcom
> 303-903-6372
> ------
>
>
>
>
>
> _______________________________________________
>
>
> You are currently subscribed to framers as art.campb...@gmail.com.
>
> Send list messages to fram...@lists.frameusers.com.
>
> To unsubscribe send a blank email to
> framers-unsubscr...@lists.frameusers.com
> or visit
> http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.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 fram...@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.
