Help us complete the User Manual!

Tags: #<Tag:0x00007f14c43625b0> #<Tag:0x00007f14c4362470> #<Tag:0x00007f14c4362330>


Are you a good writer or tutorial maker?

The MyPaint User Manual needs to be improved and completed for the 1.2.0 release. You may be able to help a lot of people by showing off what you know!

:family: Anyone can help MyPaint improve! Volunteer contributions are how we grow.
:point_right: Got writing or tutorial skills? Start documenting today!

We’d be really interested in having lots of screenshots and video tutorials of real artists using MyPaint for real work.


Our user manual is housed on the MyPaint wiki, and it’s really easy to add to a page or correct any incorrect information on it once you have a GitHub account set up. We have a few documentation conventions evolving for the manual already: see the page linked above for details. I’ll be keeping it up to date, since it’s a prime source of information for new contributors.

If you’re shy about editing wikis, or want some copy checking or fact verification first, please post or link your contributions below. I’m happy to look over anything you send in.

So what needs to be done?

Right now, we need all of the topics to have something basic written. I’ve dived in already and written up some of the newer features, but let’s turn all that red text blue:

We probably don’t need an exhaustive trawl through all of the menus, or really even pictures of them.

There’s a very outdated user manual already in the wiki: User Manual v0.9.0. Texts can be lifted from that, updated, and reused in the new manual.

Tutorial screenshots & videos

We really want screenshots for the new manual. If you’ve got a 2 minute YouTube video, 10s GIF capture, or a static screencap of some feature that needs explaining, please link it or upload it here and tell us how it should be included. The important thing is to keep video demonstrations short and sweet. No hour-long rambles please! People hate that, so it’s a good idea to give people an idea of watching time up front.

How should we document tricks and techniques for artists to use? Here’s where I need your feedback. I guess… speedpaint videos? Worked, step-by-step tutorials?

Detailed technical references

Improving documentation for the ordinary user and making pages about UI stuff is a good start, but some topics are going to need some heavy technical detail and comparisons of alternatives.

  • Layer Modes mostly done!
    • Can we make the table more user-friendly?
    • The linked example thumbnails in the comparison don’t shrink nicely on every browser. Make them smaller?
    • Do those categories make sense to everyone?
    • Should we link to the mode definitions in the W3C reference?
  • Something similar would be wonderful for MyPaint’s (very complex) brush settings.
    • Let’s have visual examples of what each setting does.
    • Documenting inputs like tilt may need photographs!
    • We probably don’t need a comparison chart.
    • Need to make the distinction between settings and inputs as clear as we can.
    • Basic brush engine concepts are currently documented on the wiki: Concepts. Check out the old screenshots! This page needs updating too, but maybe it could be rewritten as a user manual page?

Does anyone need any more of the super-detailed stuff?


Contributions for the wiki are ideally public domain, but screenshots can have exceptions provided they have a clear watermark and the license is sufficiently liberal. If your resource is a link, like a video or something, you’d obviously retain copyright. Just keep it online if it’s going in the manual, please!

Posting some text here? Please make it clear you want PD republishing, because this board has its own license (to allow us to store it, and to allow people to read it… people get so fussy about legal things!) The best way for stuff that’ll end up in the wiki is a CC0 waiver like:

To the extent possible under law,
has waived all copyright and related or neighboring rights
to this [text/post including images/work].

Cut/paste/modify, and then we can reuse it on the wiki straight away.


Well, I tried for half an hour and didn’t get it:

I see that the images of "Layer Modes " are in a nice location, but I can’t figure out how I get my images there, too. Google has strange advices like “hack the issue system to store images” or “drag and drop on the image link address field” (no)…

I quickly made some for the brush modes:


Thanks! Quick answer: only project members can use the wiki itself for direct storage, but there’s the quick workaround you found of abusing the Github issues system uploader. We’ve even recommended that in the wiki’s “how to document” pages. We say:

If you need to put screenshots or diagrams on a wiki page, you’ll notice that there is no upload button. The image button in the editor asks for an image URL instead. There’s a workaround for this roadblock though: host wiki images on GitHub’s content network. You can use a dirty, but well-known trick do do this: use the issue editor as an image uploader. Start composing a new Github issue, then drag your image file into the issue’s editor. You can then cut and paste the resulting Markdown into the wiki editor.

Sometimes you’ll see images hosted within the wiki itself, linked with double square brackets. This is OK, but it isn’t recommended for new users.

When that was written you had to drag and drop, like in the forums. Now you can click on a “selecting them” link and get a proper file dialog.

It’s the fragment of markdown that looks like the one above that you want to copy and paste. That works in the wiki.


Thanks, this works. :bee:
I spammed a lot of pages into the wiki. Mainly those that have been “red”. But also some “new” ones, notably a section about colour. There is a bit of redundancy on the index page (e.g. “palette” in colour and in dockpanels), but the pages themselves aren’t duplicates.
Some wording and formatting might not be consistent yet…


Whoa, thank you for the big contribution there! I’ve just had a look, and I love the animated explanations in the new Lines and Curves doc especially. Also, the side bar seems to be much more useful all of a sudden!