docs: expand community docs: contributor - recommended tools (#1777)

Co-authored-by: Ezinne Anne Emilia <[email protected]>
Co-authored-by: V Thulisile Sibanda <[email protected]>

Author: ezinneanne

docs/onboarding-guide/tools-and-setup.md

@@ -1,17 +1,18 @@
 ---
-title: Tools and setup
+title: Recommended tools and setup
 weight: 60
 ---
 
-## Tools for technical writers
+These are the recommended tools for contributors, as well as instructions for setting up the AsyncAPI website in your local environment.
 
-Technical writer contributors need the following tools to contribute to AsyncAPI documentation effectively:
-
-- A laptop or desktop computer capable of running the tools necessary to contribute to the project.
-- Stable internet access to clone the project repository, submit contributions, and stay updated on project changes.
-- A [GitHub](https://github.com) account. AsyncAPI hosts all its project's source code and documentation on GitHub. You'll need a GitHub account to create issues, fork the repository, submit pull requests, and more. If you're new to GitHub, familiarize yourself with [basic GitHub functionalities and workflows](https://docs.github.com/en/get-started).
-- A code editor, such as [VS Code](https://code.visualstudio.com), capable of handling Markdown files.
-- [Git](https://git-scm.com), a version control system.
+## Recommended Tools
+- [Git](https://git-scm.com) to work with the organization's repositories.
+- [A GitHub account](https://github.com) to fork AsyncAPI repositories, create issues, submit pull requests, and participate in discussions. If you're new to GitHub, familiarize yourself with [basic GitHub functionalities and workflows](https://docs.github.com/en/get-started).
+- A code editor, such as [VS Code](https://code.visualstudio.com) to work on your changes.
+- Command-line terminal, such as the one included in your OS, or the terminal integrated in your code editor or IDE, to run commands.
+- [Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) to build and run the website locally.
+- A web browser, such as Google Chrome, Firefox or Microsoft Edge to preview your changes. 
+- To preview minor changes in Markdown documents without spinning up a dev server, you can use out-of-the-box capabilities of your code editor, or install the corresponding extension. For more information, please consult your code editor's documentation.
 
 ## Setup your AsyncAPI local environment
 1. Fork the repository by clicking the `Fork` option on the top right of the main repository.