[Docs] Add a short comparison with project.el

1 files changed, 18 insertions, 0 deletions

diff --git a/doc/modules/ROOT/pages/faq.adoc b/doc/modules/ROOT/pages/faq.adoc
index 7cbd3d0..bb73261 100644
--- a/doc/modules/ROOT/pages/faq.adoc
+++ b/doc/modules/ROOT/pages/faq.adoc
@@ -9,6 +9,24 @@ NOTE: Funny enough, a few years after Projectile was created, another similar
 project called `project.el` was born. Despite its boring name it's a great
 project and happens to be part of Emacs.
 
+== How does Projectile compare to the built-in `project.el`?
+
+`project.el` was introduced in Emacs 25.1, released in 2016, and a lot of people
+have been asking since how do the two packages compare.
+
+Internally they have a lot of differences (e.g. different approach to project discovery and indexing), but from the user standpoint they are probably quite similar
+these days (circa 2021). Historically, Projectile had a lot more features, but many
+of them found their way into `project.el` over the years. If all you need is
+a way to quickly jump between project files or search/replace inside a project, you can't go wrong with both.
+
+For me Projectile's biggest advantage will always be that it's more community-friendly
+(e.g. the development happens on GitHub), and it's not restricted by the FSF
+contributor agreement, which means that everyone can easily contribute to the project. Of course, this comes with the downside that you have to install Projectile
+yourselves.
+
+One under-appreciated advantage of Projectile is that it has way more documentation.
+Okay, that's only an advantage if you're one of those rare people who enjoy reading it.
+
 == Does Projectile work with TRAMP?
 
 Yeah, it does. I don't use TRAMP myself, however, so I never paid that