From fdd01bbc51ac13b734dd87d3efd6653ed8c9dc79 Mon Sep 17 00:00:00 2001 From: contrapunctus Date: Sun, 23 Jan 2022 16:36:59 +0530 Subject: [PATCH] Place format description under Explanation --- README.org | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.org b/README.org index 91826df..bfc5db3 100644 --- a/README.org +++ b/README.org @@ -18,7 +18,8 @@ It is hoped that these tools will 1. make documentation more accessible to users 2. make more projects aware of the [[https://diataxis.fr/][Diataxis Framework]], and incentivize them to structure their documentation according to its suggestions, which in turn would make their documentation easier to read, write, and maintain. -* Creating the file +* Explanation +** The DocSpec format Below is what an example DocSpec file for the [[https://github.com/McCLIM/McCLIM/][McCLIM]] project might look like. Each DocSpec file can list up to four types of documentation as symbols - =tutorial=, =howto=, =explanation=, and =reference=.