diff --git a/docs/pages/release_notes.md b/docs/pages/release_notes.md
index c9c391b85a..83c4d3cabb 100644
--- a/docs/pages/release_notes.md
+++ b/docs/pages/release_notes.md
@@ -57,6 +57,8 @@ This is a {{ site.pmd.release_type }} release.
 
 #### Deprecated API
 
+##### For removal
+
 *   {% jdoc !!core::Rule#getParserOptions() %}
 *   {% jdoc !!core::lang.Parser#getParserOptions() %}
 *   {% jdoc !!core::lang.AbstractParser %}
@@ -84,6 +86,8 @@ This is a {{ site.pmd.release_type }} release.
     *   {% jdoc_package core::lang.dfa %}
     *   and the class {% jdoc plsql::lang.plsql.PLSQLDataFlowHandler %}
 
+*   {% jdoc !!visualforce::lang.vf.VfSimpleCharStream %}
+
 ### External Contributions
 
 *   [#2659](https://github.com/pmd/pmd/pull/2659): \[java] StringToString can not detect the case: getStringMethod().toString() - [Mykhailo Palahuta](https://github.com/Drofff)
diff --git a/pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/vf/VfSimpleCharStream.java b/pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/vf/VfSimpleCharStream.java
index a1dd050cd0..71f0408647 100644
--- a/pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/vf/VfSimpleCharStream.java
+++ b/pmd-visualforce/src/main/java/net/sourceforge/pmd/lang/vf/VfSimpleCharStream.java
@@ -11,7 +11,14 @@ import net.sourceforge.pmd.lang.ast.SimpleCharStream;
 /**
  * @author sergey.gorbaty
  *
+ * @deprecated Just use {@link SimpleCharStream} directly. The only difference is
+ *             the tabSize. With PMD 6.27.0 the tabSize is set to 1 for all languages, which
+ *             simplifies calculation of the positions of AST nodes. PMD Designer also
+ *             uses a tabSize of 1. If a mapping from PMD's beginColumn or endColumn to
+ *             the text editor coordinates is needed, this needs to be done manually.
+ *             Before it would only have been correct, if the editor used a tabSize of 4.
  */
+@Deprecated
 public class VfSimpleCharStream extends SimpleCharStream {
 
     public VfSimpleCharStream(Reader dstream) {