Start overhaul of global docs (for the system, not packages).

Author: andreas-kupries

.github/CONTRIBUTING.md

@@ -1,17 +1,17 @@
 
-Hello.
+Hello. __Attention please__
 
 You are currently using the github __mirror__ of the Tcllib sources.
 
-This is __not__ the location where development takes place.
+This is __not__ the location where Tcllib development takes place.
 
-We are not tracking issues entered here.  With the exception of the
+We are __not tracking issues entered here__. With the exception of the
 maintainer of the mirroring setup nobody will even see such issues.
 
 Please go to the
-[official location of the sources](https://core.tcl.tk/tcllib)
+[official location of the sources](https://core.tcl-lang.org/tcllib)
 and enter your ticket into the
-[official ticket tracker](https://core.tcl.tk/tcllib/reportlist)
+[official ticket tracker](https://core.tcl-lang.org/tcllib/reportlist)
 instead.
 
 Thank you for your consideration.

.github/ISSUE_TEMPLATE.md

@@ -1,17 +1,17 @@
 
-Hello.
+Hello. __Attention please__
 
 You are currently using the github __mirror__ of the Tcllib sources.
 
-This is __not__ the location where development takes place.
+This is __not__ the location where Tcllib development takes place.
 
-We are not tracking issues entered here.  With the exception of the
+We are __not tracking issues entered here__. With the exception of the
 maintainer of the mirroring setup nobody will even see such issues.
 
 Please go to the
-[official location of the sources](https://core.tcl.tk/tcllib)
+[official location of the sources](https://core.tcl-lang.org/tcllib)
 and enter your ticket into the
-[official ticket tracker](https://core.tcl.tk/tcllib/reportlist)
+[official ticket tracker](https://core.tcl-lang.org/tcllib/reportlist)
 instead.
 
 Thank you for your consideration.

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,17 +1,17 @@
 
-Hello.
+Hello. __Attention please__
 
 You are currently using the github __mirror__ of the Tcllib sources.
 
-This is __not__ the location where development takes place.
+This is __not__ the location where Tcllib development takes place.
 
-We are not tracking issues entered here.  With the exception of the
+We are __not tracking issues entered here__. With the exception of the
 maintainer of the mirroring setup nobody will even see such issues.
 
 Please go to the
-[official location of the sources](https://core.tcl.tk/tcllib)
+[official location of the sources](https://core.tcl-lang.org/tcllib)
 and enter your ticket into the
-[official ticket tracker](https://core.tcl.tk/tcllib/reportlist)
+[official ticket tracker](https://core.tcl-lang.org/tcllib/reportlist)
 instead.
 
 Thank you for your consideration.

README

@@ -1,17 +1,41 @@
+# Attention
 
-Hello.
+:warning: 
+This repository is mirrored to [github](https://github.com/tcltk/tcllib).
 
-If you are reading this then you are very likely at the github
-__mirror__ of the Tcllib sources.
-
-This means that the
-[official location of the sources](https://core.tcl.tk/tcllib)
-is somewhere else, just follow the link.
-
-This is also where our issue tracking is done.  We are not tracking
-issues at github.  With the exeception of the maintainer of the
-mirroring setup nobody will even see issues created at github.
+We are __not tracking issues at github__.  With the exeception of the
+maintainer of the mirroring setup nobody will even see issues created
+at github.
 
 Please use the
-[official ticket tracker](https://core.tcl.tk/tcllib/reportlist)
+[official ticket tracker](https://core.tcl-lang.org/tcllib/reportlist)
 instead.
+
+# Welcome
+
+Welcome to Tcllib, the Tcl Standard Library. Note that Tcllib is not a
+package itself. It is a collection of (semi-independent) Tcl packages
+that provide utility functions useful to a large collection of Tcl
+programmers.
+
+At our [home site](http://core.tcl-lang.org/tcllib) you will find the
+official fossil repository used to manage our sources, together with
+the bug tracker. This is also the main location for releases to
+download from.
+
+We have a
+[secondary download location](https://sourceforge.net/projects/tcllib/files)
+where the Tcllib sources were hosted in the past. SourceForge is also
+where our [mailing lists](https://sourceforge.net/p/tcllib/mailman)
+are (still) hosted.
+
+Another location to find these sources at is the
+[github mirror](https://github.com/tcltk/tcllib).
+
+Please note the :warning: at the top.
+
+# More reading
+
+Note that depending on your role with regard to Tcllib (developer,
+release manager, installer) we have additional README documents
+available with more information specific to that role.