about summary refs log tree commit diff
path: root/web/atward/src/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'web/atward/src/index.html')
-rw-r--r--web/atward/src/index.html75
1 files changed, 75 insertions, 0 deletions
diff --git a/web/atward/src/index.html b/web/atward/src/index.html
new file mode 100644
index 000000000000..c9a7c494e97b
--- /dev/null
+++ b/web/atward/src/index.html
@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="description" content="The Virus Lounge">
+<link rel="stylesheet" type="text/css" href="https://tvl.fyi/static/tazjin.css" media="all">
+<link rel="icon" type="image/webp" href="https://tvl.fyi/static/favicon.webp">
+<title>TVL Search</title>
+<body class="light">
+  <header>
+    <h1><a class="blog-title" href="/">atward</a></h1>
+    <hr/>
+  </header>
+
+  <p>
+    <b>atward</b> is <a href="https://tvl.fyi/">TVL's</a> search
+    service. It can be configured as a browser search engine for easy
+    access to TVL bugs, code reviews, code paths and more.
+  </p>
+
+  <h3>Setting up atward</h3>
+  <p>
+    To configure atward, add a search engine to your browser with the
+    following search string:
+    <pre>  https://at.tvl.fyi/?q=%s</pre>
+    Consider setting a shortcut, for example <b>t</b> or <b>tvl</b>.
+    You can now quickly access TVL resources by typing something
+    like <kbd>t b/42</kbd> in your URL bar to get to the bug with ID
+    42.
+  </p>
+
+  <h3>Supported queries</h3>
+  <p>
+    The following query types are supported in atward:
+    <ul>
+      <li><kbd>b/42</kbd> - access bugs with ID 42</li>
+      <li><kbd>cl/3087</kbd> - access changelist with ID 3087</li>
+      <li><kbd>//web/atward</kbd> - open the <b>//web/atward</b> path in TVLs monorepo</li>
+    </ul>
+  </p>
+
+  <h3>Configuration</h3>
+  <p>
+    Some behaviour of atward can be configured by adding query
+    parameters to the search string:
+    <ul>
+      <li><kbd>cs=true</kbd> - use Sourcegraph instead of cgit to view code</li>
+    </ul>
+  </p>
+  <p class="cheddar-callout cheddar-todo">
+    In <b>Firefox</b>, configuring query parameters is difficult as
+    users can not edit search engines directly. There are browser
+    extensions and other workarounds for this issue, but we do not
+    recommend any particular one.
+  </p>
+
+  <h3>Source code</h3>
+  <p>
+    atward's source code lives
+    at <a href="https://atward.tvl.fyi/?q=%2F%2Fweb%2Fatward">//web/atward</a>.
+  </p>
+
+  <hr/>
+  <footer>
+    <p class="footer">
+      <a class="uncoloured-link" href="https://cs.tvl.fyi/depot/-/blob/README.md">code</a>
+      |
+      <a class="uncoloured-link" href="https://cl.tvl.fyi/">reviews</a>
+      |
+      <a class="uncoloured-link" href="https://b.tvl.fyi/">bugs</a>
+      |
+      <a class="uncoloured-link" href="https://todo.tvl.fyi/">todos</a>
+    </p>
+    <p class="lod">ಠ_ಠ</p>
+  </footer>
+</body>