Skip to content

Commit

Permalink
Add OpenGraph and meta descriptions to pages (#282)
Browse files Browse the repository at this point in the history
* Add OpenGraph and meta descriptions to pages

* Update content/pages/enterprise.html

Co-authored-by: Anthony <aj@ohess.org>

* Update content/pages/features.html

Co-authored-by: Anthony <aj@ohess.org>

* Update content/pages/pricing.html

Co-authored-by: Anthony <aj@ohess.org>

---------

Co-authored-by: Anthony <aj@ohess.org>
davidfischer and agjohnson authored Apr 24, 2024
1 parent 0505238 commit 5ba0d29
Showing 15 changed files with 30 additions and 22 deletions.
2 changes: 1 addition & 1 deletion content/pages/choosing-a-platform.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
:title: Choosing a platform
:description: Learn more about our two different platforms and which one is right for you.
:description: Learn more about the differences between Read the Docs community and Read the Docs for Business and which one is right for you.
:template: docutils_page

.. TODO: Figure out how to reuse substitions
13 changes: 7 additions & 6 deletions content/pages/company.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
<html>
<head>
<meta name="title" content="About us" />
<meta name="description" content="Read the Docs is an open source project providing the tools, knowledge, and hosting for some of the world's top documentation teams." />
<meta name="template" content="page" />
<meta name="slug" content="company" />
<meta name="status" content="hidden" />
@@ -19,7 +20,7 @@ <h1 class="ui header massive center aligned">
</h1>
<div class="ui basic vertical huge segment center aligned">
<p>
We are an open source project providing the tools, knowledge and hosting for some of the world's top teams' documentation.
We are an open source project providing the tools, knowledge and hosting for some of the world's top documentation teams.
</p>
</div>
</div>
@@ -54,8 +55,8 @@ <h3 class="ui header big">Growth</h3>
<p>
Read the Docs has grown substantially since its beginning as a weekend project and is closing in on being a top-1000 site on the internet.
</p>
<p>Today, we serve over 55 million pages of documentation a month,
serve over 40 TB of documentation a month,
<p>Today, we serve over 55 million pages of documentation a month,
serve over 40 TB of documentation a month,
host over 80,000 open source projects and support over 100,000 users</p>
</div>
</div>
@@ -89,7 +90,7 @@ <h1 class="ui header massive center aligned">
Who we are
</h1>
</div>

<div class="ui basic segment very padded">
<div class="ui cards five doubling">

@@ -136,7 +137,7 @@ <h1 class="ui header massive center aligned">
<div class="ui segment very padded raised">

<h3 class="ui header"><small><i class="icon heart"></i></small> Contributors</h3>

<div class="ui segment vertical padded">
<div class="ui grid relaxed stackable">
<div class="five wide column">
@@ -201,7 +202,7 @@ <h3 class="ui header">Our docs</h3>
<div class="ui segment basic">
<h3 class="ui header">Subscribe to our newsletter</h3>
<p>
Every time we post a blog post,
Every time we post a blog post,
you can get it in your inbox.
</p>
<p>
1 change: 1 addition & 0 deletions content/pages/comparisons/cloudflare-pages.html
Original file line number Diff line number Diff line change
@@ -3,6 +3,7 @@
<html>
<head>
<title>Read the Docs vs. Cloudflare Pages comparison</title>
<meta name="description" content="Cloudflare Pages is a great product but if you're aiming to host documentation, Read the Docs is the solution built for that use case." />
<meta name="template" content="page" />
<meta name="slug" content="comparisons/cloudflare-pages" />
<meta name="status" content="hidden" />
1 change: 1 addition & 0 deletions content/pages/comparisons/gitbook.html
Original file line number Diff line number Diff line change
@@ -3,6 +3,7 @@
<html>
<head>
<title>Read the Docs vs. GitBook comparison</title>
<meta name="description" content="For technical teams looking for an open source alternative to GitBook with more flexibility, Read the Docs is the perfect solution." />
<meta name="template" content="page" />
<meta name="slug" content="comparisons/gitbook" />
<meta name="status" content="hidden" />
1 change: 1 addition & 0 deletions content/pages/comparisons/github-pages.html
Original file line number Diff line number Diff line change
@@ -3,6 +3,7 @@
<html>
<head>
<title>Read the Docs vs. GitHub Pages comparison</title>
<meta name="description" content="GitHub Pages is an amazing product for hosting sites but if you're aiming to host documentation specifically, Read the Docs has tons of features to make your life easier and the docs experience better." />
<meta name="template" content="page" />
<meta name="slug" content="comparisons/github-pages" />
<meta name="status" content="hidden" />
2 changes: 1 addition & 1 deletion content/pages/docs-as-code.html
Original file line number Diff line number Diff line change
@@ -8,7 +8,7 @@
<meta name="template" content="page" />
<meta name="slug" content="docs-as-code" />
<meta name="status" content="hidden" />
<meta name="description" content="Use docs as code pattern with Read the Docs and supercharge your docs" />
<meta name="description" content="Treat your documentation the same way you treat your code and supercharge your docs. Preview proposed changes from Git, test documentation before it goes live, and automate the publication process." />
</head>
<body>

2 changes: 1 addition & 1 deletion content/pages/enterprise.html
Original file line number Diff line number Diff line change
@@ -8,7 +8,7 @@
<meta name="slug" content="pricing/enterprise" />
<meta name="status" content="hidden" />
<meta name="description"
content="Need more than our self-serve plans? Our Enterprise plans gives you more options." />
content="Need more than our self-serve plans? Our enterprise plans give you more options so we can best support your documentation team." />
</head>

<body>
3 changes: 2 additions & 1 deletion content/pages/features.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
<html>
<head>
<meta name="title" content="Product Features" />
<meta name="description" content="Read the Docs includes docs as code features such as building and hosting documentation, search, previewing changes with pull request previews, and authentication for private documentation." />
<meta name="template" content="page" />
<meta name="status" content="hidden" />
<meta name="slug" content="features" />
@@ -156,7 +157,7 @@ <h1 class="ui huge header">
<div class="ui very padded raised inverted teal large segment">
<h4 class="ui header">
<i class="fad fa-screwdriver-wrench icon"></i>
Bring your own tools
Bring your own tools
</h4>

{% markdown %}
15 changes: 8 additions & 7 deletions content/pages/homepage.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
<html>
<head>
<meta name="title" content="Full featured documentation deployment platform" />
<meta name="description" content="Read the Docs is a documentation building and hosting platform aimed at helping developers creating documentation from code with versioned documentation, integrated search, pull request previews and more." />
<meta name="template" content="page" />
<meta name="save_as" content="index.html" />
<meta name="slug" content="homepage" />
@@ -157,18 +158,18 @@ <h3 class="ui large monospace header">

{# Try it out code block #}
{% include "includes/try-it-out.html" %}

{# Sphinx user testimonials #}
{% include "includes/users-sphinx.html" %}

{% block homepage_bottom_callout %}
<section>
<div class="ui very padded container">
<div class="ui grid center aligned">

<div class="row">
<div class="column twelve wide computer sixteen wide tablet">

{#
TODO replace this block with something more actionable. It's
not saying anything new at this point in the page, and the call
@@ -178,7 +179,7 @@ <h3 class="ui large monospace header">
<p>
<b>Get your docs online in 5 minutes.</b>
</p>

<p>
<a class="ui large teal stackable button"
data-analytics="signup-modal"
@@ -188,10 +189,10 @@ <h3 class="ui large monospace header">
</a>
</p>
</div>

</div>
</div>

</div>
</div>
</section>
2 changes: 1 addition & 1 deletion content/pages/pricing.html
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<html>
<head>
<title>Pricing</title>
<meta name="description" content="Read the Docs is free for publicly hosted open source projects and has plans to meet the needs of businesses who need more features like single sign-on, private documentation, or more build resources." />
<meta name="template" content="page" />
<meta name="slug" content="pricing" />
<meta name="status" content="hidden" />
<meta name="description" content="Pricing for plans on Read the Docs for Business and Read the Docs Community" />
</head>
<body>

1 change: 1 addition & 0 deletions content/pages/privacy-policy.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
:title: Privacy Policy
:template: docutils_page
:description: Read the Docs believes in protecting the privacy of users, authors and readers. These policies are governed by this policy.

Privacy Policy
==============
1 change: 1 addition & 0 deletions content/pages/terms-of-service.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
:title: Terms of Service
:template: docutils_page
:description: Read the Docs is governed by these terms of service.

Terms of Service
================
2 changes: 1 addition & 1 deletion content/pages/tools/jupyter-book.html
Original file line number Diff line number Diff line change
@@ -7,7 +7,7 @@
<meta name="template" content="page" />
<meta name="slug" content="tools/jupyter-book" />
<meta name="status" content="hidden" />
<meta name="description" content="Create an HTML version of your book and publish it online." />
<meta name="description" content="Read the Docs works great with Jupyter Book and can create an HTML version of your Jupyter Book and publish it online automatically." />
</head>
<body>

2 changes: 1 addition & 1 deletion content/pages/tools/mkdocs.html
Original file line number Diff line number Diff line change
@@ -15,7 +15,7 @@
<meta name="template" content="page" />
<meta name="slug" content="tools/mkdocs" />
<meta name="status" content="hidden" />
<meta name="description" content="The best MkDocs deployments with Read the Docs" />
<meta name="description" content="Read the Docs works great with MkDocs for Markdown based documentation. Read the Docs adds great features such as search-as-you-type, previews from Git, and many more." />
</head>
<body>

4 changes: 2 additions & 2 deletions content/pages/tools/sphinx.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{#
{#
The goal of this page is to sell users who are already authoring in Sphinx on the benefits of our hosting.
We aren't focusing on generic Sphinx benefits,
but the unique differentiation of our platform.
@@ -9,7 +9,7 @@
<meta name="template" content="page" />
<meta name="slug" content="tools/sphinx" />
<meta name="status" content="hidden" />
<meta name="description" content="Learn more about the best Sphinx hosting option in the world 🎉" />
<meta name="description" content="Read the Docs was built for Sphinx 🎉. Read the Docs adds great features on top of Sphinx such as search-as-you-type, pull request previews, and many more." />
</head>
<body>

0 comments on commit 5ba0d29

Please sign in to comment.