RF: Comment fixes.

Author: maharshi-gor

docs/source/_extra/robots.txt

@@ -1,4 +1,6 @@
 User-agent: *
 Allow: /
+Disallow: /dev/
+Disallow: /v*/
 
-Sitemap: https://fury.gl/sitemap.xml
+Sitemap: https://fury.gl/latest/sitemap.xml

docs/source/_templates/home.html

@@ -3,12 +3,11 @@
 {% block extrahead %}
 {# sphinxext-opengraph skips this page: it has no doctree, so the tags are set here. #}
 <meta name="description" content="FURY - Free Unified Rendering in pYthon. A free and open-source software library for Scientific Visualization and 3D animations.">
-<meta name="keywords" content="FURY, Python, 3D rendering, scientific visualization, animation, simulation, graphics">
 <meta property="og:type" content="website">
 <meta property="og:title" content="FURY - Free Unified Rendering in pYthon">
 <meta property="og:description" content="A free and open-source Python library for Scientific Visualization and 3D animations, GPU accelerated through pygfx and WebGPU.">
-<meta property="og:url" content="https://fury.gl/">
-<meta property="og:image" content="https://fury.gl/_static/images/text-logo.png">
+<meta property="og:url" content="{{ pageurl }}">
+<meta property="og:image" content="{{ pageurl }}_static/images/text-logo.png">
 <meta name="twitter:card" content="summary_large_image">
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>

docs/source/conf.py

@@ -60,12 +60,15 @@
     "sphinxext.opengraph",
 ]
 
+html_baseurl = os.environ.get("SPHINX_HTML_BASE_URL", "https://fury.gl/latest/")
+
 # Open Graph configuration
-ogp_site_url = "https://fury.gl/"
-ogp_image = "https://fury.gl/_static/images/text-logo.png"
+ogp_site_url = html_baseurl
+ogp_image = html_baseurl + "_static/images/text-logo.png"
 
-# Sitemap configuration. The docs are served at the root of html_baseurl, so the
-# default scheme's version/language prefixes are dropped. See _extra/robots.txt.
+# Sitemap configuration. html_baseurl already points at this build's own
+# deploy root (e.g. /dev/, /latest/, /vX.Y.x/), so the default scheme's
+# version/language prefixes are redundant and dropped. See _extra/robots.txt.
 sitemap_filename = "sitemap.xml"
 sitemap_url_scheme = "{link}"
 # Generated indexes and source views, of no value in search results.
@@ -193,7 +196,6 @@
 html_css_files = ["css/fury_theme.css"]
 html_additional_pages = {"index": "home.html"}
 
-html_baseurl = os.environ.get("SPHINX_HTML_BASE_URL", "https://fury.gl/")
 html_extra_path = ["_extra"]
 
 html_logo = "_static/images/logo.svg"

docs/source/getting_started.rst

@@ -2,6 +2,9 @@
 Getting Started
 ===============
 
+.. meta::
+   :description: A quick-start guide to building your first scientific visualization scene with FURY in Python.
+
 Start by importing FURY.
 
 .. code-block:: python

docs/source/installation.rst

@@ -2,6 +2,9 @@
 Installation
 ============
 
+.. meta::
+   :description: Install FURY, the open-source Python library for scientific visualization and 3D animations, via pip or conda.
+
 FURY supports Python 3.5+. You can currently still use Python 2.7 but it will soon stop being supported as the Python 2.7 end of life is on December 31st 2019.
 
 Dependencies

docs/source/introduction.rst

@@ -4,7 +4,6 @@ About
 
 .. meta::
    :description: Discover FURY, a powerful Python library for advanced scientific visualization and 3D animations. Open-source, GPU-accelerated, and easy to use.
-   :keywords: FURY, about FURY, scientific visualization library, 3D animations, GPU acceleration, Pythonic API
 
 Overview
 --------