Krita 4.0 manual head tasks.
Closed, ResolvedPublic

Description

Writing manual items for 4.0.

Okay, if you want to help write manual items, get a fresh copy of krita:
https://binary-factory.kde.org/job/Krita_Nightly_Build/
And start playing with the features.

We'll discuss on january 2 how exactly we're gonna do this.

We will need to create pages for the following:

Vector

Brushes

T3724 - Rewrite introduction to brushes page. (adjustments to the curves widget go here) Needs Screenshots Needs Proofreading

  • - Retake screenshots for the krita brush-tips category, as well as the brushes pages. Needs Screenshots
  • - Masked Brush page. - https://docs.krita.org/Masked_Brush Needs Writing/Screenshots
  • - Instant preview adjustments.
  • - Texture adjustments.
  • - Note that the pixel brush is multithreaded and that the default brush is the fastest of the multithreaded brush tips.

Python Scripting

Palette

Colorize mask

Preferences

Filters:

Layers

  • - New file layer goodies.

Other:

woltherav triaged this task as High priority.
woltherav updated the task description. (Show Details)Dec 31 2017, 1:01 PM
woltherav updated the task description. (Show Details)Jan 1 2018, 10:48 AM
woltherav updated the task description. (Show Details)Jan 1 2018, 10:55 AM
woltherav updated the task description. (Show Details)Jan 1 2018, 11:50 AM
woltherav updated the task description. (Show Details)Jan 1 2018, 1:22 PM

Did some basic work on the vector tools already.

woltherav updated the task description. (Show Details)Jan 2 2018, 12:53 PM

Okay, the vector tool pages need to be read over to ensure that they are coherent and they need screenshots. Lots and lots of screenshots.

woltherav updated the task description. (Show Details)Jan 4 2018, 12:32 PM
woltherav updated the task description. (Show Details)Jan 4 2018, 12:55 PM
woltherav updated the task description. (Show Details)Jan 4 2018, 1:34 PM
woltherav updated the task description. (Show Details)
woltherav updated the task description. (Show Details)Jan 4 2018, 1:58 PM
woltherav updated the task description. (Show Details)Jan 4 2018, 2:26 PM

Okay, did edge detection filters, updated the text tool with the text tool options, and the the tool options for the colorize mask. This one still needs the usage section updated, but I'll need to dig up a nice image for that.

woltherav updated the task description. (Show Details)Jan 4 2018, 8:11 PM
woltherav updated the task description. (Show Details)Jan 5 2018, 1:47 PM
woltherav updated the task description. (Show Details)Jan 5 2018, 4:03 PM

on https://docs.krita.org/Introduction_to_Python_Scripting

import sys

is not necessary in the code samples

on https://docs.krita.org/How_to_make_a_Krita_Python_plugin

In the section "Getting Krita to recognise your plugin"
I think it would be helpful to:

  • reword the quote from the API docs into separate bullet points and cross reference the API docs. I think people are apt to skip over a quote/ not realise the significance.
  • make the directory structure clear - eg a screenshot with a treeview showing the desktop file relative to the directory/script contents.

In the section "Creating an extension" it would be helpful to refactor the existing code as a skeleton extension/desktop file that people can copy/paste from the body of the text. Alternatively have a skeleton script packaged into the resources directory on install.

The page should also refer to the Python scripting conventions page, perhaps as a dangling reference if it's not completed yet.

brendanbd added a comment.EditedJan 16 2018, 5:27 AM

On both pages
python -> Python
Me editing a comment
woohoo!

For things (like resources) where you need to already know the resource type in order to get the resources include a list of what strings will work.

... Brendan, you know you can edit comments on here, right? Just press the down arrow to the right.

I am not touching the resources API docs for now because I am waiting for a review of adjustments to that. The API isn't stable yet.

For the other things, can you post examples, because I am completely unable to tell how you are imagining things here? Like, how much more skeleton can the examples get? And of course, you too can create screenshots.

I did some edits to the intro para of one of those pages.

I'm not sure what the rules are for naming the .desktop file. Does the name make a difference?

woltherav updated the task description. (Show Details)Feb 14 2018, 2:23 PM
woltherav updated the task description. (Show Details)Feb 14 2018, 3:13 PM
woltherav updated the task description. (Show Details)Feb 14 2018, 3:56 PM
woltherav updated the task description. (Show Details)Feb 14 2018, 4:04 PM
woltherav updated the task description. (Show Details)Feb 15 2018, 4:13 PM
woltherav updated the task description. (Show Details)Feb 15 2018, 4:50 PM

Okay, I have written everything but the masked brushes page. Most pages now need screenshots more than writing.

woltherav updated the task description. (Show Details)Feb 21 2018, 3:49 PM
woltherav updated the task description. (Show Details)Feb 24 2018, 2:10 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 1:57 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 2:24 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 3:23 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 3:36 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 4:58 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 5:08 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 5:14 PM
scottpetrovic updated the task description. (Show Details)Mar 9 2018, 5:55 PM
woltherav closed this task as Resolved.

I am calling this formally done!