Update documentation and add requirements for RTD

Author: PalashChitnavis

docs/index.rst

@@ -25,7 +25,7 @@ Bug Reports
 To report issues or suggest improvements, use the `GitHub issue tracker <https://github.com/brian-team/brian2wasm/issues>`_ or post in the `Brian Discourse Group <https://brian.discourse.group/>`_.
 
 .. tip::
-   Before submitting a bug report, check the `known issues <known_issues>`_ page to see if your issue is already documented.
+   Before submitting a bug report, check the `known issues <user/issues.html>`_ page to see if your issue is already documented.
 
 Contents
 --------

docs/user/html.rst

@@ -68,7 +68,7 @@ After the simulation completes, variables from your ``Brian 2`` script are acces
 Variable Access Examples
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-- For a spike monitor named ``spikemon``:
+- For a spike monitor named ``spikemonitor``:
 
   .. code-block:: javascript
 
@@ -78,7 +78,7 @@ Variable Access Examples
      // Access neuron indices
      var neuron_indices = brian_results['spikemonitor'].i;
 
-- For a state monitor named ``statemon`` recording voltage:
+- For a state monitor named ``statemonitor`` recording voltage:
 
   .. code-block:: javascript
 

docs/user/issues.rst

@@ -4,7 +4,9 @@ Known Issues
 Below is a list of known issues with ``brian2wasm``. For additional details or to report new issues, visit the `bug tracker on GitHub <https://github.com/brian-team/brian2wasm/issues>`_.
 
 - **Automatic Device Setting**:
-  Do not call ``set_device(...)`` in your ``Brian 2`` script, as ``brian2wasm`` automatically configures the device. Including this call may cause errors or unexpected behavior.
+    When using the brian2wasm CLI tool, do not call ``set_device(...)`` in your Brian 2 script. The CLI automatically configures the device, and adding your own call may cause errors or unexpected behavior.
+
+    However, if you are not using the CLI (e.g. running a script directly in Python), you can still manually set the device to ``wasm_standalone`` with ``set_device("wasm_standalone")``.
 
 - **Plotly CDN Dependency**:
   The generated HTML files rely on Plotly charts that load assets from a CDN (``https://cdn.plot.ly/plotly-latest.min.js``). An internet connection is required for these charts to render properly.

rtd-requirements.txt

@@ -1,4 +1,6 @@
 sphinx
 sphinx_rtd_theme
 sphinx-tabs
-sphinxcontrib-mermaid
+sphinxcontrib-mermaid
+numpy
+brian2