861377 - Provide good documentation for gfx/layers

Status: NEW

(Core :: Graphics, defect)

Description

[Nicolas Silva [:nical]]

Layers should be as easy to understand as possible, and to that end we need good inline code documentation.

This means: 
 - defining good documentation guidelines
 - identifying parts of the code that lack documentation
 - identifying parts of the code that have documentation but it is not complete or understandable enough
 - updating documentation for these parts of the code

Comment 1

[Nicolas Silva [:nical]]

Let's also update the wiki for the high level and "historical" aspects of the design

Comment 3

[BugBot [:suhaib / :marco/ :calixte]]

The severity field is not set for this bug.
:bhood, could you have a look please?

For more information, please visit BugBot documentation.