Link to "popular documentation tools" #601
Conversation
Instead of linking to the tutorial, we are linking to the doctools. That way, the user can immediately know there are a bunch of doctools supported and it's not just Sphinx. Closes #436
| @@ -24,7 +24,7 @@ | |||
| {% trans "You don't have any projects configured yet" %} | |||
| {% endblock list_placeholder_header_empty %} | |||
| {% block list_placeholder_text_empty %} | |||
| <a href="https://docs.readthedocs.io/page/tutorial/" | |||
| <a href="https://docs.readthedocs.com/platform/stable/intro/doctools.html" | |||
There was a problem hiding this comment.
The list of doc tools doesn't feel like a good place to drop a user that doesn't know how to create a project. I'd leave this link to our tutorial.
I'd like to see our tutorial have some updates to mention other tools.
There was a problem hiding this comment.
The tutorial doesn't communicate what we want to communicate, tho.
- It seems we only support Sphinx
- It mentions "Community" in the first paragraph
- All the screenshots are from the old dashboard
- It's a +30 minutes page --which is a lot of time for a first approach to the platform
I understand that the goal is to improve the tutorial, but we are far from there. We can give a better experience to our users in the meanwhile pointing them to the documentation tools, in my opinion. The user will know what tools we support and they can copy and paste working examples from there.
We can link to the tutorial from the documentation tools if we want to.
There was a problem hiding this comment.
That page needs updates but that doesn't imply we should stop linking to it. It's serving a purpose and does a job that other pages aren't. I disagree the list of tools is a better experience for a user that doesn't know how to add a project.
I think we link to the page you want in addition, but the list of tools is not a place I would point a user asking how to add a project or use RTD.
Instead of linking to the tutorial, we are linking to the doctools. That way, the user can immediately know there are a bunch of doctools supported and it's not just Sphinx.
Closes #436