Merge branch 'main' into nienn/product-page-template

Author: agjohnson

content/pages/homepage.md

@@ -1,7 +1,6 @@
-title: Read the Docs
-subtitle: Example subtitle
+title: 
+subtitle: 
 template: readthedocs/homepage
 save_as: index.html
 status: hidden
-description: Read the Docs
-
+description: Read the Docs simplifies software documentation by building, versioning, and hosting of your docs, automatically. Think of it as Continuous Documentation.

examples/mockups/index.html

@@ -48,7 +48,7 @@
 
             <div class="column seven wide computer nine wide tablet sixteen wide mobile">
               <h1 class="ui header massive">
-                <span class="ui header">Continuous documentation for technical projects</span>
+                <span class="ui header">Push your docs, <br>we'll do the rest</span>
               </h1>
               <div class="ui basic vertical padded huge segment">
                 <p>
@@ -57,7 +57,7 @@ <h1 class="ui header massive">
               </div>
 
               <div>
-                <a href="https://docs.readthedocs.io/page/intro/getting-started-with-sphinx.html" class="ui button large secondary gradient fade">Start your docs</a>
+                <a href="https://docs.readthedocs.io/page/intro/getting-started-with-sphinx.html" class="ui button large secondary gradient fade">Get started!</a>
                 <a href="./product.html" class="ui button large secondary basic">Learn more</a>
               </div>
 
@@ -146,23 +146,23 @@ <h2 class="ui header">How it works</h2>
                     <img src="images/infographic-01.png">
                   </div>
                   <p>
-                    Write your documentation easily, using .md or .rst, directly in your own IDE, as you work on what maters: your project.
+                    Write your documentation easily, using Markdown or reStructuredText, directly in your own IDE, as you work on what matters: your project.
                   </p>
                 </div>
                 <div class="column center aligned">
                   <div class="ui image">
                     <img src="images/infographic-02.png">
                   </div>
                   <p>
-                    Upload your work to your favorite source code repository hosting service. We support GitHub, GitLab, BitBucket and more.
+                    Read the Docs watches your repository and rebuilds your documentation any time you make a change.
                   </p>
                 </div>
                 <div class="column center aligned">
                   <div class="ui image">
                     <img src="images/infographic-03.png">
                   </div>
                   <p>
-                    Setup your account with Read the Docs, add a .config file to tell us your preferences and we'll do the rest!
+                    Setup your account with Read the Docs, add a <code>.readthedocs.yaml</code> file to set the configuration, and we'll do the rest!
                   </p>
                 </div>
 
@@ -188,11 +188,11 @@ <h2 class="ui header">How it works</h2>
 
               <div class="ui basic vertical huge segment">
                 <p>
-                  We generate, host and manage your documentation versions for you, outputting both html and pdf formats. 
+                  We generate HTML, PDF, and EPUB formats for your project, and host and manage documentation versions for you.
                   Whenever you push code, we'll build your docs.
                 </p>
                 <p>
-                  <big>It Just works.</big>
+                  <big>Get your docs online in 5 minutes.</big>
                 </p>
               </div>
 

examples/mockups/product.html

@@ -59,43 +59,29 @@ <h1 class="ui header massive"><<i>missing</i>> Infographic</h1>
               <h3 class="ui header inverted"><<i>missing</i>> Illustration</h3>
               <h3 class="ui header inverted">Docs as Code</h3>
               <p>
-                Read the Docs simplifies the entire process of building and deploying developer documentation. With support for Sphinx and Mkdocs, you can integrate your code and user-facing documentation using the same tools. Create beautiful documentation easily with themes, and preview every commit with Pull Request previews.
+                Read the Docs simplifies the entire process of building and deploying developer documentation. With support for Sphinx, Mkdocs, and Jupyter Book, you can integrate your code and user-facing documentation using the same tools. Create beautiful documentation easily with themes, and preview every commit with pull request previews.
               </p>
 
               <div class="ui list inverted relaxed divided">
-
-                <div class="item">
-                  <i class="icon check circle green"></i>
-                  <div class="content">
-                    <div class="description">Issue Tracking</div>
-                  </div>
-                </div>
-                
-                <div class="item">
-                  <i class="icon check circle green"></i>
-                  <div class="content">
-                    <div class="description">Version Control</div>
-                  </div>
-                </div>
 
                 <div class="item">
                   <i class="icon check circle green"></i>
                   <div class="content">
-                    <div class="description">Plain Text Markup</div>
+                    <div class="description">Write your docs in plain text for easy review and translation</div>
                   </div>
                 </div>
-                
+
                 <div class="item">
                   <i class="icon check circle green"></i>
                   <div class="content">
-                    <div class="description">Code Reviews</div>
+                    <div class="description">Preview documentation changes before they are merged</div>
                   </div>
                 </div>
 
                 <div class="item">
                   <i class="icon check circle green"></i>
                   <div class="content">
-                    <div class="description">Automated Tests</div>
+                    <div class="description">Receive a Slack notification if your documentation build fails</div>
                   </div>
                 </div>
 
@@ -121,7 +107,14 @@ <h3 class="ui header inverted">Write with reStructuredText or Markdown</h3>
                 <div class="item">
                   <i class="icon check circle green"></i>
                   <div class="content">
-                    <div class="description">Documentation  culture empowerment</div>
+                    <div class="description">Empower your developers to write docs</div>
+                  </div>
+                </div>
+
+                <div class="item">
+                  <i class="icon check circle green"></i>
+                  <div class="content">
+                    <div class="description">Include internal and external cross references</div>
                   </div>
                 </div>
 
@@ -160,7 +153,7 @@ <h3 class="ui header inverted">Easy Documentation Deployment for Technical Teams
                 <div class="item">
                   <i class="icon check circle green"></i>
                   <div class="content">
-                    <div class="description">Multiple Versions</div>
+                    <div class="description">Multiple versions</div>
                   </div>
                 </div>
 

package.json

@@ -5,7 +5,7 @@
   "main": "src/js/index.js",
   "scripts": {
     "clean": "npm run clean-assets && npm run clean-html",
-    "clean-assets": "rm -rfv readthedocs-theme/static/*; exit 0",
+    "clean-assets": "rm -rfv readthedocs-theme/static/{css,js}; exit 0",
     "clean-html": "rm -rfv output/*; exit 0",
     "build": "npm run build-assets && npm run build-html",
     "build-assets": "npm run clean-assets && webpack --mode=production --progress --colors",