From 976e41bc93c8740d09663e771eadcf5cbad97a4a Mon Sep 17 00:00:00 2001
From: constantinos <c.miltiadis@gmail.com>
Date: Mon, 14 Aug 2023 17:50:50 +0300
Subject: [PATCH] removed filename section

---
 content/article/int-conventions.md | 63 ++++++++++++------------------
 1 file changed, 25 insertions(+), 38 deletions(-)

diff --git a/content/article/int-conventions.md b/content/article/int-conventions.md
index b3bde43..d2b749a 100644
--- a/content/article/int-conventions.md
+++ b/content/article/int-conventions.md
@@ -7,15 +7,22 @@ draft: false
 keywords:
   - internal
 abstract: |
-  Conventions for filenames, etc. 
+  List of conventions to follow.  
+  Leave `draft: true`
 ---
 
-# Dates 
+# Date format
 
 > DD.MM.YYYY 
 
-as in 13.05.1998. In general, day first. 
+as in 13.05.1998. 
 
+
+# File naming conventions 
+
+For file-naming conventions see ![Content creation instructions](article:int-content). 
+
+<!--
 # File naming conventions 
 
 - All **lowercase**
@@ -27,15 +34,15 @@ as in 13.05.1998. In general, day first.
 |-|-|-|
 | contributor | name-surname.md | `hugo new contributor/name-surname.md`| 
 | editor | name-surname.md | `hugo new editor/name-surname.md` | 
-| issue | issue-x.md | `hugo new issue/issue-x.md` | 
+| issue | issue-x.md* | `hugo new issue/issue-x.md` | 
 | article | article-short-title.md | `hugo new article/article-short-title.md` | 
-| print (issue)\* | p-issue-x.md | `hugo new print/p-issue-x.md` | 
+| print (issue)\** | p-issue-x.md | `hugo new print/p-issue-x.md` | 
 | print (article)\*\* | p-article-short-title.md | `hugo new print/p-article-short-title.md` | 
 
 \* where x is issue number   
-\*\* creating a new print file can  break the site, until 
-# Files intended for *Internal* use  
-
+\*\* creating a new print file can  break the site if (a) the `print: ` target points to an inexistent file, or if (b) a public print item points to a non-published target.   
+-->
+# 'int-' prefix for files intended for *Internal* use  
 
 Files purposed to be for internal use, and are *not public facing*: 
 - start with `int-` , like this file `int-conventions.md`
@@ -43,41 +50,21 @@ Files purposed to be for internal use, and are *not public facing*:
 Their header file: 
 - features the keyword `internal`
 - the draft flag is set to true, as in `draft: true` 
+- suffix the abstract with: Leave `draft: true`
 
 # Images and attachments 
 
-> static/issue-x/author/image.png
 
-<!--
-# File naming conventions 
+Place images or other attachments related to a specific article in the appropriate subdirectory inside the `root/static/` folder as in:
 
-Filenames are all lowercase. No spaces, no underscores, only dashes. 
+```
+static/issue-x/author/image.png
+```
 
-# Contributors, Editors
+So that it can be referenced from an article like so: 
 
-> name-surname.md
+```
+![Image caption](/issue-x/author/image.png "optional mouse over/alt text")
+```
 
-as in `pippin-bar.md` 
-
-To create a new contributor do: 
-> hugo new contributor/name-surname.md
-
-## Issues 
-
-> issue-x.md 
-
-where x is the issue number: 
-- issue-5.md
-
-To create a new issue do: 
-> hugo new issue/issue-x.md
-
-## Print files 
-
-Print files correspond to issues or articles. 
-
-> hugo new print/p-issue-5.md
-
-or 
-> hugo new print/p-article-name.md
--->
\ No newline at end of file
+*Note: When refencing an image or file provide a file path starting with a slash (`/`), and omit `static`.* 
\ No newline at end of file