docs: update, fix typo, minor improvements

README.md

@@ -227,9 +227,9 @@ require('github-theme').setup({
     dim_inactive = false,      -- Non focused panes set to alternative background
     module_default = true,     -- Default enable value for modules
     styles = {                 -- Style to be applied to different syntax groups
-      comments = 'italic',     -- Value is any valid attr-list value `:help attr-list`
+      comments = 'NONE',       -- Value is any valid attr-list value `:help attr-list`
       functions = 'NONE',
-      keywords = 'italic',
+      keywords = 'NONE',
       variables = 'NONE',
       conditionals = 'NONE',
       constants = 'NONE',
@@ -263,15 +263,13 @@ require('github-theme').setup({
 vim.cmd('colorscheme github_dark')
 ```
 
-If you would like to change any of the default options above you only have to define the options that change. If an
-option is not present in your options table the default option will be used. For example if changing the styles of
-certain syntax is the only desired change then your options table would look like:
+If you would like to change any of the default options above, simply specify the options that you'd like to change. Unspecified options will use their default value. For example, if you only wanted to change the styles of certain syntax items:
 
 ```lua
 require('github-theme').setup({
   options = {
     styles = {
-      comments = 'NONE',
+      comments = 'italic',
       keywords = 'bold',
       types = 'italic,bold',
     }
@@ -371,7 +369,7 @@ local specs = {
 }
 
 -- Groups are the highlight group definitions. The keys of this table are the name of the highlight
--- groups that will be overridden. The value is a table with the following values:
+-- groups that will be overridden. The value is a table with the following keys:
 --   - fg, bg, style, sp, link,
 --
 -- Just like `spec` groups support templates. This time the template is based on a spec object.

Usage.md

@@ -410,7 +410,7 @@ Current list of modules are:
 ### Neovim specific modules
 
 The following modules are enabled by default only when on neovim, `diagnostic`, `native_lsp`, `treesitter`. These modules are part of the core neovim experience and
-are liked to by other modules. This also means that they will still be enabled when setting `module_default` to `false`.
+are linked to by other modules. This also means that they will still be enabled when setting `module_default` to `false`.
 
 ### Extended modules
 

doc/github-nvim-theme.txt

@@ -509,7 +509,7 @@ NEOVIM SPECIFIC MODULES ~
 
 The following modules are enabled by default only when on neovim, `diagnostic`,
 `native_lsp`, `treesitter`. These modules are part of the core neovim
-experience and are liked to by other modules. This also means that they will
+experience and are linked to by other modules. This also means that they will
 still be enabled when setting `module_default` to `false`.