Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refactor doctools marketing pages #341

Open
ericholscher opened this issue Dec 12, 2024 · 0 comments
Open

Refactor doctools marketing pages #341

ericholscher opened this issue Dec 12, 2024 · 0 comments

Comments

@ericholscher
Copy link
Member

We want to use the doc pages as SEO for queries like "hosting mdbook", so we should refactor the website doctool pages to note that we support any tool, and have some good examples of configs and live projects using those tools (with test-builds as a backup).


Now, I feel that we are repeating ourselves by having a "marketing page" and a "documentation page" for every tool. I think we should think a little more about this to avoid this repetition.

We should highlight all the features that Read the Docs adds on top of any documentation tool here with nice copy, images and GIF examples in the marketing site with a list of all the supported doctools pointing to our specific documentation pages. This will simplify the maintenance and also show why Read the Docs is different than a regular hosting providing, promoting what we want to promote: our specific features.

What do you think?

Originally posted by @humitos in #336 (review)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant