It's a complete and utter mess. I added the dirty presets to it.
https://docs.krita.org/Loading_and_Saving_Brushes#The_Brush_Settings_Editor
Okay, here's an outline, help out by picking a section and add the text section as a comment, when adding images, use the new brush editor as a reference:
-----------------------
Loading and Saving Brushes
==========================
In the real world, when painting or drawing, you don't just use one tool. You use pencils, erasers, paintbrushes, different types of paint, inks, crayons, etcetera. All these have different ways of making marks.
In a digital program like Krita you have something similar. We call this a brush engine. And much like how cars have different engines that give different feels when driving, or how pencils make distinctly different marks than rollerbal pens, different brush engines have totally different feels.
The brush engines have a lot of different settings as well. So, you can save those settings into presets.
Unlike Photoshop, Krita makes a difference between brush-tips and brush-presets. Tips are only a stamp of sorts, while the preset uses a tip and many other settings to create the full brush.
The Brush settings dropdown
------------------------------------------------
To start, the Brush Settings Editor panel can be accessed in the toolbar, between the Blending Modes button on the right and the Patterns button on the left. Alternately, you can use the function key <keycap>f5</keycap> to open it. With the panel open you can right-click and detach it from the toolbar if you wish. This is useful if you have dual monitors and want to leave it open for quick access. It is also useful, although not required, if, with a dual monitor setup, you want to use the Multi-use Brush option described later.
When you open Brush Settings Editor panel you will see something like this:
### Tour of the brush settings dropdown
#### Engine
The engine of a brush is the underlying programming that generates the stroke from a brush. What that means is that different brush engines have different options and different results. You can see this as the difference between using crayons, pencils and inks, but because computers are maths devices, most of our brush engines produce different things in a more mathematical way.
For most artists the mathematical nature doesn't matter as much as the different textures and marks each brush engine, and each brush engine has it's own distinct flavor and use, and can be further customized by modifying the options.
#### Options
The options, as stated above, are different per brush engine. These represent the different parameters, toggles and knobs that you can turn to make a brush preset unique. For a couple of options, the main things to change are sliders and checkboxes, but for a lot of them, they use curves instead.
#### Using sensor curves
One of the big important things that makes art unique to the artist who created it is the style of the strokes. Strokes are different because they differ in speed, rotation, direction, and the amount of pressure put onto the stylus. Because these are so important, we would want to customise how these values are understood in detail. The best way to do this is to use curves.
!NEEDSMORE!
#### Miscelaneous options
Temporarily Save Tweaks to Preset (Dirty Presets)
: This enables dirty presets. Dirty presets store the tweaks you make as long as this session of Krita is active. After that, the revert to default. Dirtied presets can be recognized by the icon in the top-left of the preset.
Eraser Switch Size
:This switches the brush to a separately stored size when using the eraser(E) key.
Eraser Switch Opacity
: Same as above, but then with Eraser opacity.
Instant Preview
: This allows you to toggle instant preview on the brush.
#### Scratchpad
When you tweak your brushes, you want to be able to check what each setting does. That's why, to the right of the settings dropdown, there is a scratchpad. The scratchpad is also where Krita will get the brush icon for new brushes. In particular, it will crop the scratchpad to the dotted square at the top.
The scratchpad has four buttons underneath it. These are in order for: showing the current brush image, adding a gradient to the scratchpad(useful for smudge brushes), filling with the background color, and finally deleting everything on the scratchpad.
###The On-canvas brush settings
Making a Brush Preset
-------------------------------------
### Getting a default for the brush engine.
### Example: Making an inking brush
### Saving the new Brush
### Painting the preset icon.
Making a Brush Tip
-------------------------------
Maybe link to the brush-tip resources page here and have that deal with importing/stamps/animated brushes?
Sharing Brushes
---------------------------
Okay, so you've made a new brush and want to share it. There's several ways to share a brush preset.
First, go to
### Sharing a single KPP file
#### Exporting the file.
#### Importing a single KPP file.
### Sharing via ZIP(old fashioned)
#### Creating a ZIP file with the relevant files.
#### Using a ZIP with the relevant files.
### Making a resource bundle
#### Making a resource bundle within Krita
#### Editing a resource bundle within Krita
#### Importing a resource bundle into Krita