doc: overhaul documentation

Author: null8626

docs/Makefile

@@ -1,10 +1,10 @@
 # Minimal makefile for Sphinx documentation
 #
 
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-SPHINXPROJ    = topggpy
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = .
 BUILDDIR      = _build
 
@@ -17,4 +17,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_static/css/custom.css

@@ -0,0 +1,40 @@
+document.addEventListener('load', () => {
+  try {
+    document.querySelector('.edit-this-page').remove()
+    
+    // remove these useless crap that appears on official readthedocs builds
+    document.querySelector('#furo-readthedocs-versions').remove()
+    document.querySelector('.injected').remove()
+  } catch {
+    // we're building this locally, forget it
+  }
+})
+
+const tocDrawer = document.querySelector('aside.toc-drawer')
+
+if (document.querySelector('section#topggpy')) {
+  // we don't need the right sidebar on the main landing page
+  tocDrawer.remove()
+} else {
+  tocDrawer.style.visibility = 'visible'
+}
+
+// remove related pages in the footer
+document.querySelector('.related-pages').remove()
+
+// remove all header links
+for (const headerLink of document.querySelectorAll('.headerlink')) {
+  headerLink.remove()
+}
+
+for (const page of document.querySelectorAll('.sidebar-scroll li')) {
+  const link = page.querySelector('a')
+  const label = page.querySelector('label')
+
+  if (label) {
+    link.addEventListener('click', event => {
+      event.preventDefault()
+      label.click()
+    })
+  }
+}

docs/_static/favicon.ico

@@ -0,0 +1,65 @@
+body {
+  --color-link-underline: rgba(0, 0, 0, 0%);
+  --color-link-underline--hover: var(--color-link);
+  --color-inline-code-background: rgba(0, 0, 0, 0%);
+  --color-api-background-hover: var(--color-background-primary);
+  --color-highlight-on-target: var(--color-background-primary) !important;
+  --font-stack: "Manrope", sans-serif !important;
+  --font-stack--monospace: "Roboto Mono", monospace !important;
+}
+
+aside.toc-drawer {
+  visibility: hidden;
+}
+
+#furo-readthedocs-versions, .injected, .edit-this-page, .related-pages, .headerlink {
+  visibility: hidden;
+  user-select: none;
+}
+
+dd dt {
+  color: var(--color-foreground-secondary);
+}
+
+aside.toc-drawer .docutils:hover, .sidebar-brand-text:hover {
+  transition: 0.15s;
+  filter: opacity(75%);
+}
+
+.highlight *, em {
+  font-style: normal !important;
+  text-decoration: none !important;
+  font-weight: normal !important;
+}
+
+.sig-paren, span.p, :not(.sig-name) > span.pre {
+  font-weight: normal !important;
+}
+
+:not(h1) > a.reference {
+  text-decoration: underline;
+}
+
+:not(h1) > a.reference:hover {
+  text-decoration: none;
+}
+
+.field-even p strong, .field-odd p strong {
+  font-family: var(--font-stack--monospace);
+}
+
+h1 > a.reference:hover {
+  text-decoration: underline;
+}
+
+h1 {
+  font-weight: 900;
+}
+
+.sidebar-brand-text {
+  font-weight: bolder;
+}
+
+.sidebar-scroll .reference.internal {
+  color: var(--color-brand-primary);
+}

docs/_static/img/favicon-16x16.png

@@ -1,7 +1,14 @@
-####################
-Client API Reference
-####################
+Client reference
+================
 
-.. automodule:: topgg.client
-    :members:
-    :inherited-members:
+.. autoclass:: topgg.client.Client
+   :members:
+
+.. autoclass:: topgg.errors.Error()
+   :members:
+
+.. autoclass:: topgg.errors.RequestError()
+   :members:
+
+.. autoclass:: topgg.errors.Ratelimited()
+   :members: