updated /etc readme

config/etc/readme.md

@@ -1,29 +1,57 @@
-Configuration files and/or changes to default config files in /etc/
-=
+# /etc: Included files
 
- - Setup timesyncd for NTP syncing (using systemd, not ntp package)  
-   - set to use global pool.ntp.org, you should change this!
-   - verify timesyncd is working with 'timedatectl' command
+Three files are updated in the */etc* folder.
 
- - Setup nano with helpful configurations both locally and via SSH  
-   - rebind number lock
-   - constant show cursor position at bottom of screen
-   - constant show line numbers on the left
-   - added shortcuts for cut, copy, paste using alt-x,c,v respectively
-   - enable multi-buffer for concurrent open files
-   - cut to end-of-line
-   - bracket and quote matching
-   - tabs converted to spaces, tab = 4 spaces
-   - activate default colourization
+## profile
 
- - Colourize prompt  
-   - red username for root user or shell accessed as root (su, sudo -s, etc.)
-   - green username for regular users
-   - display time and full path
+This is the Debian Stretch default *profile* and is copied to */etc/profile* to
+return accounts to a baseline configuration.  Again, this is done to ensure that
+only */etc/bash.bashrc* is providing initial customizations to users.
 
- - Setup SSH server  
-   - use non-standard port 222
-   - use host-keys (RSA and ED25519 - you need to generate these!)
-   - display a banner on sucessful connection
-   - do not allow root login
-   - require keyfile authentication (disable password authentication)
+## bash.bashrc
+
+Of the bash customization files, this is the only one that is NOT in a default
+configuration. I have added the following customizations I find useful
+especially for new users and system admins:
+
+- colourized directory listings with built-in automatic colour settings
+- changed prompt to include 24-hour clock, username, hostname and current
+  directory display
+  - username changes to RED when working as ROOT (uid=0)
+- added the following command aliases
+
+  alias|full command|explanation
+  ---|---|---
+  ll|ls -l|default 'ls' output
+  l|ls -lAsh --group-directories-first|far more useful and robust file display including sizes, permissions and owners
+  rm|rm -i|confirmation prompt when deleting file
+  mv|mv -i|confirmation prompt when moving file would result in overwriting existing file
+  cp|cp -i|confirmation prompt when copying file would result in overwriting existing file
+
+## nano defaults (nanorc)
+
+The following options have been enabled/set in nano to provide what I feel is an
+easier editing experience especially for people coming from a Windows background
+and new users/admins.
+
+- 'rebind' numeric keypad to fix problems with using keypad with some SSH clients
+- set 'smart home' some home key is useful
+- allow opening multiple files at once
+- always display line numbers
+- constantly display cursor position at the bottom of the screen
+- set vim lock-files
+- autoindent ON, tab-size of 4 spaces
+- convert tabs to spaces
+- turn off hard line wrapping
+- turn ON soft line wrapping for ease of readability
+- closing 'brackets' (for alignment purposes) set as: "')>]}
+- cut to end of line by default
+- set proper bracket matching (ie. "<" matches ">", etc.)
+- turned on default colours so nano doesn't look so drab
+- added the following key-bindings
+
+binding|fuction
+---|---
+alt-c/alt-C|copy selected text
+alt-x/alt-X|cut selected text
+alt-v/alt-V|paste text on clipboard