Re: Anyone used Tortoise CVS with Frame Files

[Donald.M.Rinderknecht]

Content Management and Versioning is a recurring topic on Framers. Does 
anyone have a summary of systems that are compatible with Frame?


Also, instead of using binary files, would it be possible to use MIF or, 
if in a completely structured environment, XML in the CVS to keep track 
of differences down to the 'element' level?


Thanks,
Don
--
Don Rinderknecht
Meteorologist/Instructor
Warning Decision Training Branch
Norman, OK
http://wdtb.noaa.gov
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

Wanted: Documentation Specialist

[Christine Foley]

Documentation Specialist: Blackboard - Commerce Suite- Phoenix, AZ



Blackboard’s product development staff is committed to delivering a  
quality product, on time and at a reasonable cost. Documentation  
Specialists are integral to this process. The writer will work with  
product teams developing documentation for the Blackboard Commerce  
Suite. The responsibilities of the writer include writing and editing  
system administration manuals, installation and configuration guides  
for hardware and software, and technical support manuals. Qualified  
candidate possesses exceptional writing skills and is comfortable  
producing drafts that require minimal revision and editorial  
oversight. Preferred candidates possess a background in technology,  
documentation design and technical writing for software and/or  
hardware products. Experience in financial transaction processing  
will enable preferred candidates to understand and document how  
features enrich the student experience on campus.


Position Responsibilities:
Define and scope documentation requirements using product functional  
requirements document.

Research, develop and maintain new and existing documents.
Interact with requirements analysts, software developers, quality  
assurance and technical support associates.
Prepare technical documentation for administrators, installers and  
developers.
Ensure that documents are technically accurate, user-focused, and  
free from errors.


Professional Qualifications:
Five or more years experience writing technical documentation,
Superior writing skills
Bachelor's degree
Thorough knowledge of grammar, spelling, and punctuation
Advanced Adobe Framemaker proficiency, including drawing tools,  
books, and cross-references

Photoshop or digital photo editing experience
Experienced with digital documents (HTML, PDF)
Detail oriented
Ability to communicate effectively with team members and resolve  
conflicting information
Ability to accurately scope documentation requirements and  
consistently meet deadlines

Well organized with ability to manage multiple projects
Proficient with Microsoft Office Tools.

If interested, please send your resume to Brian Digby  
([EMAIL PROTECTED])



Blackboard Inc is an equal employment opportunity employer and  
considers qualified applicants for employment without regard to race,  
gender, age, color, religion, national origin, marital status,  
disability, sexual orientation, or any other protected factor.___



You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

RE: Anyone used Tortoise CVS with Frame Files

[Grant Hogarth]

I've been using it heavily for about 6 weeks.  
I really like it -- much better than SourceSafe!
 
The best part is that I'm working with writers in Paris and Geneva,
while the subversion record copies are on a server in San Jose, CA, so
we have three copies in case of disaster, and as we work from the same
master set, as long as we check things in, each of us gets the latest
version when we start in the AM.

Grant

-Original Message-
From: Neil Tubb
Sent: Tuesday, March 14, 2006 8:58 AM
To: framers@lists.frameusers.com
Subject: Anyone used Tortoise CVS with Frame Files

Hi all,

Just wondering if anyone out there has used the open source Tortoise CVS
with Frame files? I'm looking into it as a way to introduce some simple
version control for our cust docs (just simple check-in,
check-out...obviously no merges or anything like that). Any info would
be appreciated.

Cheers,
Neil
__

Neil Tubb

Senior Technical Writer
Solace Systems, Inc.
535 Legget Drive, 3rd Floor
Ottawa, ON K2K 3B8
Internet: www.solacesystems.com http://www.solacesystems.com 
Email: [EMAIL PROTECTED]
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

Printing a 6 x 9 Manual

[Angela Akridge]

Oops, one more question. My print vendor is printing my 6 x 9 document. If
the printer uses 9 x12 paper whereby one book page consumes one side of the
9 x 12 paper and another book page consumes the other side, what print
options should I consider setting on the Frame file. Anything? If the print
vendor folds the 9 x 12, don't the manual pages need to print in a specific
order (not 1-23)?

--
Angela
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

