Restore old section on language support separate from features,

collapse features section

README.md

@@ -36,25 +36,29 @@ To connect the Serena MCP server to your client, you typically
 
 See the [Quick Start](#quick-start) section below for information on how to get started.
 
-## Features
+## Programming Language Support & Semantic Analysis Capabilities
 
-Serena supports two code intelligence backends:
+Serena provides a set of versatile code querying and editing functionalities
+based on symbolic understanding of the code.
+Equipped with these capabilities, Serena discovers and edits code just like a seasoned developer
+making use of an IDE's capabilities would.
+Serena can efficiently find the right context and do the right thing even in very large and
+complex projects!
 
-* **Language servers** implementing the language server protocol (LSP) — the free/open-source alternative.
-* **The Serena JetBrains Plugin**, which leverages the capabilities of your JetBrains IDE.
+There are two alternative technologies powering these capabilities:
 
-Language Servers, while very powerful, have inherent limitations.
-The JetBrains variant is the more advanced solution, as detailed below. It is also more memory-efficient, especially in
-multi-agent scenarios.
+* **Language servers** implementing the language server Protocol (LSP) — the free/open-source alternative.
+* **The Serena JetBrains Plugin**, which leverages the powerful code analysis and editing
+  capabilities of your JetBrains IDE.
 
-### Language Support
+You can choose either of these backends depending on your preferences and requirements.
 
-#### Language Servers
+### Language Servers
 
 When using Serena's language server backend, we provide **support for over 40 programming languages**, including
 AL, Ansible, Bash, C#, C/C++, Clojure, Dart, Elixir, Elm, Erlang, Fortran, F# (currently with some bugs), GLSL, Go, Groovy (partial support), Haskell, HLSL, Java, Javascript, Julia, Kotlin, Lean 4, Lua, Luau, Markdown, MATLAB, Nix, OCaml, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Scala, Solidity, Swift, TOML, TypeScript, WGSL, YAML, and Zig.
 
-#### The Serena JetBrains Plugin
+### The Serena JetBrains Plugin
 
 The [Serena JetBrains Plugin](https://plugins.jetbrains.com/plugin/28946-serena/)
 leverages the powerful code analysis capabilities of your JetBrains IDE.
@@ -65,6 +69,16 @@ including IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, RubyMine,
 
 See our [documentation page](https://oraios.github.io/serena/02-usage/025_jetbrains_plugin.html) for further details and instructions on how to apply the plugin.
 
+## Features
+
+Serena provides a wide range of tools for efficient code retrieval, editing and refactoring, as well as 
+a memory system for long-lived agent workflows.
+
+Given its large scope, Serena adapts to your needs by offering a multi-layered configuration system.
+
+<details>
+<summary>Details</summary>
+
 ### Retrieval
 
 Serena's retrieval tools allow agents to explore codebases at the symbol level, understanding structure and relationships
@@ -135,6 +149,8 @@ To achieve this, Serena offers multiple levels of (composable) configuration:
 * execution context-specific configuration (e.g. for particular clients)
 * dynamically composable configuration fragments (modes)
 
+</details>
+
 ## Serena in Action
 
 <details>