[ omegat-Documentation-1802454 ] discrepencies in the 1.7.2 manual

[SourceForge.net <no...@so...>]

Documentation item #1802454, was opened at 2007-09-26 08:18
Message generated for change (Comment added) made by vitosmolej
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=912617&aid=1802454&group_id=68187

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: correct mistake
Group: 1.7 - user manual
Status: Open
Resolution: None
Priority: 8
Private: No
Submitted By: zoorg (zoorg)
>Assigned to: smolejv (vitosmolej)
Summary: discrepencies in the 1.7.2 manual

Initial Comment:
The 1.7.2 manual seems to not be updated to the software version.

The version numbers sometimes refer to 1.6.1, sometimes to 1.6.2.

There are a few items missing and a few that don't seem to be relevant anymore.

I just finished a big job so I'm ready to make a short list. What is the prefered format to deliver such information ? I can also use OmegaT to modify the original HTML (I suppose ?) and mark the modifications (like before/after...)

----------------------------------------------------------------------

>Comment By: smolejv (vitosmolej)
Date: 2007-09-30 19:05

Message:
Logged In: YES 
user_id=1724380
Originator: NO

assigned it to myself 

----------------------------------------------------------------------

Comment By: smolejv (vitosmolej)
Date: 2007-09-30 19:04

Message:
Logged In: YES 
user_id=1724380
Originator: NO

I appreciate the work done. Will have a better look asap - I was off-line
(i.e. on netless holidays) for a week -.

Vito 

----------------------------------------------------------------------

Comment By: Didier Briel (didierbr)
Date: 2007-09-30 15:42

Message:
Logged In: YES 
user_id=1343245
Originator: NO

The reason for not releasing 1.7 as stable is also the number of available
localizations.

Didier

----------------------------------------------------------------------

Comment By: zoorg (zoorg)
Date: 2007-09-30 15:17

Message:
Logged In: YES 
user_id=1895563
Originator: YES

Since I am not getting a reply from Vito, I'll just attach a file
containing the modifications here and you'll do what you want with it.

I am working from within OmegaT so instead of sending the target HTML with
the modifice English, I'll just send a TMX which will act as a sort of
diff. All my modifications are of the following form:

[before -> after] where either "before" or "after" can be empty strings in
case of simple additions or deletions. In some places "after" is a
"(after)" which indicates a comment rather than a modification. Since I
don't work in the HTML, some additions are not properly formatted. In some
cases I added a "\r" to indicate a line break, which, in HTML should be
properly coded.

The version number (1.6.0, 1.6.1, 1.6.2) has consistently been corrected
to 1.7.2 without using the above system.

I currently have 6 files left. Since I am not an English native I left 99%
of wording issues aside but it seems to me some sentences could benefit
from a rewrite. I should be done sometimes this week.


I changed the priority, since the manual update seems to be the reason why
1.7 is not released as stable.

I hope all that will be useful.

----------------------------------------------------------------------

Comment By: Didier Briel (didierbr)
Date: 2007-09-26 09:20

Message:
Logged In: YES 
user_id=1343245
Originator: NO

The manual has not been updated *at all* (which is why 1.7.x are called
"test" versions).

Vito Smolej is the new person in charge of the documentation, and should
be contacted (contact available in the "Developers" section) regarding
these matters.

Didier


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=912617&aid=1802454&group_id=68187