Would you like proofreading functions?

HM5 served us well, now its time has come and it has been replaced... If you have HM5 questions, please post them here.

Moderators: Alexander Halser, Tim Green

Post Reply
User avatar
Tim Green
Site Admin
Posts: 23143
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Would you like proofreading functions?

Unread post by Tim Green »

Some users have suggested that they would like to have additional functionality for proofreading, so we decided to create a poll for this. We'd like to know whether proofreading with PDF and comments is sufficient for you (this is already possible) or if you would like to have other options. For example, would you like to print out a text-only version with a broader right margin with space for handwritten comments? Or would you like a PDF with text only and no images? Or would you like even more, with a special proofreading document and a dedicated interactive proofreading viewer with the ability to add comments with user names?
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
User avatar
Aitch
Posts: 544
Joined: Thu Jun 10, 2004 4:52 pm
Location: Manchester, UK

Re: Would you like proofreading functions?

Unread post by Aitch »

Even though I am the only one author in our department, it will be nice to have something like a 'viewer' available for anybody who is interested in proofreading.

Anything that is quick and easy to add comments to (without having specific software) is always a winner in my book. (Not all seem to be able to add comments to PDF).
Version 9.0.3 Build 6380

---------------------------------------------------------------------
Always check your spellar and gramming before you publish!
David Makulec
Posts: 150
Joined: Tue Nov 03, 2009 6:14 pm

Re: Would you like proofreading functions?

Unread post by David Makulec »

Well, I voted for "special" only because its ambiguity left open the possibility something truly helpful might evolve.

Printouts I can handle with current functionality, so that's no help. And I'm not a real fan of existing "with comments" formats, though I'm open to persuasion.

My main problem is getting anyone to review my work in the first place. And that is certainly beyond EC/H&M's ability to address. :roll:
User avatar
Winsteps
Posts: 443
Joined: Wed Aug 29, 2007 7:34 am

Re: Would you like proofreading functions?

Unread post by Winsteps »

Tim, how about another option?

"PDF indicates changes from previous version with vertical line in the margin." Then proof-readers and end-users only need to read relevant text.
Bill Dimech
Posts: 12
Joined: Mon Oct 24, 2011 4:03 am

Re: Would you like proofreading functions?

Unread post by Bill Dimech »

Hi,
When I can tee up a proof reader .. We tend to export to MS word and then turn on change tracking before handing over the document to the proof readers. This at least makes it easy for us to find the corrections or recomended changes in the word document using its inbuilt change tracking. As the formatting can vary between word and the final help text this is only useful in correcting the text, not finding formatting issues unless they are glaring ones.

Making the corrections back in the help text is still a bit of a pain, sometimes it can be hard finding the relevant words or paragraphs in the help text to make the corrections.

An ideal solution although I assume way too big a project, would be to allow the help text to publish a proof read document in electronic form that is in the format of the final output. Proof readers can edit, make changes or add comment etc. The editors can then review the changes through the help text editor and have change tracking options similar to work like Find Next Change, accept, or manully update it directly in the editor. Basically once the proof readers complete their proof read, you can jump into the Help and Manual project and reconcile the changes directly.
That would be ideal but I imagine a massive undertaking to impliment :-) But hey, you have to put the ideas out there.

Bill D
User avatar
Tim Green
Site Admin
Posts: 23143
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Would you like proofreading functions?

Unread post by Tim Green »

Thanks for all the feedback and suggestions, keep them coming! Note, however, that a special proofreading format and reader/editor would definitely be a project for the next major version, not for an interim release... 8)
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
User avatar
Bob MacLeod
Posts: 16
Joined: Thu Dec 14, 2006 9:53 pm

Re: Would you like proofreading functions?

Unread post by Bob MacLeod »

I seek a printable (e.g., PDF would be fine since I can print it) because the people I want to read it are not as comfortable playing with text on the computer. Thinking of my co-workers if I want them to do it in a hurry, paper is my best choice. This is why I would like the option to print (PDF/RTF) without the images--without having to conditional text every image.

As for me personally, I think the proofable version is a great idea. We have almost 1000 pages in 4 different manuals, and it would be great to have a way for users to give us feedback on individual topics.
Andy Micone
Posts: 10
Joined: Wed Mar 28, 2012 7:14 pm

Re: Would you like proofreading functions?

Unread post by Andy Micone »

