From feabfd5703e2cba0ff29588e31b7902127d8d173 Mon Sep 17 00:00:00 2001
From: Matt Young <matt@mlyoung.cool>
Date: Thu, 31 Jul 2025 16:39:27 +1000
Subject: [PATCH] docs: mention Yosys Discourse group and blog

---
 README.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 71d47d76c..6c576f682 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,9 @@ Web Site and Other Resources
 More information and documentation can be found on the Yosys web site:
 - https://yosyshq.net/yosys/
 
+If you have any Yosys-related questions, please post them on the Discourse group:
+- https://yosyshq.discourse.group
+
 Documentation from this repository is automatically built and available on Read
 the Docs:
 - https://yosyshq.readthedocs.io/projects/yosys
@@ -34,6 +37,9 @@ verification front-end for Yosys, SBY:
 - https://yosyshq.readthedocs.io/projects/sby/
 - https://github.com/YosysHQ/sby
 
+The Yosys blog has news and articles from users:
+- https://blog.yosyshq.com
+
 
 Installation
 ============
@@ -242,7 +248,7 @@ Note that there is no need to build the manual if you just want to read it.
 Simply visit https://yosys.readthedocs.io/en/latest/ instead.
 
 In addition to those packages listed above for building Yosys from source, the
-following are used for building the website: 
+following are used for building the website:
 
 	$ sudo apt install pdf2svg faketime
 
@@ -258,7 +264,7 @@ build process for the website.  Or, run the following:
 Or for MacOS, using homebrew:
 
   $ brew install basictex
-  $ sudo tlmgr update --self   
+  $ sudo tlmgr update --self
   $ sudo tlmgr install collection-latexextra latexmk tex-gyre
 
 The Python package, Sphinx, is needed along with those listed in
@@ -268,5 +274,5 @@ The Python package, Sphinx, is needed along with those listed in
 
 From the root of the repository, run `make docs`.  This will build/rebuild yosys
 as necessary before generating the website documentation from the yosys help
-commands.  To build for pdf instead of html, call 
+commands.  To build for pdf instead of html, call
 `make docs DOC_TARGET=latexpdf`.