diff --git a/howto/code/linting.rst b/howto/code/linting.rst
index 9550d54..84e3692 100644
--- a/howto/code/linting.rst
+++ b/howto/code/linting.rst
@@ -21,8 +21,9 @@
     UNSTABLE=                     Build targets prone to failure (lint-helm)
 
     [PYTHON]
-    lint-flake8                   Syntax check using pylint and flake8
-    lint-pylint                   Syntax check using pylint and flake8
+    lint-python                   Syntax check using available python tools
+    lint-flake8                   Syntax check using tool flake8
+    lint-pylint                   Syntax check using tool pylint
 
 |
 
diff --git a/howto/edit_voltha_docs.rst b/howto/edit_voltha_docs.rst
index 540b734..32bcf9d 100644
--- a/howto/edit_voltha_docs.rst
+++ b/howto/edit_voltha_docs.rst
@@ -34,7 +34,7 @@
 Writing Docs
 """"""""""""
 
-Docs written using sphinx: http://www.sphinx-doc.org
+Docs written using sphinx: https://www.sphinx-doc.org/en/master/
 
 Documentation is done in reStructuredText or Markdown, but only ``.rst`` files
 can contain embedded diagrams.