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
------------------------------------------------
### Tour of the brush settings dropdown
#### Engine
#### Options
#### Using sensor curves
#### 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 recognised 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
---------------------------
### 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