openshot.bugs team mailing list archive
-
openshot.bugs team
-
Mailing list archive
-
Message #03797
[Bug 1152895] [NEW] Proofreading & comments on Help documentation
Public bug reported:
Openshot v1.4.3 on Ubuntu 10.04 LTS Lucid Lynx, installed via PPA.
(Older version previously installed via Synaptic and removed with
"Complete Removal".)
I've just been reading the Help files, as a newcomer and "documentation
enthusiast" :-) Some things caught my attention, so I thought I'd flag
them up. A few are about the actual information, some are just typos.
a) None of my "help" file was pictures - it was all text & tables.
Sometimes it refers to illustrations, so I guess there ought to have
been some...?
b) Part 4.1 Overview.
Item 2 - Function Tabs - the text is "Copy text Switch between Project Files, Transitions, and Effects."
Item 3 - Project Files - the text is "Switch between Project Files, Transitions, and Effects."
This looks to me like a leftover of some updating or something :-)
c) Part 6.9 Save Project screen.
Item 3 - Project Length - the text is "The maximum length of the
timeline. However, the length of the timeline will automatically grow,
if and when clips exceed the length."
I'm not sure what this means. If the clips exceed _this_ length, it
isn't the maximum, is it? I'm thinking maybe you must mean something
like "The length of the timeline will automatically grow as you add
clips, up to this maximum." (If that _is_ what you mean, you might want
another sentence which says what happens if you try to add a clip beyond
the maximum length.)
d) Import Files – Audio, Video, and Images
I'd have liked to be told here whether the files I import will be saved
as part of the project, or whether the project is simply referring to
files external to itself.
e) Part 12.2. Only the Audio.
A minor proof-reading point: in "click the eye icon on the track", you
have two spaces in between "eye" and "icon".
f) 14.5. Speed Tab
"The advanced tab let's you set...": should be "lets".
g) 15.3. Manually
"The following properties are affected by key-frames: Height, Wight, X,
Y, and Alpha." Is there such a thing as "Wight" that I've never heard
of, or is that a typo for "Width"?
h) 18.4.3. Animate Each Title
"(as show in the illustration)": should be "shown". (But as I said
above, I didn't get any illustrations.)
i) Upload Video
"Choose a video file to upload to YouTube. Be sure it's a compatible
format with YouTube first, or it might not work correctly."
I'm guessing the Vimeo option was added later? I suggest "Choose a
video file to upload to YouTube or Vimeo. Be sure that your video's
format is compatible with the destination, or it might not work
correctly."
j) Layout of the help manual: where the page of info is shorter than
the index on the right, I would prefer not to have to move to the bottom
of the page before being able to click on the "next" link. I'd like to
have the next & previous links at the top as well. But I don't know if
you can do anything about that.
h.t.h. :-)
** Affects: openshot
Importance: Undecided
Status: New
** Tags: documentation
** Description changed:
- Openshot v1.4.3 on Ubuntu 10.04 LTS Lucid Lynx, installed via PPA (but
- older version previously installed via Synaptic and "Complete
- Removal"-d).
+ Openshot v1.4.3 on Ubuntu 10.04 LTS Lucid Lynx, installed via PPA.
+ (Older version previously installed via Synaptic and removed with
+ "Complete Removal".)
I've just been reading the Help files, as a newcomer and "documentation
enthusiast" :-) Some things caught my attention, so I thought I'd flag
them up. A few are about the actual information, some are just typos.
a) None of my "help" file was pictures - it was all text & tables.
Sometimes it refers to illustrations, so I guess there ought to have
been some...?
b) Part 4.1 Overview.
Item 2 - Function Tabs - the text is "Copy text Switch between Project Files, Transitions, and Effects."
Item 3 - Project Files - the text is "Switch between Project Files, Transitions, and Effects."
This looks to me like a leftover of some updating or something :-)
c) Part 6.9 Save Project screen.
Item 3 - Project Length - the text is "The maximum length of the
timeline. However, the length of the timeline will automatically grow,
if and when clips exceed the length."
I'm not sure what this means. If the clips exceed _this_ length, it
isn't the maximum, is it? I'm thinking maybe you must mean something
like "The length of the timeline will automatically grow as you add
clips, up to this maximum." (If that _is_ what you mean, you might want
another sentence which says what happens if you try to add a clip beyond
the maximum length.)
d) Import Files – Audio, Video, and Images
I'd have liked to be told here whether the files I import will be saved
as part of the project, or whether the project is simply referring to
files external to itself.
e) Part 12.2. Only the Audio.
A minor proof-reading point: in "click the eye icon on the track", you
have two spaces in between "eye" and "icon".
f) 14.5. Speed Tab
"The advanced tab let's you set...": should be "lets".
g) 15.3. Manually
"The following properties are affected by key-frames: Height, Wight, X,
Y, and Alpha." Is there such a thing as "Wight" that I've never heard
of, or is that a typo for "Width"?
h) 18.4.3. Animate Each Title
"(as show in the illustration)": should be "shown". (But as I said
above, I didn't get any illustrations.)
i) Upload Video
"Choose a video file to upload to YouTube. Be sure it's a compatible
format with YouTube first, or it might not work correctly."
I'm guessing the Vimeo option was added later? I suggest "Choose a
video file to upload to YouTube or Vimeo. Be sure that your video's
format is compatible with the destination, or it might not work
correctly."
j) Layout of the help manual: where the page of info is shorter than
the index on the right, I would prefer not to have to move to the bottom
of the page before being able to click on the "next" link. I'd like to
have the next & previous links at the top as well. But I don't know if
you can do anything about that.
h.t.h. :-)
--
You received this bug notification because you are a member of OpenShot
Bugs, which is subscribed to OpenShot Video Editor.
https://bugs.launchpad.net/bugs/1152895
Title:
Proofreading & comments on Help documentation
Status in OpenShot Video Editor:
New
Bug description:
Openshot v1.4.3 on Ubuntu 10.04 LTS Lucid Lynx, installed via PPA.
(Older version previously installed via Synaptic and removed with
"Complete Removal".)
I've just been reading the Help files, as a newcomer and
"documentation enthusiast" :-) Some things caught my attention, so I
thought I'd flag them up. A few are about the actual information,
some are just typos.
a) None of my "help" file was pictures - it was all text & tables.
Sometimes it refers to illustrations, so I guess there ought to have
been some...?
b) Part 4.1 Overview.
Item 2 - Function Tabs - the text is "Copy text Switch between Project Files, Transitions, and Effects."
Item 3 - Project Files - the text is "Switch between Project Files, Transitions, and Effects."
This looks to me like a leftover of some updating or something :-)
c) Part 6.9 Save Project screen.
Item 3 - Project Length - the text is "The maximum length of the
timeline. However, the length of the timeline will automatically
grow, if and when clips exceed the length."
I'm not sure what this means. If the clips exceed _this_ length, it
isn't the maximum, is it? I'm thinking maybe you must mean something
like "The length of the timeline will automatically grow as you add
clips, up to this maximum." (If that _is_ what you mean, you might
want another sentence which says what happens if you try to add a clip
beyond the maximum length.)
d) Import Files – Audio, Video, and Images
I'd have liked to be told here whether the files I import will be
saved as part of the project, or whether the project is simply
referring to files external to itself.
e) Part 12.2. Only the Audio.
A minor proof-reading point: in "click the eye icon on the track",
you have two spaces in between "eye" and "icon".
f) 14.5. Speed Tab
"The advanced tab let's you set...": should be "lets".
g) 15.3. Manually
"The following properties are affected by key-frames: Height, Wight,
X, Y, and Alpha." Is there such a thing as "Wight" that I've never
heard of, or is that a typo for "Width"?
h) 18.4.3. Animate Each Title
"(as show in the illustration)": should be "shown". (But as I said
above, I didn't get any illustrations.)
i) Upload Video
"Choose a video file to upload to YouTube. Be sure it's a compatible
format with YouTube first, or it might not work correctly."
I'm guessing the Vimeo option was added later? I suggest "Choose a
video file to upload to YouTube or Vimeo. Be sure that your video's
format is compatible with the destination, or it might not work
correctly."
j) Layout of the help manual: where the page of info is shorter than
the index on the right, I would prefer not to have to move to the
bottom of the page before being able to click on the "next" link. I'd
like to have the next & previous links at the top as well. But I
don't know if you can do anything about that.
h.t.h. :-)
To manage notifications about this bug go to:
https://bugs.launchpad.net/openshot/+bug/1152895/+subscriptions
Follow ups
References