[DOC] Document that using RubyVM::AbstractSyntaxTree is discouraged in new code

* See [Feature #21826]
This commit is contained in:
Benoit Daloze committed 2026-08-06 15:07:20 +02:00
1 parent 2461caebba
commit 5d7bb1076d
1 file changed
+5 -3
Notes: git 2026-08-06 13:07:55 +00:00
+5 -3
View File
@@ -12,9 +12,11 @@
# guaranteed, the number of children nodes might change, there is no way to
# access children nodes by name, etc.
#
# If you are looking for a stable API or an API working under multiple Ruby
# implementations, consider using the _prism_ gem, which is the official
# Ruby API to parse Ruby code.
# Prism is the official Ruby API to parse Ruby code. It has a stable API
# and is available on most Ruby implementations.
# Therefore, it is the recommended replacement.
# Using RubyVM::AbstractSyntaxTree is discouraged for new code for the reasons
# above and because AbstractSyntaxTree might become deprecated in the future.
#
module RubyVM::AbstractSyntaxTree