stashing

Author: lukegalbraithrussell

docs/content/getting-started.md

@@ -15,8 +15,6 @@ When you're finished, you'll have this ⚡️[Getting Started with Slack app](ht
 
 Before you start developing with Bolt, you'll want to [create a Slack app](https://api.slack.com/apps/new).
 
-[`chat.message`](https://api.slack.com/scopes)
-
 :::tip  
 
 We recommend using a workspace where you won't disrupt real work getting done. Join the [Developer Program](https://api.slack.com/developer-program) and provision a sandbox with access to all Slack features for free.
@@ -524,6 +522,7 @@ You can see that we used `app.action()` to listen for the `action_id` that we na
 ---
 
 ## Next steps {#next-steps}
+
 You just built your first [Bolt for Python app](https://github.com/slackapi/bolt-python/tree/main/examples/getting_started)!
 
 Now that you have a basic app up and running, you can start exploring how to make your Bolt app stand out. Here are some ideas about what to explore next:

docs/i18n/ja-jp/docusaurus-plugin-content-docs/current/getting-started.md

@@ -10,6 +10,7 @@ lang: ja-jp
 
 :::tip 
 
+REMOVE
 このガイドでは[ソケットモード](https://api.slack.com/apis/connections/socket) を利用します。ソケットモードは、Slack アプリ開発をとりあえず始めてみるときやあなたのチームだけのためのアプリをつくるときにおすすめのやり方です。もしすでに HTTP をアプリのコミュニケーションプロトコルとするとわかっている場合は、HTTP の方式に対応した同様のドキュメントである [Bolt 入門ガイド（HTTP）](/tutorial/getting-started-http) を参照してください。
 
 :::
@@ -21,7 +22,7 @@ lang: ja-jp
 
 :::tip 
 
-通常の業務の妨げにならないよう、別の開発用のワークスペースを使用することをおすすめします。[新しいワークスペースは無料で作成できます](https://slack.com/get-started#create)
+通常の業務の妨げにならないよう、別の開発用のワークスペースを使用することをおすすめします。[新しいワークスペースは無料で作成できます](https://api.slack.com/developer-program)
 
 :::。
 

docs/i18n/ja-jp/docusaurus-plugin-content-docs/current/tutorial/getting-started-http.md

@@ -3,41 +3,10 @@ title: Bolt 入門ガイド（HTTP）
 slug: getting-started-http
 lang: ja-jp
 ---
-
-# Bolt 入門ガイド（HTTP）
-
-このガイドでは、**HTTP上で Bolt for Python** を使った Slack アプリの設定と起動する方法について説明します。ここで説明する手順は、新しい Slack アプリを作成し、ローカルの開発環境をセットアップし、Slack ワークスペースからのメッセージをリッスンして応答するアプリを開発するという流れになります。
-
-この手順を全て終わらせたら、あなたはきっと ⚡️[Slack アプリのはじめ方](https://github.com/slackapi/bolt-python/tree/main/examples/getting_started)のサンプルアプリを動作させたり、それに変更を加えたり、自分のアプリを作ったりすることができるようになるでしょう。
-
 ---
 
-### アプリを作成する {#create-an-app}
-最初にやるべきこと : Bolt での開発を始める前に、[Slack アプリを作成](https://api.slack.com/apps/new)します。
-
-:::tip
-
-いつもの仕事のさまたげにならないように、別の開発用のワークスペースを使用することをおすすめします。[新しいワークスペースは無料で作成できます](https://slack.com/get-started#create)。
-
-:::
-
-アプリ名を入力し（_後で変更可能_）、インストール先のワークスペースを選択したら、「`Create App`」ボタンをクリックすると、アプリの **Basic Information** ページが表示されます。
-
-このページでは、アプリの概要を確認できます。また、「**App Credentials**」ヘッダーの下では「`Signing Secret`」などの重要な認証情報も確認できます。これらの認証情報は後で必要になります。
-
-![Basic Information ページ](/img/boltpy/basic-information-page.png "Basic Information ページ")
-
-ひと通り確認し、アプリのアイコンと説明を追加したら、アプリの構成 🔩 を始めましょう。
-
 ---
 
-### トークンとアプリのインストール {#tokens-and-installing-apps}
-Slack アプリでは、[Slack API へのアクセスの管理に OAuth を使用します](https://api.slack.com/docs/oauth)。アプリがインストールされると、トークンが発行されます。アプリはそのトークンを使って API メソッドを呼び出すことができます。
-
-Slack アプリで使用できるトークンには、ユーザートークン（`xoxp`）とボットトークン（`xoxb`）、アプリレベルトークン（`xapp`）の 3 種類があります。
-- [ユーザートークン](https://api.slack.com/authentication/token-types#user) を使用すると、ユーザーがアプリをインストールまたは認証した後、アプリがそのユーザーを代理して API メソッドを呼び出すことができます。1 つのワークスペースに複数のユーザートークンが存在する可能性があります。
-- [ボットトークン](https://api.slack.com/authentication/token-types#bot) はボットユーザーに関連づけられ、1 つのワークスペースでは最初に誰かがそのアプリをインストールした際に一度だけ発行されます。どのユーザーがインストールを実行しても、アプリが使用するボットトークンは同じになります。_ほとんど_のアプリで使用されるのは、ボットトークンです。
-- [アプリレベルトークン](https://api.slack.com/authentication/token-types#app) は、組織に渡ってあなたのアプリを表すものです。所属する組織内の全てのワークスペースに、全ての個人ユーザによってインストールされたアプリについても同様です。アプリレベルトークンは WebSocket 通信を行うアプリを作る際に通常使われます。
 
 説明を簡潔にするために、このガイドではボットトークンを使用します。
 

docs/src/css/custom.css

@@ -1,60 +1,52 @@
-/**
- * Any CSS included here will be global. The classic template
- * bundles Infima by default. Infima is a CSS framework designed to
- * work well for content-centric websites.
- */
-
 :root {
   /* set hex colors here pls */
   --aubergine: #4a154b;
-
   /* aubergine-active is used in light mode. 
   use something like #853c8c if you use as a link vs black text ( 3:1 contr) */
   --aubergine-active: #7c3085;
-
   /* aubergine-light is used in dark mode. #b681b5 is another one. i just made both up */
   --aubergine-light: #ce70cc;
-
   /* horchata is that beige color we use a lot */
   --horchata: #f4ede4;
-
-  /* slack-blue is 36C5F0. used for dark-mode links */
-  --slack-link: #36c5f0;
-  --slack-blue: #36c5f0;
+  /* cloud blue from slack.dev. used for dark-mode links */
+  --slack-cloud-blue: #1ab9ff;
   /* slack marketing color for links 1264A3. used for light-mode links */
   --slack-dark-blue: #1264a3;
-
   --grey: #868686;
-  --white: #FFFFFF;
+  --dim: #eef2f6;
 }
 
 /* resets striped tables that hurt me eyes */
 table tr:nth-child(even) {
   background-color: inherit;
 }
 
-p a {
-  text-decoration: underline;
-  color: var(--slack-link);
+/* changing the links to blue for accessibility  */
+p a, .markdown a {
+  color: var(--slack-cloud-blue);
 }
 
-.markdown a {
-  color: var(--slack-link);
-  text-decoration: underline;
+/* a footer {
+  color: var(--slack-cloud-blue);
+} */
+
+a:hover {
+  color: var(--slack-cloud-blue);
 }
 
 /* adjusting for light and dark modes */
 [data-theme="light"] {
+  --docusaurus-highlighted-code-line-bg: var(--dim);
+  --slack-cloud-blue: var(--slack-dark-blue);
   --ifm-color-primary: var(--aubergine-active);
-  --ifm-footer-background-color: var(--horchata);
-  --slack-link: var(--slack-dark-blue);
 }
 
 [data-theme="dark"] {
-  --ifm-color-primary: var(--aubergine-light);
-  --ifm-navbar-background-color: var(--aubergine);
-  --ifm-footer-background-color: var(--aubergine);
-  --slack-link: var(--slack-blue);
+  --ifm-color-primary: var(--slack-cloud-blue);
+  --ifm-navbar-background-color: black;
+  --method-link-text: white;
+  --scope-link-text: white;
+  --event-link-text: white;
 }
 
 html[data-theme="dark"] {
@@ -66,10 +58,12 @@ html[data-theme="dark"] {
   font-weight: bold;
 }
 
-/* only uncomment for home page -- colors white space on v tall screens */
-/* .main-wrapper {
-  background: var(--horchata);
-} */
+/* increasing name of sdk in sidebar */
+.sidebar-title {
+  font-size: 1.25em; /* Adjust the size as needed */
+  font-weight: bold;
+  color: #000;
+}
 
 /* announcement bar up top */
 div[class^="announcementBar_"] {
@@ -79,16 +73,6 @@ div[class^="announcementBar_"] {
 }
 
 /* navbar */
-
-.sidebar-item-overview a {
-  font-size: 1.2em; /* Adjust size as needed */
-  font-weight: bold;
-}
-
-html[data-theme='light'] .sidebar-item-overview a {
-  --ifm-menu-color: #000;
-}
-
 .navbar-github-link {
   width: 32px;
   height: 32px;
@@ -116,12 +100,53 @@ html[data-theme="dark"] .navbar-github-link::before {
     no-repeat;
 }
 
-.sidebar-title {
-  font-size: 1.25em; /* Adjust the size as needed */
-  font-weight: bold;
-  color: #000;
+/* Docs code bubbles */
+[data-theme="light"] {
+  --code-link-background: #CFE9FE; 
+  --code-link-text:  rgb(21, 50, 59);
+
+  --method-link-background: #CDEFC4;
+  --method-link-text: rgb(0, 41, 0);
+
+  --scope-link-background: #FBF3E0; 
+  --scope-link-text: rgb(63, 46, 0);
+
+  --event-link-background: #FDDDE3;
+  --event-link-text:  rgb(74, 21, 75);
+}
+
+[data-theme="dark"] {
+  --code-link-text: white;
+  --method-link-text: white;
+  --scope-link-text: white;
+  --event-link-text: white;
+  --code-link-background: #1AB9FF50;
+  --method-link-background: #41B65850;
+  --scope-link-background: #FCC00350;
+  --event-link-background: #E3066A50;
+}
+
+a code {
+  background-color: var(--code-link-background);
+  color:  var(--code-link-text);
+}
+
+a[href^="https://api.slack.com/methods"] > code {
+  background-color: var(--method-link-background);
+  color:  var(--method-link-text);
+}
+
+a[href^="https://api.slack.com/scopes"] > code {
+  background-color: var(--scope-link-background);
+  color:  var(--scope-link-text);
+}
+
+a[href^="https://api.slack.com/events"] > code {
+  background-color: var(--event-link-background);
+  color:  var(--event-link-text);
 }
 
+/* Delineate tab blocks */
 .tabs-container {
   border: 2px solid var(--ifm-hr-background-color); /* Adjust the color and thickness as needed */
   border-radius: 5px; /* To give rounded corners */