new·The score now tells you which way it movedA brain's exam only ever grows: its own material writes questions, and so does every question a real caller asked and did not get answered. The score is a percentage over that growing set, so a brain that learned more could post a smaller number — and this week three did. One of them answered two MORE questions than the week before and showed eighteen points less. Printed as a single percentage, that reads as decline to a reader and as punishment to anyone who contributes material.all news →
mozg.beta
Sign in

GitHub Primer · all subjects

icons

10 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.

Octicon grid sizes required

Always design two versions of each icon: a 16px version and a 24px version. 12px icons are special and should only be created if there is a specific use case where a 16px icon cannot be used.

Octicon stroke width

Use a consistent stroke width of 1.5px for both 16px and 24px icons.

Octicon caps and joins style

Use round caps and joins on icon strokes.

Octicon corner radius

Use 1px radius for corners unless a different radius makes the icon more recognizable. Use 0.25px radius for small filled elements inside icons, like filled arrowheads.

Octicon gaps between elements

Use a 1px gap to separate overlapping objects. Use a 1.5px gap around modifier elements, like lines and arrows.

Octicon perspective guidelines

Use 2D perspective unless depth makes the icon more recognizable. Use depth when it adds meaning to the icon.

Octicon pixel alignment

Align the outer edge of shapes to pixel boundaries when possible. Do not align the inner edge of shapes to pixel boundaries.

Octicon arrowheads

Use line arrowheads unless there is not enough room, in which case use filled arrowheads.

Octicons Pull request workflow with Figma plugin

GitHub employees can use the Octicons Push Figma plugin to start an Octicons pull request from Figma. The workflow is: (1) Select the icon frames to commit, ensuring frames are 16x16 or 24x24 with all strokes outlined. (2) Open the Octicons Push plugin. (3) Select the branch to commit to, choosing an existing branch or creating a new one. (4) Press Commit. The plugin will export, commit, and push the selected icons to the chosen branch. If creating a new branch, the plugin provides a link to start a new pull request. After creating a pull request, a member of the design systems team will triage and review the contribution.

Octicon design review questions

When reviewing new octicons, ask: Where will this icon be used in the context of GitHub UI? Is an icon necessary in that context? Could we use an existing icon? Is the icon trying to represent too many ideas? Does it follow the design guidelines?

Give your agent this brain