From cc929d2fdf8f7109c9e59d75a6cdd3b9a95945ea Mon Sep 17 00:00:00 2001
From: James Hegedus <james@jthegedus.com>
Date: Tue, 11 Aug 2020 09:03:13 +1000
Subject: [PATCH] docs: link to our community and place(s) for q&a (#775)

---
 README.md        |  8 +++++++-
 docs/_sidebar.md | 34 ++++++++++++++++------------------
 2 files changed, 23 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 2c3b90af..70567bc4 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,15 @@ asdf-vm is a CLI tool that can manage multiple language runtime versions on a pe
 - [Getting Started](https://asdf-vm.github.io/asdf/#/core-manage-asdf-vm)
 - [All Commands](https://asdf-vm.github.io/asdf/#/core-commands)
 - [All Plugins](https://asdf-vm.github.io/asdf/#/plugins-all)
-- [Create a Plugin](https://asdf-vm.github.io/asdf/#/plugins-create)
+- [Create a Plugin](https://asdf-vm.github.io/asdf/#/plugins-create) with our [asdf-plugin-template](https://github.com/asdf-vm/asdf-plugin-template)
 - [asdf GitHub Actions](https://github.com/asdf-vm/actions)
 
 ## Contributing
 
 See [CONTRIBUTING.md in the repo](https://github.com/asdf-vm/asdf/blob/master/CONTRIBUTING.md) or the [Contributing section on the docs site](http://asdf-vm.github.io/asdf/#/contributing-core-asdf-vm).
+
+## Community & Questions
+
+<!-- - [![GitHub Discussions](https://icongram.jgog.in/simple/github.svg?color=808080&size=16)Github Discussions TBA](https://github.com/asdf-vm/asdf/discussions): our preferred method for community Q&A and interaction -->
+- [![Github Issues](https://icongram.jgog.in/simple/github.svg?color=808080&size=16)Github Issues](https://github.com/asdf-vm/asdf/issues): report a bug or raise a feature request to the `asdf` core team
+- [![StackOverflow Tag](https://icongr.am/fontawesome/stack-overflow.svg?size=16&color=808080)StackOverflow Tag](https://stackoverflow.com/questions/tagged/asdf-vm): see existing Q&A for `asdf`. Some of the core team watch this tag in addition to our helpful community
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
index 589b02ad..d3c8753e 100644
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@@ -1,22 +1,20 @@
 <!-- docs/_sidebar.md -->
 
-- Core
-
-  - [Manage asdf-vm](core-manage-asdf-vm)
-  - [Manage Plugins](core-manage-plugins)
-  - [Manage Versions](core-manage-versions)
-  - [Configuration](core-configuration)
-  - [All Commands](core-commands)
-
-- Plugins
-
-  - [Creating Plugins](plugins-create)
-  - [All Plugins](plugins-all) <!-- pulls in asdf-vm/asdf-plugins readme -->
-
-- Contributing
-
-  - [Core asdf vm](contributing-core-asdf-vm)
-  - [Documentation Site](contributing-doc-site)
-
+- **Core**
+- [Manage asdf-vm](core-manage-asdf-vm)
+- [Manage Plugins](core-manage-plugins)
+- [Manage Versions](core-manage-versions)
+- [Configuration](core-configuration)
+- [All Commands](core-commands)
 - [Changelog](changelog) <!-- pulls in changelog from repo -->
+- **Plugins**
+- [Creating Plugins](plugins-create)
+- [All Plugins](plugins-all) <!-- pulls in asdf-vm/asdf-plugins readme -->
+- **Contributing**
+- [Core asdf vm](contributing-core-asdf-vm)
+- [Documentation Site](contributing-doc-site)
 - [Thanks](thanks)
+- **Community & Questions**
+- [![Github Issues](https://icongram.jgog.in/simple/github.svg?color=808080&size=16)Github Issues](https://github.com/asdf-vm/asdf/issues)
+- [![StackOverflow Tag](https://icongr.am/fontawesome/stack-overflow.svg?size=16&color=808080)StackOverflow Tag](https://stackoverflow.com/questions/tagged/asdf-vm)
+<!-- - [![GitHub Discussions](https://icongram.jgog.in/simple/github.svg?color=808080&size=16)Github Discussions TBA](https://github.com/asdf-vm/asdf/discussions) -->