Manual: Timeline Docker - Edit and Update for v4.1
ClosedPublic

Authored by emmetoneill on Jun 9 2018, 12:38 AM.

Details

Summary

(This commit contains binary images. Is that fine?)

+ Updated Timeline_docker image.
+ Added new Timeline_insertkeys image.
+ Added brief intro to the Timeline Docker before the overview "map" image and legend.
+ Fleshed out edited and updated information about each section of the docker and the usage.
+ Added info about the new visualization of frames/blanks/holds.
+ Added info about the new insert multiple frames/columns feature.
+ Added some info about audio.
+ Fixed a bug which had swapped the labels for the menu and zoom/resizer handle.

~ Split the middle section under a "usage" header.
~ Pushed the GUI Actions content to the bottom to keep all of the text body together.
~ I changed the order of some of the elements in the legend, as the updated image is labeled in a slightly different order.

I haven't configured sphinx yet, so I wasn't haven't actually built these changes. I assume they're fine, as a played it pretty close to what was already there. But it's possible that I added whitespace and things that may affect the formatting in an undesirable way. Let me know if there is anything I need to change, add, or even remove! =]

Test Plan

Check for spelling, word-choice, and grammar mistakes. Check for any content omissions or inaccurate descriptions. Check built formatting!

Diff Detail

Repository
R1012 Krita.org Documentation Website
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.
emmetoneill created this revision.Jun 9 2018, 12:38 AM
Restricted Application added a reviewer: Krita: Manual. · View Herald TranscriptJun 9 2018, 12:38 AM
emmetoneill requested review of this revision.Jun 9 2018, 12:38 AM

Spelling and grammar fixes.

Okay, added some comments. Looks good in general though.

reference_manual/dockers/timeline.rst
19

See if replacing Animation Docker with :ref:animation_docker might be a better idea. The latter is the label set to the animation docker page and thus will link to it!

27

Layers Header, doesn't a header imply something horizontal at the top? Maybe Layer List is better?

34

This should be tabbed to avoid interupting the list.

We can actually replace each time it does '#. A' with 'A.' to turn it into a lettered-ordered list, but that might be a bit finicky to do if you haven't got Sphinx running.

68

it doesn't make much sense to use kbd for drag and drop, does it? It's really intended for textual input.

88

Underlines should always be at the least as big as the text they're underlining. Sphinx will give errors if this is not the case.

Installed Sphinx. It was super easy to get working (on Linux, at least), just install and build. Overall Sphinx has been great to work with! Much improved workflow, in my opinion.

Anyway, I went ahead and made the changes you suggested and I made a few other minor edits and improvements. I also made sure that all of the GUI Commands were up to date. I used the ":kdb:" tags for some of the mouse gestures like "drag" just to maintain a consistent look, which is a little weird, but it works.

Let me know if I should make any more changes!

woltherav accepted this revision.Jun 10 2018, 2:52 PM

I'll go and push this.

This revision is now accepted and ready to land.Jun 10 2018, 2:52 PM
This revision was automatically updated to reflect the committed changes.
emmetoneill marked 5 inline comments as done.Jun 11 2018, 5:44 AM

Ok, thanks for the help!