Several corrections, and further suggestions #104607

New Issue

Molaskes · 2023-10-27T08:45:23+02:00

Molaskes commented

2023-10-27 08:45:23 +02:00

Page Information
File: manual/editors/video_sequencer/sequencer/navigating.rst
Blender Version: 3.6
Documentation Language: en
Permanent Link

Short description of error

As usual, the View Menu controls the editor’s view settings.

In a manual, there should be no "As usual", it is condecending and not the right style to use in manuals. After all, it may be the first page the reader ever opens in the manual.

The View Menu section lacks the Tool Settings option (comes after "Sidebar").

The Vie Menu section lacks the Refresh All option is listed after "Set Frame Range to Strips", but in the software, it comes already after "Limit View to Contents". (A consistency issue, the section should thus be moved up on the page to match the actual menu to not confuse new users.)

In the Jump to Previous Strip section, the description reads:

Current frame will jump to beginning of strip.

I haven't verified this yet myself, but maybe someone with Blender experience may check this again: Is this actually the behavior (which would make the option a misnomer)? Or should it rather read "[...] to beginning of previous strip, if such exists, else to the begiining of the current strip."

In the Jump to [Previous|Next] Strip (Ceter) sections, the descriptions read:

Jump to [previous|next] center of the strip.

This should be replaced with: "Like Jump to [Previous|Next] Strip, but centering the view at the new current frame." (Assuming this is the behavior, which I also haven't checked yet, being new to Blender, just reading the Manual cover to cover testing most, but not all, described actions.)

The "Refresh All" section ends on

If an image or video, used as a strip, is changed by some application outside of Blender, Blender has no real way of being notified from your operating system.

Actually, one could program a polling check for greater convenience, i.e. test file modification timestamps (and/or file sizes) of all used files in regular intervals that do not unduly hamper Blender's performance but are frequent enough for the human user to see changes quite promptly, e.g. once a second or even every 3 seconds might suffice. If such a solution were to be programmed, the sentence above could be removed, and maybe the whole Refresh All function from the software altogether.

Synchronize the visible range with other time based editors.

Correct to: "[...] time-based editors." (add a dash)

Render timeline from Preview Start to Preview End Frame to a Video file or series of images.

Here, "video file" should be in all lowercase.

In the Main View > Adjusting the View section, there it reads:

Vertical Scroll: use Shift-Wheel, or drag on the left scrollbar.

However, the scrollbar is to the right, and thus should the description be corrected.

The Playhead section starts with:

The Playhead is the blue vertical line with the current frame number at the top.

This could be improved to: "[...] with the current frame number (or time index) at the top." (Time mode may even be the default, but I'm not sure of that.)

In the Playhead section,

in scrubbing area at the top of the timeline.

should be corrected to "in the scrubbing area [...]" (insert "the").

In the Playhead section,

When holding Ctrl while dragging it will snap to the start and endpoints of strips.

should be corrected to "Holding Ctrl while [...]" (do away with the ungrammatical "When").

At the end of the Playhead sequence,

mage sequence or movie (avi/mov) file.

May need to be updated, as I suppose *.avi and *.mov may have been the only options in Blender once, but nowadays there are most likely plenty more, and in fact neither .avi nor '.mov may be the most frequently used today. Maybe thus give a list of the most common formats here, ending with an ellipsis, such as: "(avi/mov/mp4/wmv/...)". Make sure the formats are supported though (I haven't checked them myself).

The Hint box at the end of the page reads:

Every other synced editor can be used for scrubbing e.g. the Timeline.

Here, a comma should be inserted: "[...] for scrubbing, e.g. the Timeline."

**Page Information** File: `manual/editors/video_sequencer/sequencer/navigating.rst` Blender Version: `3.6` Documentation Language: `en` [Permanent Link](https://docs.blender.org/manual/en/3.6/editors/video_sequencer/sequencer/navigating.html) **Short description of error** > As usual, the View Menu controls the editor’s view settings. In a manual, there should be no "As usual", it is condecending and not the right style to use in manuals. After all, it may be the first page the reader ever opens in the manual. The View Menu section lacks the Tool Settings option (comes after "Sidebar"). The Vie Menu section lacks the Refresh All option is listed after "Set Frame Range to Strips", but in the software, it comes already after "Limit View to Contents". (A consistency issue, the section should thus be moved up on the page to match the actual menu to not confuse new users.) In the Jump to Previous Strip section, the description reads: > Current frame will jump to beginning of strip. I haven't verified this yet myself, but maybe someone with Blender experience may check this again: Is this actually the behavior (which would make the option a misnomer)? Or should it rather read "[...] to beginning of previous strip, if such exists, else to the begiining of the current strip." In the Jump to [Previous|Next] Strip (Ceter) sections, the descriptions read: > Jump to [previous|next] center of the strip. This should be replaced with: "Like Jump to [Previous|Next] Strip, but centering the view at the new current frame." (Assuming this is the behavior, which I also haven't checked yet, being new to Blender, just reading the Manual cover to cover testing most, but not all, described actions.) The "Refresh All" section ends on > If an image or video, used as a strip, is changed by some application outside of Blender, Blender has no real way of being notified from your operating system. Actually, one could program a polling check for greater convenience, i.e. test file modification timestamps (and/or file sizes) of all used files in regular intervals that do not unduly hamper Blender's performance but are frequent enough for the human user to see changes quite promptly, e.g. once a second or even every 3 seconds might suffice. If such a solution were to be programmed, the sentence above could be removed, and maybe the whole Refresh All function from the software altogether. > Synchronize the visible range with other time based editors. Correct to: "[...] time-based editors." (add a dash) > Render timeline from Preview Start to Preview End Frame to a Video file or series of images. Here, "video file" should be in all lowercase. In the Main View > Adjusting the View section, there it reads: > Vertical Scroll: use Shift-Wheel, or drag on the left scrollbar. However, the scrollbar is to the right, and thus should the description be corrected. The Playhead section starts with: > The Playhead is the blue vertical line with the current frame number at the top. This could be improved to: "[...] with the current frame number (or time index) at the top." (Time mode may even be the default, but I'm not sure of that.) In the Playhead section, > in scrubbing area at the top of the timeline. should be corrected to "in the scrubbing area [...]" (insert "the"). In the Playhead section, > When holding Ctrl while dragging it will snap to the start and endpoints of strips. should be corrected to "Holding Ctrl while [...]" (do away with the ungrammatical "When"). At the end of the Playhead sequence, > mage sequence or movie (avi/mov) file. May need to be updated, as I suppose *.avi and *.mov may have been the only options in Blender once, but nowadays there are most likely plenty more, and in fact neither *.avi nor '*.mov may be the most frequently used today. Maybe thus give a list of the most common formats here, ending with an ellipsis, such as: "(avi/mov/mp4/wmv/...)". Make sure the formats are supported though (I haven't checked them myself). The Hint box at the end of the page reads: > Every other synced editor can be used for scrubbing e.g. the Timeline. Here, a comma should be inserted: "[...] for scrubbing, e.g. the Timeline."

Molaskes added the

labels 2023-10-27 08:45:24 +02:00

Matthew Hinson commented

2024-04-04 16:30:27 +02:00

Most of these have already been fixed in the meantime - I still addressed the View menu's "As usual" and the Playhead's "current frame number."

Matthew Hinson added