Re: Printing a 6 x 9 Manual

[William Gaffga]

It shouldn't be your concern. That is the printer's job. Give the  
provider a PDF of the manual in proper page order. Let the provider  
do the imposition.


Will.

On Mar 15, 2006, at 4:20 PM, Angela Akridge wrote:

Oops, one more question. My print vendor is printing my 6 x 9  
document. If
the printer uses 9 x12 paper whereby one book page consumes one  
side of the

9 x 12 paper and another book page consumes the other side, what print
options should I consider setting on the Frame file. Anything? If  
the print
vendor folds the 9 x 12, don't the manual pages need to print in a  
specific

order (not 1-23)?

--
Angela

___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]

or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

RE: Adding a Blank Page Before/After Book Cover

[Gillian Flato]

Angela,

If you're using a book file then add in the cover and a blank page. Then
build your book and make your PDF. 


Thanks,

Gillian


-Original Message-
From: [EMAIL PROTECTED]
[mailto:[EMAIL PROTECTED] On
Behalf Of Angela Akridge
Sent: Wednesday, March 15, 2006 4:06 PM
To: framers@lists.frameusers.com
Subject: Adding a Blank Page Before/After Book Cover

I'm trying to create a layout for a manual that needs to be made
available
in PDF and print. Using Acrobat Professional, I create one PDF using
three
PDFs: Front cover, Back cover, and manual. I need to ensure that there
is a
blank page after the Front cover, so that the manual starts on the
right. Am
I making sense?

Since the cover isn't part of the Frame file, the Make Page Count Even
doesn't help me. I also need a blank page before the Back cover for the
same
reason. What's the proper way (Page Break?) to achieve this goal?

The Frame Online Help talks about blank pages and disconnected pages,
but I
don't think these tools provide the solution I need.

Thank you,

--
Angela
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to 
[EMAIL PROTECTED]
or visit
http://lists.frameusers.com/mailman/options/framers/gflato%40nanometrics
.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.


This message (including any attachments) may contain confidential information 
intended for a specific individual and purpose. If you are not the intended 
recipient, delete this message. If you are not the intended recipient, 
disclosing, copying, distributing, or taking any action based on this message 
is strictly prohibited.
___


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to
[EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

Anyone used Tortoise CVS with Frame Files

[hedley.fin...@myob.com]

Martha:

>  I use TortoiseCVS with Frame files. I mark both .fm and .book files
>  as binary, so that each time I check in the entire file is replaced,

And if the product manager has just decided to restore the functionality 
that was removed a few days ago, how do you retrieve the version of the FM 
file that contains the content you deleted when the function was removed?

Regards,
Hedley

--
Hedley Finger
Technical Communications Tools & Processes Specialist
MYOB Australia 
P.O. box 371   Blackburn VIC 3130   Australia
12 Wesley Court   Tally Ho Business Park   East Burwood VIC 3151 Australia

Tel. +61 3 9222 9992 x 7421,   Mob. (cell) +61 412 461 558

? MYOB Technology Pty Ltd 2005

Anyone used Tortoise CVS with Frame Files

[Donald.M.Rinderknecht]

Content Management and Versioning is a recurring topic on Framers. Does 
anyone have a summary of systems that are compatible with Frame?

Also, instead of using binary files, would it be possible to use MIF or, 
if in a completely structured environment, XML in the CVS to keep track 
of differences down to the 'element' level?

Thanks,
Don
--
Don Rinderknecht
Meteorologist/Instructor
Warning Decision Training Branch
Norman, OK
http://wdtb.noaa.gov

Wanted: Documentation Specialist

[Christine Foley]

Documentation Specialist: Blackboard - Commerce Suite- Phoenix, AZ



Blackboard?s product development staff is committed to delivering a  
quality product, on time and at a reasonable cost. Documentation  
Specialists are integral to this process. The writer will work with  
product teams developing documentation for the Blackboard Commerce  
Suite. The responsibilities of the writer include writing and editing  
system administration manuals, installation and configuration guides  
for hardware and software, and technical support manuals. Qualified  
candidate possesses exceptional writing skills and is comfortable  
producing drafts that require minimal revision and editorial  
oversight. Preferred candidates possess a background in technology,  
documentation design and technical writing for software and/or  
hardware products. Experience in financial transaction processing  
will enable preferred candidates to understand and document how  
features enrich the student experience on campus.

Position Responsibilities:
Define and scope documentation requirements using product functional  
requirements document.
Research, develop and maintain new and existing documents.
Interact with requirements analysts, software developers, quality  
assurance and technical support associates.
Prepare technical documentation for administrators, installers and  
developers.
Ensure that documents are technically accurate, user-focused, and  
free from errors.

Professional Qualifications:
Five or more years experience writing technical documentation,
Superior writing skills
Bachelor's degree
Thorough knowledge of grammar, spelling, and punctuation
Advanced Adobe Framemaker proficiency, including drawing tools,  
books, and cross-references
Photoshop or digital photo editing experience
Experienced with digital documents (HTML, PDF)
Detail oriented
Ability to communicate effectively with team members and resolve  
conflicting information
Ability to accurately scope documentation requirements and  
consistently meet deadlines
Well organized with ability to manage multiple projects
Proficient with Microsoft Office Tools.

If interested, please send your resume to Brian Digby  
(bdigby at blackboard.com)


Blackboard Inc is an equal employment opportunity employer and  
considers qualified applicants for employment without regard to race,  
gender, age, color, religion, national origin, marital status,  
disability, sexual orientation, or any other protected factor.

Anyone used Tortoise CVS with Frame Files

[Grant Hogarth]

I've been using it heavily for about 6 weeks.  
I really like it -- much better than SourceSafe!

The best part is that I'm working with writers in Paris and Geneva,
while the subversion record copies are on a server in San Jose, CA, so
we have three copies in case of disaster, and as we work from the same
master set, as long as we check things in, each of us gets the latest
version when we start in the AM.

Grant

-Original Message-
From: Neil Tubb
Sent: Tuesday, March 14, 2006 8:58 AM
To: framers at lists.frameusers.com
Subject: Anyone used Tortoise CVS with Frame Files

Hi all,

Just wondering if anyone out there has used the open source Tortoise CVS
with Frame files? I'm looking into it as a way to introduce some simple
version control for our cust docs (just simple check-in,
check-out...obviously no merges or anything like that). Any info would
be appreciated.

Cheers,
Neil
__

Neil Tubb

Senior Technical Writer
Solace Systems, Inc.
535 Legget Drive, 3rd Floor
Ottawa, ON K2K 3B8
Internet: www.solacesystems.com  
Email: neil.tubb at solacesystems.com

Anyone used Tortoise CVS with Frame Files

[Mark Barratt]

Donald.M.Rinderknecht wrote:

> Also, instead of using binary files, would it be possible to use MIF or, 
> if in a completely structured environment, XML in the CVS to keep track 
> of differences down to the 'element' level?

Have used Tortoise SVN for a couple of years for Frame XML saves: 
brilliant. My tech colleagues tell me that SVN (Subversion) is hugely 
better than CVS and that CVS is dying fast as a result.

They also tell me that Subversion doesn't have the same storage penalty 
as CVS with binary files and does binary diffs (though personally I 
can't see the point of that).

-- 
Mark Barratt
Text Matters

Information design: we help explain things using
language | design | systems | process improvement
__
phone +44 (0)118 986 8313  email markb at textmatters.com
web http://www.textmatters.com

Anyone used Tortoise CVS with Frame Files

[Jon Konrath]

> Just wondering if anyone out there has used the open source 
> Tortoise CVS with Frame files?

I've been using it for a few years now.  It was always good, but the
version that came out maybe a year ago fixed some little problems,
especially with the images in icons, and now it's great.

We're already a CVS shop, with everyone using WinCVS or the CVS support
in Eclipse for code.  The one thing that Tortoise does better is that in
WinCVS, I had to be very careful to initially add binary files and text
files with the binary or text add, and if I added a .fm as text, I had
to go back, delete, commit, add again, and commit, which was a pain.
With Tortoise, I just right click on a bunch of stuff and add, and it
figures out what's binary and what's not.

The fact that it colors the icons to show you what is and isn't checked
out is also a big plus.  And for whatever reason, it's a lot easier to
just right-click on files and do stuff like check the history on a file,
rather than fire up another application and do it the old way.

-Jon


---
Jon Konrath, Technical Writer
DataSynapse, Inc.
jon at datasynapse.com
View the DataSynapse email disclaimer here:

Anyone used Tortoise CVS with Frame Files

[Combs, Richard]

Neil Tubb wrote: 

> Just wondering if anyone out there has used the open source 
> Tortoise CVS with Frame files? I'm looking into it as a way 
> to introduce some simple version control for our cust docs 
> (just simple check-in, check-out...obviously no merges or 
> anything like that). Any info would be appreciated.

Lots of good replies, but there's one thing no one has mentioned
(although Mark Barratt alludes to it): Tortoise isn't a version control
system. It's a client, an _interface_ to version control systems --
specifically to the venerable CVS and the upstart Subversion (SVN). 

We're switching from CVS to Subversion here, but Tech Pubs doesn't check
in FM files. We only check in the PDFs and help files that go into the
build. The engineers here echo Mark's comments about Subversion's
superiority to CVS. 

I've been using Tortoise clients to access both CVS and SVN for a while
now, and I can vouch for Tortoise -- it's much better than WinCVS, which
I used to use. 

As for Hedley's question: 

> Martha:
> 
> >  I use TortoiseCVS with Frame files. I mark both .fm and .book files

> > as binary, so that each time I check in the entire file is replaced,
> 
> And if the product manager has just decided to restore the 
> functionality that was removed a few days ago, how do you 
> retrieve the version of the FM file that contains the content 
> you deleted when the function was removed? 

Martha misspoke -- when you check in, the file isn't _replaced_, the new
version is _added_. Every version you check in is available in the
repository. That's why file space quickly becomes an issue with binary
files -- unlike code (text files), you're not just checking in the
diffs, you're adding a whole new copy of the file. If you do that every
day with lots of FM files, the repository admin may shoot you. 

I don't know anything about the "binary diff" capability in SVN that
Mark mentioned. I'm not sure how that would/could work, and I probably
wouldn't trust it. ;-) Since we only check in the final docs (PDF and
help), it's typically only one check-in per software release and space
isn't really an issue.

Richard


--
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
--
rgcombs AT gmailDOTcom
303-777-0436
--

Revised (and free) FrameDITA-lite available

[Bernard Aschwanden]

Hi all: (and sorry for the cross post to those who, like me, get this a half 
dozen times)

We'll be at the DITA conference next week showing a more fully featured version 
of our FrameDITA-lite application. However, based on the feedback that we've 
had, it seems to work well for the beta group and we are ready to release it to 
the masses.

There is also documentation that goes with this. It's about 40 detailed pages. 
There are samples, exercises to try and much more.

You can learn more at www.publishingsmarter.com under Design & Development in 
FrameDITA. We generally try to give you a good idea of what to expect there and 
also link to the FrameDITA-lite readme file there as well.

Please feel free to forward this information to others you feel may benefit 
from the use of DITA and FrameMaker.

Thanks in advance,

Bernard



Bernard Aschwanden
Publishing Technologies Expert
Publishing Smarter

bernard at publishingsmarter.com 

www.publishingsmarter.com 

Content Management (was Anyone used Tortoise CVS with Frame Files)

[Lynne A. Price]

Don,
   I don't have the summary you requested, but if your XML documents 
round-trip, yes, definitely use XML in your versioning system. Just make 
sure to keep track of the version of all application files (DTD, template, 
r/w rules, application definition file, and of FrameMaker itself) used with 
each document.
   And there is growing support in content management systems for XML.
 --Lynne

At 05:41 AM 3/15/2006, Donald.M.Rinderknecht wrote:
>Content Management and Versioning is a recurring topic on Framers. Does 
>anyone have a summary of systems that are compatible with Frame?
>
>Also, instead of using binary files, would it be possible to use MIF or, 
>if in a completely structured environment, XML in the CVS to keep track of 
>differences down to the 'element' level?
>
>Thanks,
>Don
>--
>Don Rinderknecht
>Meteorologist/Instructor
>Warning Decision Training Branch
>Norman, OK
>http://wdtb.noaa.gov
>
>
>___
>
>
>You are currently subscribed to Framers as lprice at txstruct.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/lprice%40txstruct.com
>
>Send administrative questions to lisa at frameusers.com. Visit
>http://www.frameusers.com/ for more resources and info.


Lynne A. Price
Text Structure Consulting, Inc.
Specializing in structured FrameMaker consulting, application development, 
and training
lprice at txstruct.comhttp://www.txstruct.com
voice/fax: (510) 583-1505  cell phone: (510) 421-2284 

Anyone used Tortoise CVS with Frame Files

[Martha J Davidson]

At 05:31 PM 3/14/2006, hedley.finger at myob.com wrote:
>And if the product manager has just decided to restore the functionality
>that was removed a few days ago, how do you retrieve the version of the FM
>file that contains the content you deleted when the function was removed?

So far, that's never happened to me. I've used various version control
systems over the years with FM files and I've been fine.

To protect myself somewhat from the situation you describe, I have
a condition tag called Obsolete, which I apply to deleted features
and leave hidden for the duration of the release. Then I delete text
marked obsolete later, when I'm sure the feature won't return from
the dead.

martha
--
Martha Jane {Kolman | Davidson}
Dances With Words
editrix at nemasys.com

"Too many words bring about exhaustion."
  --Tao Te Ching, Chapter 5 (translated by Sheets/Tovey)

Anyone used Tortoise CVS with Frame Files

[Martha J Davidson]

At 09:00 AM 3/15/2006, Combs, Richard wrote:
>Martha misspoke -- when you check in, the file isn't _replaced_, the new
>version is _added_. Every version you check in is available in the
>repository.

Thanks, Richard, for clarifying what I meant.

--
Martha Jane {Kolman | Davidson}
Dances With Words
editrix at nemasys.com

"Too many words bring about exhaustion."
  --Tao Te Ching, Chapter 5 (translated by Sheets/Tovey)

Printing a 6 x 9 Manual

[William Gaffga]

It shouldn't be your concern. That is the printer's job. Give the  
provider a PDF of the manual in proper page order. Let the provider  
do the imposition.

Will.

On Mar 15, 2006, at 4:20 PM, Angela Akridge wrote:

> Oops, one more question. My print vendor is printing my 6 x 9  
> document. If
> the printer uses 9 x12 paper whereby one book page consumes one  
> side of the
> 9 x 12 paper and another book page consumes the other side, what print
> options should I consider setting on the Frame file. Anything? If  
> the print
> vendor folds the 9 x 12, don't the manual pages need to print in a  
> specific
> order (not 1-23)?
>
> --
> Angela

Adding a Blank Page Before/After Book Cover

[Gillian Flato]

Angela,

If you're using a book file then add in the cover and a blank page. Then
build your book and make your PDF. 


Thanks,

Gillian


-Original Message-
From: framers-bounces+gflato=nanometrics@lists.frameusers.com
[mailto:framers-bounces+gflato=nanometrics.com at lists.frameusers.com] On
Behalf Of Angela Akridge
Sent: Wednesday, March 15, 2006 4:06 PM
To: framers at lists.frameusers.com
Subject: Adding a Blank Page Before/After Book Cover

I'm trying to create a layout for a manual that needs to be made
available
in PDF and print. Using Acrobat Professional, I create one PDF using
three
PDFs: Front cover, Back cover, and manual. I need to ensure that there
is a
blank page after the Front cover, so that the manual starts on the
right. Am
I making sense?

Since the cover isn't part of the Frame file, the "Make Page Count Even"
doesn't help me. I also need a blank page before the Back cover for the
same
reason. What's the proper way (Page Break?) to achieve this goal?

The Frame Online Help talks about blank pages and disconnected pages,
but I
don't think these tools provide the solution I need.

Thank you,

--
Angela
___


You are currently subscribed to Framers as gflato at nanometrics.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/gflato%40nanometrics
.com

Send administrative questions to lisa at frameusers.com. Visit
http://www.frameusers.com/ for more resources and info.


This message (including any attachments) may contain confidential information 
intended for a specific individual and purpose. If you are not the intended 
recipient, delete this message. If you are not the intended recipient, 
disclosing, copying, distributing, or taking any action based on this message 
is strictly prohibited.