fix: aligned docs to the article template

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 -->

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 -->