update readme
[newtab.git] / README.md
index 6fb8e7159f545afece1394dc639e5d5eef339e57..b38bb24948aa1949164845c15eef002bef66f229 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-After Google changed the new tab page of Chrome to an ugly array of circular icons (around mid 2016), I looked around for a better new tab page extension. The best I could find was [Start Clean](https://startclean.github.io/), but it had several issues (I don't remember exactly - I think there were various bugs). A fork of Start Clean by [shadowfacts](https://github.com/shadowfacts/Chrome-Extension) fixed some small issues and added the favicons which was rather nice, but for some reason (???) this fork makes links open in a new tab.
+After Google changed the new tab page of Chrome to an ugly array of circular icons (around mid 2016), I looked around for a better new tab page extension. This project started as a fork of a fork: it is based off [Start Clean](https://startclean.github.io/) with the addition of favicons by [shadowfacts](https://github.com/shadowfacts/Chrome-Extension).
 
-Initially I forked shadowfacts' version to make links open in the current tab. That worked fine for a while, but I have since rewritten the extension to have much more flexibility in adding/removing links and categories. The UI is also much improved. Here is a summary of the changes I've made:
+Compared to the original version, there is much more flexibility in managing links and categories, and the UI is much improved. Here is a summary of the changes I've made:
 
 * Links open in the current tab
 * Background, foreground and hover colours are configurable
@@ -16,7 +16,10 @@ Initially I forked shadowfacts' version to make links open in the current tab. T
 
 The sorting of links is managed by [SortableJS](https://github.com/SortableJS/Sortable). If I was writing this from scratch again I would use native HTML5 drag and drop, but I guess if it ain't broke don't fix it. I did end up implementing HTML5 drag and drop for the movement of columns though.
 
-Favicons for websites are obtained from Google's S2 API. One day I might upgrade to [Favicon Kit](https://faviconkit.com/) which is less centralised. This is the only external object loaded, but it triggers some scary warning in Chrome which says that it can "change data on all websites you visit" etc.
+Favicons for websites are obtained from Google's S2 API. One day I might upgrade to [Favicon Kit](https://faviconkit.com/) which is less centralised. This is the only external object loaded, but it triggers a scary warning in Chrome which says it can "change data on www.google.com".
+
+![](../plain/newtab.png)
+![](../plain/newtab-2.png)
 
 ## Installation
 
@@ -25,7 +28,7 @@ Unfortunately installation is a little protracted because Google wants all exten
 You can still install it as a local extension in developer mode:
 
 1. Go to <chrome://extensions> and turn on developer mode (top right)
-2. Download <a href="../plain/build/newtab.crx" download>build/newtab.crx</a> (make sure you save it, don't install it straight away - see below)
+2. Download <a href="../plain/build/newtab.crx" download>build/newtab.crx</a> ("Save link as...", don't install it straight away - see below)
 3. Drag the file onto the extensions page to install it
 
 Opening the crx file using Chrome's default file handler causes a "CRX_REQUIRED_PROOF_MISSING" error because Chrome now only allows extensions obtained from their store. However, you can drag and drop it onto the extensions page and that seems to bypass the verification. More info [here](https://support.google.com/chrome/thread/3125155?hl=en).