Pauta conformance
Pauta is the set of guidelines Editora and its sibling apps follow, so they look and work the same on Windows, macOS and Linux. Each rule has an ID and a level: a MUST is required, a SHOULD is expected unless there is a stated reason.
Editora is working toward Pauta 6.0.1.
Pauta conformance: Partial. Editora does not meet every MUST of this edition yet: 16 are pending.
| Conformance | Means |
|---|---|
| Complete | Every MUST and every SHOULD is met, does not apply, or is a recorded deviation. |
| Core | Every MUST is met; one or more SHOULDs are still pending. |
| Partial | One or more MUSTs are still pending. The app says Working toward, not Built to. |
The conformance is worked out from the list below, never typed in, so it cannot claim more than the list shows. The same list is in the app: Help → Pauta Conformance opens it, and About names the edition and the conformance.
Pending
Rules Editora does not meet yet. Each one links the issue that tracks it. 32 rules: 16 MUST, 16 SHOULD.
| Rule | Level | What is different | Link |
|---|---|---|---|
ABOUT-01 | MUST | On macOS, About Editora is in the Help menu rather than the application menu. | #1574 |
CLI-07 | MUST | A launch with —disable-plugins starts a second Editora instead of handing over to the one already running. | #1570 |
CLI-11 | MUST | On Windows there is no console launcher, so command-line output does not appear in the terminal that started Editora. | #1570 |
DOCS-05 | MUST | The notes on a GitHub release are a list of commits rather than notes written for users. | #1557 |
ICON-16 | MUST | There is no theme that follows the system’s light or dark setting. | #1563 |
MENU-14 | MUST | Some menu rows have no icon. | #1566 |
PAUTA-13 | MUST | The user guide on the website has no page yet that lists this conformance and these exceptions. | #1554 |
REL-16 | MUST | The runnable jar downloads for Linux are not signed like the other Linux downloads. | #1578 |
REL-29 | MUST | Before a release, only the macOS build is started as packaged to confirm it launches. | #1578 |
SET-06 | MUST | Every setting has a command in the Command Palette except the terminal’s multi-line paste confirmation, which should be turned off only in the config file, and so should lose its Settings row rather than gain a command. | #1568 |
SET-13 | MUST | On a machine with no system keychain, AI API keys are kept in the settings file. | #1568 |
SET-16 | MUST | Whether plugins need a signed registry can be turned off from Settings and the Command Palette. | #1568 |
TABS-13 | MUST | The Terminal command gives an open terminal the keyboard before it hides it, so its stripe button does not run it, and the File Information and External Tools commands are not named after their windows. | #1565 |
TBAR-03 | MUST | Some buttons keep words of their own where they say more than their command’s title, such as Maximize or Restore on a tool window’s header. | #1564 |
WIN-03 | MUST | On Windows and Linux the menu bar sits below the title bar unless you turn on the extended window setting. | #1562 |
WIN-13 | MUST | Quitting from the macOS menu or Dock closes each window in turn instead of going through Editora’s own Quit. | #1562 |
ACC-07 | SHOULD | The release steps do not include a pass with a screen reader. | #1561 |
ACC-09 | SHOULD | There is no high-contrast theme, and the high-contrast setting of Windows is not followed. | #1561 |
CONF-07 | SHOULD | Editora asks before a few actions that can be undone, such as moving a file to the trash. | #1575 |
CONF-11 | SHOULD | The Force Push command can be run directly, without a rejected push first. | #1575 |
DOCS-04 | SHOULD | The website does not check on every build that its generated pages still match the app. | #1557 |
DOCS-18 | SHOULD | Screenshots for the website are not taken by a built-in capture at double resolution. | #1557 |
PAUTA-14 | SHOULD | The website’s conformance page is not generated from Editora’s own list of exceptions yet. | #1554 |
PLAT-14 | SHOULD | The snippets file is edited as text, to keep your comments, rather than read into typed data. | #1555 |
REL-04 | SHOULD | Release notes are not taken from the changelog. | #1578 |
REL-09 | SHOULD | The Linux app ID is com.editora.Editora rather than one under io.github. | #1578 |
REL-12 | SHOULD | Editora cannot be installed with Homebrew yet. | #1578 |
REL-13 | SHOULD | Editora cannot be installed with winget yet. | #1578 |
REL-14 | SHOULD | No access token for publishing to package managers is set up, since none is used yet. | #1578 |
REL-17 | SHOULD | The Windows installer is not signed. | #1578 |
REL-25 | SHOULD | A few automated build steps download Maven’s dependencies again instead of reusing a cache. | #1578 |
WIN-15 | SHOULD | On macOS, Settings is not in the application menu. | #1562 |