I would like to see integration with grammarly, personally. Right now I convert all my H&M output to rtf format, convert to docx, then upload to grammarly to proof it.
User avatar
Tim Green
Site Admin
Posts: 23143
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Would you like proofreading functions?

Unread post by Tim Green »

Hi Andy,

That would certainly be a better option then including a dedicated grammar checker in Help & Manual, which would be a waste of time and energy (the first thing all writers I know do with any word processor is to turn off the grammar checker completely and never look at it again). Whether or not it's possible will depend on the plugin interface. 8)
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
scotcro
Posts: 32
Joined: Thu Jul 19, 2007 2:18 am
Location: Vancouver, WA USA

Re: Would you like proofreading functions?

Unread post by scotcro »

Being an owner of a small software company I know how fun and fulfilling it can be to keep adding those new and improved features. The features that have a high "Neato" factor are the most fun. This often results though in diluting the quality of the product overall. Why am I saying this in this post, well I would like to see EC software concentrate on completing and polishing the product features it currently has before adding others. Emphasis on "completing" there are so many areas that may not necessarily be broken, but small tweaks would make such a big difference in productivity and overall quality. I find too often I am working for Help & Manual rather than Help and Manual working for me.
s.
VincentBevort
Posts: 90
Joined: Wed Mar 30, 2016 1:53 pm
Location: Stockholm, Sweden
Contact:

Re: Would you like proofreading functions?

Unread post by VincentBevort »

A late addition to this thread.

I would like to be able to set the right margin in the "print" view in the editor.
This will make it easier to see formatting issue in e.g. Word already when creating the content.
E.g. I have a text like

Code: Select all

forceCodeInputAfterFirstCoin="true"
that i want to keep togehter on one line to prevent it from ending up like

Code: Select all

forceCodeInputAfter-
FirstCoin="true"
when creating the Word output

Even a configurable gideline on the right side would be of great help

The underlying problem is that H&M keeps this together when zooming in on the text but when I send it to Word, Word will set a hyphen where it finds it fitting.
As our customers copy the code examples we supply this will end up in errors.
Senior Test Engineer & Technical Writer
Flowbird group
User avatar
Tim Green
Site Admin
Posts: 23143
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Would you like proofreading functions?

Unread post by Tim Green »

Hi Vincent,
VincentBevort wrote:I would like to be able to set the right margin in the "print" view in the editor.
This actually has nothing to do with the subject of the thread so it really would have been better to post this as a new post in the Wish List section. However, it's actually OK to answer this here because what you are asking for is unfortunately physically impossible in a program like Help+Manual.

You are used to single-format tools like Word, where the source document and the "output" are the same thing. There what you describe is not a problem, because the document already has margins and paper size and so on. In Help+Manual, the source document does not have anything to do with the output directly. It consists only of the content itself. There are no margins, no page information, no layout, nothing at all like that. Those things must be added separately for each individual output format, and that only happens when you combine the content and the template to create the output. The hyphenation does not and cannot exist until that happens. And since there are many factors that affect it--paper size, manual page breaks, sections and also the printer driver (every printer driver writes text slightly differently, with different spacing between the letters, causing different pagination and hyphenation)--there is no way to really check the pagination other than actually generating the complete output.

Some things in PDF can be checked by creating a minimal "checking template" that only includes the topics section, and you can then speed it up still further by only generating the currently selected topic (select topics, then use the selected topics only option in the Table of Contents section in the Publish screen). However, that doesn't work for hyphenation and pagination because it can easily result in different hyphenation and pagination than the final product.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
VincentBevort
Posts: 90
Joined: Wed Mar 30, 2016 1:53 pm
Location: Stockholm, Sweden
Contact:

Re: Would you like proofreading functions?

Unread post by VincentBevort »

Thanks jim for the explanation.

Was expecting something like that.
This is why i also added the idea of a guideline.
I have seen this in some text editors.
Also an older version of Visio had this. You coud drag the line from the left vertical ruler onto your workspace
If I am able to set a vertical guideline on e.g. 15 cm I get an indication of when I may expect some hyphenation.

BTW- I found a simple Word command to control the hyphenation when opening the document.

Code: Select all

Sub AutoOpen()
      ActiveDocument.AutoHyphenation = False
End Sub
It is also in the ribbon in the Layout tab in the section page setup as a drop down box
Senior Test Engineer & Technical Writer
Flowbird group
Post Reply