From 28aebb06b89887a2caf880b6014ac4db4ce2ce7e Mon Sep 17 00:00:00 2001
From: Daiki Mizukami <tesaguriguma@gmail.com>
Date: Wed, 23 Oct 2024 17:37:17 +0000
Subject: [PATCH] FEP-a4ed: Replace the ASCII diagram with Mermaid (#394)

This patch replaces the ASCII diagram with a [Mermaid] diagram in order to improve accessibility for screen readers/braille displays and devices with narrow viewport width.

[Rendered](https://codeberg.org/tesaguri/fep/src/branch/fep-a4ed-mermaid/fep/a4ed/fep-a4ed.md#the-fediverse-enhancement-proposals-process)

While rendering Mermaid diagram isn't part of CommonMark 0.29 spec used by the FEP process, this uses the standard code fence syntax and isn't extremely unreadable as plaintext, so I believe it's acceptable in that regard.

[Mermaid]: <https://docs.codeberg.org/markdown/introduction-to-markdown/#mermaid-diagrams>

Reviewed-on: https://codeberg.org/fediverse/fep/pulls/394
Reviewed-by: silverpill <silverpill@noreply.codeberg.org>
Reviewed-by: Arnold Schrijver <circlebuilder@noreply.codeberg.org>
Reviewed-by: helge <helge@noreply.codeberg.org>
Co-authored-by: Daiki Mizukami <tesaguriguma@gmail.com>
Co-committed-by: Daiki Mizukami <tesaguriguma@gmail.com>
---
 fep/a4ed/fep-a4ed.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/fep/a4ed/fep-a4ed.md b/fep/a4ed/fep-a4ed.md
index 37b78de..1c51ae7 100644
--- a/fep/a4ed/fep-a4ed.md
+++ b/fep/a4ed/fep-a4ed.md
@@ -85,18 +85,18 @@ Fediverse Enhancement Proposals must be placed in the public domain by the autho
 
 ## The Fediverse Enhancement Proposals Process
 
-```
-                                     +-------+
-                           +-------> | FINAL | 
-                           |         +-------+
-         +-------+         |
--------->| DRAFT | --------+
-         +-------+         |
-             ^             |         +-----------+
-             |             +-------> | WITHDRAWN |
-             |                       +-----------+
-             |                             |
-             +-----------------------------+
+```mermaid
+stateDiagram-v2
+    accTitle: FEP process flowchart
+    accDescr {
+        The process begins from the "DRAFT" status, followed by either of the "FINAL" or "WITHDRAWN" status.
+        The "WITHDRAWN" status can go back to the "DRAFT" status.
+    }
+    [*] --> DRAFT
+    DRAFT --> FINAL
+    DRAFT --> WITHDRAWN
+    WITHDRAWN --> DRAFT
+    FINAL --> [*]
 ```
 
 1. A Fediverse Enhancement Proposal can be submitted by individuals or groups of individuals (authors). See the `SUBMISSION.md` file for a list of accepted submission methods.