.. container:: document

   `RIDE (Robot Framework
   IDE) <https://github.com/robotframework/RIDE/>`__ v2.0.8.1 is a new
   release with minor enhancements and bug fixes. The reference for
   valid arguments is `Robot Framework <https://robotframework.org/>`__
   installed version, which is at this moment 6.1.1. However, internal
   library is based on version 3.1.2, to keep compatibility with old
   formats.

   -  This version supports Python 3.6 up to 3.11.
   -  There are some changes, or known issues:

      -  On Text Editor, pressing **Ctrl** when the caret/cursor is near
         a Keyword will show a detachable window with the documentation,
         at Mouse Pointer position.
      -  RIDE tray icon now shows a context menu with options Show, Hide
         and Close.
      -  Highlighting and navigation of selected Project Explorer items,
         in Text Editor.
      -  When editing in Grid Editor with content assistance, the
         selected content can be edited by escaping the list of
         suggestions with keys ARROW_LEFT or ARROW_RIGHT.
      -  Newlines in Grid Editor can be made visible with the **filter
         newlines** set to False.
      -  On Text Editor when Saving the selection of tests in Test
         Suites (Tree) is cleared.
      -  Test Suite with *\**\* Comments \**\** can be edited but
         newlines are introduced.
      -  Problems with COPY/PASTE in Text Editor have been reported when
         using wxPython 4.2.0, but not with version 4.2.1, which we now
         *recommend*.
      -  Some argument types detection (and colorization) is not correct
         in Grid Editor.
      -  RIDE **DOES NOT KEEP** Test Suites formatting or structure,
         causing differences in files when used on other IDE or Editors.

   **New Features and Fixes Highlights**

   -  Fixed escaped spaces showing in Text Editor on commented cells
   -  Improved keywords documentation search, by adding current dir to
      search
   -  Improved Move up/down, **Alt-UpArrow**/**Alt-DownArrow** in Text
      Editor, to have proper indentation and selection
   -  Added auto update check when development version is installed
   -  Added menu option **Help->Check for Upgrade** which allows to
      force update check and install development version
   -  Added **Upgrade Now** action to update dialog.
   -  Added **Test Tags** field (new, since Robot Framework 6.0) to Test
      Suites settings. This field will replace **Default** and **Force
      Tags** settings, after Robot Framework 7.0
   -  Improved **RIDE Log** and **Parser Log** windows to allow Zoom
      In/Out with **Ctrl-Mouse Wheel**
   -  Hide continuation markers in Project Tree
   -  Improved content assistance in Text Editor by allowing to filter
      list as we type
   -  Fixed resource files disappearing from Project tree on Windows
   -  Fixed missing indication of link for User Keyword, when pressing
      **Ctrl** in Grid Editor
   -  Added content help pop-up on Text Editor by pressing **Ctrl** for
      text at cursor position or selected autocomplete list item
   -  Added Exclude option in context nenu for Test files, previously
      was only possible for Test Suites folders
   -  Added exclusion of monitoring filesystem changes for files and
      directories excluded in Preferences
   -  Fixed exception when finding GREY color for excluded files and
      directories in Project Tree
   -  Added support for JSON variables, by using the installed Robot
      Framework import method
   -  Colorization of Grid Editor cells after the continuation marker
      **...** and correct parsing of those lines
   -  Colorization of Grid Editor cells when contents is list or
      dictionary variables
   -  Added indication of matching brackets, **()**, **{}**, **[]**, in
      Text Editor
   -  Fixed non synchronized expanding/collapse of Settings panel in
      Grid Editor, on Linux
   -  Fixed not working the deletion of cells commented with **#** in
      Grid Editor with **Ctrl-Shift-D**
   -  Fixed empty line being always added to the Variables section in
      Text Editor
   -  Improved project file system changes and reloading
   -  Added context menu to RIDE tray icon. Options Show, Hide and Close
   -  Added synchronization with Project Explorer to navigate to
      selected item, Test Case, Keyword, Variable, in Text Editor
   -  Control commands (**FOR**, **IF**, **TRY**, etc) will only be
      colorized as valid keywords when typed in all caps in Grid Editor
   -  Newlines in Grid Editor can be made visible with the **filter
      newlines** set to False, by editing *settings.cfg*
   -  Improve auto-suggestions of keywords in Grid Editor by allowing to
      close suggestions list with keys ARROW_LEFT or ARROW_RIGHT
   -  Improve Text Editor auto-suggestions by using: selected text, text
      at left or at right of cursor

   We hope to implement or complete features and make fixes on next
   major version 2.1 (in the end of 2023).

   **The minimal wxPython version is, 4.0.7, and RIDE supports the
   current version, 4.2.1.**

   *Linux users are advised to install first wxPython from .whl package
   at*
   `wxPython.org <https://extras.wxpython.org/wxPython4/extras/linux/gtk3/>`__,
   or by using the system package manager.

   The
   `CHANGELOG.adoc <https://github.com/robotframework/RIDE/blob/master/CHANGELOG.adoc>`__
   lists the changes done on the different versions.

   All issues targeted for RIDE v2.1 can be found from the `issue
   tracker
   milestone <https://github.com/robotframework/RIDE/issues?q=milestone%3Av2.1>`__.

   Questions and comments related to the release can be sent to the
   `robotframework-users <https://groups.google.com/group/robotframework-users>`__
   mailing list or to the channel #ride on `Robot Framework
   Slack <https://robotframework-slack-invite.herokuapp.com>`__, and
   possible bugs submitted to the `issue
   tracker <https://github.com/robotframework/RIDE/issues>`__. You
   should see `Robot Framework
   Forum <https://forum.robotframework.org/c/tools/ride/>`__ if your
   problem is already known.

   To install with `pip <https://pypi.org/project/pip/>`__ installed,
   just run

   .. code:: literal-block

      pip install --upgrade robotframework-ride==v2.0.8.1

   to install exactly this release, which is the same as using

   .. code:: literal-block

      pip install --upgrade robotframework-ride

   Alternatively you can download the source distribution from
   `PyPI <https://pypi.python.org/pypi/robotframework-ride>`__ and
   install it manually. For more details and other installation
   approaches, see the `installation
   instructions <https://github.com/robotframework/RIDE/wiki/Installation-Instructions>`__.
   If you want to help in the development of RIDE, by reporting issues
   in current development version, you can install with:

   .. code:: literal-block

      pip install -U https://github.com/robotframework/RIDE/archive/master.zip

   Important document for helping with development is the
   `CONTRIBUTING.adoc <https://github.com/robotframework/RIDE/blob/master/CONTRIBUTING.adoc>`__.

   See the `FAQ <https://github.com/robotframework/RIDE/wiki/F.A.Q.>`__
   for important info about : FOR changes and other known issues and
   workarounds.

   A possible way to start RIDE is:

   .. code:: literal-block

      python -m robotide.__init__

   You can then go to Tools>Create RIDE Desktop Shortcut, or run the
   shortcut creation script with:

   .. code:: literal-block

      python -m robotide.postinstall -install

   RIDE v2.0.8.1 was released on 1/Nov/2023.
