Add Markdoc page to website marketing

[ericholscher]

This links to our newly created doc page

---

📚 Documentation preview 📚: https://readthedocs-about--336.org.readthedocs.build/

[humitos]

This looks good to me.

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?

[ericholscher]

This looks good to me.

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?

Strong agree. I just did the quick version to get some SEO out the door, but I definitely think we want to make these a bit more systematic and nicer over time with stuff that you mentioned.

[ericholscher]

@humitos 👍 on merging this for now, and we can iterate on all the landing pages for style?

[ericholscher]

@humitos would be good to either 👍 this, or maybe we close this out, and work on the refactor that we mentioned?

[humitos]

We can merge this 👍🏼 . Honestly, I don't think we are adding too much value here other than SEO since we are not explaining anything new in these pages.

I think the useful/important work is the refactor of these pages as we've been mentioning. That would give us the value the users are looking for.

[ericholscher]

@humitos Sounds good. We should break out a roadmap card to track that work, and put it on the next sprint perhaps?

Edit: created #341