For Editors

Target group: Editors

How to use the extension from the perspective of an editor.

Think of common tasks that an editor is likely to perform in your extension.

  • How do they complete them?
  • What problems are they likely to encounter?
  • What access do they require?
  • What configuration options are available to them?

One example could be adding a frontend plugin to a page and then configuring it.

Language should be non-technical, aim to avoid using acronyms where possible.

Be mindful that editors typically dont have administrative access to the installation.

Tip

Take a break from time to time.

Admonitions should be used to warn the users about potential pitfalls, attract their attention to important elements or just add some notes for for information (further reading, for example).

Important

Do not overuse admonitions like notes, important, etc.!

Provide screenshots as needed for making things clear. When creating screenshots, try using the Official Introduction Package.

Backend view

Default Backend view (caption of the image)

Important

Do not use huge full-screen images, unless it is necessary and serves a good purpose.

FAQ

Possible subsection: FAQ