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.campbell at 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.combs at 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.campbell at gmail.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/art.campbell%40gmail.com > > Send administrative questions to listadmin at frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. >