From f3c02cbe16844f8e76f9025e5977627cb1e262d0 Mon Sep 17 00:00:00 2001
From: Jerome Charaoui <jerome@riseup.net>
Date: Wed, 8 Dec 2021 11:57:58 -0500
Subject: [PATCH] add more details to blog docs

---
 service/blog.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/service/blog.md b/service/blog.md
index 3cfdd235..1494549d 100644
--- a/service/blog.md
+++ b/service/blog.md
@@ -6,7 +6,14 @@ title: Blog
 
 # Tutorial
 
-## How to write a new blog post
+## How to write a new blog post in GitLab
+
+The steps below describe how to create a new blog post directly via GitLab using
+the Web IDE for users unfamiliar with the `git` command-line client.
+
+Users comfortable with `git` are free to create and push a new branch to the
+repository directly, without using the Web IDE. In this case a Merge Request
+should still be created to allow the review process to occur.
 
 ### Enter the Web IDE
 
@@ -15,6 +22,9 @@ title: Blog
   * We'll create a new branch in the repository, so your account will require
     `Developper` permissions in the project
 
+  * If you're missing the permissions, please ask TPA. Opening a Merge Request
+    from a personal fork will cause CI to fail to deploy the preview
+
 #### 2. Click the `Web IDE` button just above the file listing
 
   * The GitLab Web IDE allows you to create a new commit right in your browser,
-- 
GitLab