From 6d88bd617b4cabceef4bd14dfad01f24f3f4c05b Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Tue, 6 Jun 2023 20:53:21 +0200
Subject: [PATCH] fix: aligned docs to the article template

---
 knowledge base/pocl.md    |  8 +++++---
 knowledge base/portage.md | 23 ++++++++++++++++++++---
 2 files changed, 25 insertions(+), 6 deletions(-)

diff --git a/knowledge base/pocl.md b/knowledge base/pocl.md
index 49ead65..d58a6cb 100644
--- a/knowledge base/pocl.md	
+++ b/knowledge base/pocl.md	
@@ -1,10 +1,10 @@
 # PoCL
 
-PoCL is a portable open source implementation of the 1.2 OpenCL standard.
+Portable open source implementation of the 1.2 OpenCL standard.
 
 Upstream PoCL currently supports various CPUs, NVIDIA GPUs via libcuda, HSA-supported GPUs and TCE ASIPs (experimental, see: OpenASIP).
 
-PoCL uses Clang as an OpenCL C frontend and LLVM for kernel compiler implementation, and as a portability layer.
+PoCL uses Clang as an OpenCL C frontend, and LLVM for kernel compiler implementation and as a portability layer.
 
 ## Table of contents <!-- omit in toc -->
 
@@ -18,8 +18,10 @@ PoCL uses Clang as an OpenCL C frontend and LLVM for kernel compiler implementat
 <!-- project's references -->
 [website]: http://portablecl.org/
 
-<!-- internal references -->
+<!-- in-article references -->
 [further readings]: #further-readings
+
+<!-- internal references -->
 [opencl]: opencl.md
 
 <!-- external references -->
diff --git a/knowledge base/portage.md b/knowledge base/portage.md
index 3446a26..7a44aa8 100644
--- a/knowledge base/portage.md	
+++ b/knowledge base/portage.md	
@@ -1,5 +1,11 @@
 # Portage
 
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+1. [Sources](#sources)
+
 ## TL;DR
 
 ```sh
@@ -9,13 +15,24 @@ sudo emerge --depclean --ask
 sudo emerge -qv --update --deep --newuse --with-bdeps=y -a @world
 
 # Show what portage features are currently active.
-portageq envvar FEATURES | xargs -n1
+portageq envvar 'FEATURES' | xargs -n1
 ```
 
+## Further readings
+
+- [Portage]
+- [/etc/portage]
+
 ## Sources
 
-- [/etc/portage]
-- [Portage]
+All the references in the [further readings] section, plus the following:
 
+<!-- project's references -->
 [/etc/portage]: https://wiki.gentoo.org/wiki//etc/portage
 [portage]: https://wiki.gentoo.org/wiki/Portage
+
+<!-- in-article references -->
+[further readings]: #further-readings
+
+<!-- internal references -->
+<!-- external references -->