<commit_before>================
 ツールの使い方
================

ここではスタッフ作業でよく使うツールの使い方について説明します。

Slack(チャット)
===============
- http://pyconjp.slack.com/
- ヘルプページ(英語) https://pyconjp.slack.com/help
- メンバー間、各チームでの相談用のチャットです。ログは最新10,000件しか残らないので、記録したい情報はJIRA(課題管理)ツールを使用してください。

Slackの基本的な使い方
---------------------
- `Download Apps <https://slack.com/downloads>`_ でMac、Windows、iOS、Androidなどのアプリが提供されています。使いやすいのでぜひインストールしてください。
- 参加するチャットルーム(channel)の管理(`Browsing and joining channels <https://get.slack.help/hc/en-us/articles/205239967-Browsing-and-joining-channels>`_ 、 `Leaving a channel <https://get.slack.help/hc/en-us/articles/201375146-Leaving-a-channel>`_)

  - channelに参加するには、参加したい channel をクリックして **Join Channel** をクリックします。
  - channelを抜けるには、channel名の横をクリックしてメニューから **Leave channel** を選びます。再度参加することも可能です。
  - 優先して参照したいchannelは、channel名横の **☆** をチェックすると上の方に表示されます。

- 通知(mention)(`Using @mentions <https://get.slack.help/hc/en-us/articles/205240127-Using-mentions>`_ 、 `Making announcements <https://get.slack.help/hc/en-us/articles/202009646-Making-announcements>`_)

  - メッセージに ``@ユーザー名`` と入力とその人にmention(通知)が飛びます。回答がほしいときなどはmentionを使用してください。
  - ``@here`` と入力すると、その部屋にいる現在アクティブな人に通知が飛びます。誰かに相談したいときなどに使うと便利です。
  - ``@channel`` と入力すると、その部屋にいる全員に通知が飛びます。
  - 発言の中に名前だけを入れたい場合は、 ``@`` をつけないで名前だけを書きましょう。(例: XXの件は takanory がやってくれたみたい→報告なのでmentionしない)

- メッセージのフォーマット(`Formatting your messages <https://get.slack.help/hc/en-us/articles/202288908-Formatting-your-messages>`_)

  - ``*アスタリスクで囲む*`` と **太字**
  - ``_アンダースコアで囲む_`` と *イタリック*
  - 最初に ``>`` をつけるとインデントされたテキスト(blockquote)
  - バッククォート(`````)で囲むと ``固定幅のフォント``
  - 3つのバッククォート(```````)で囲むと ``複数行で固定幅フォント``

- メッセージの編集と削除(`Editing or deleting messages <https://get.slack.help/hc/en-us/articles/202395258-Editing-or-deleting-messages>`_)

  - 自分が入力したメッセージをあとから編集、削除できます。
  - 直前のメッセージを編集、削除する場合はカーソルの ``↑`` を入力します。
  - 過去のメッセージの場合は、メッセージの上にカーソルを持っていくとメニューが表示されるので、そこをクリックして編集、削除ができます。

- Slackの使いこなしについては `Using Slack – Slack Help Center <https://get.slack.help/hc/en-us/categories/200111606-Using-Slack>`_ にいろいろヘルプがあるので参照してください。

JIRA(課題管理)
==============
- http://pyconjp.atlassian.net/
- PyCon JP の作業タスク(課題、チケットとも呼ぶ)の管理をするためのツールです。
<commit_msg>SAR-136 add more tips for slack<commit_after>================
 ツールの使い方
================

ここではスタッフ作業でよく使うツールの使い方について説明します。

Slack(チャット)
===============
- http://pyconjp.slack.com/
- ヘルプページ(英語) https://pyconjp.slack.com/help
- メンバー間、各チームでの相談用のチャットです。ログは最新10,000件しか残らないので、記録したい情報はJIRA(課題管理)ツールを使用してください。

Slackの基本的な使い方
---------------------
- `Download Apps <https://slack.com/downloads>`_ でMac、Windows、iOS、Androidなどのアプリが提供されています。使いやすいのでぜひインストールしてください。
- 参加するチャットルーム(channel)の管理(`Browsing and joining channels <https://get.slack.help/hc/en-us/articles/205239967-Browsing-and-joining-channels>`_ 、 `Leaving a channel <https://get.slack.help/hc/en-us/articles/201375146-Leaving-a-channel>`_)

  - channelに参加するには、参加したい channel をクリックして **Join Channel** をクリックします。
  - channelを抜けるには、channel名の横をクリックしてメニューから **Leave channel** を選びます。再度参加することも可能です。
  - 優先して参照したいchannelは、channel名横の **☆** をチェックすると上の方に表示されます。

- 通知(mention)(`Using @mentions <https://get.slack.help/hc/en-us/articles/205240127-Using-mentions>`_ 、 `Making announcements <https://get.slack.help/hc/en-us/articles/202009646-Making-announcements>`_)

  - メッセージに ``@ユーザー名`` と入力とその人にmention(通知)が飛びます。回答がほしいときなどはmentionを使用してください。
  - ``@here`` と入力すると、その部屋にいる現在アクティブな人に通知が飛びます。誰かに相談したいときなどに使うと便利です。
  - ``@channel`` と入力すると、その部屋にいる全員に通知が飛びます。
  - 発言の中に名前だけを入れたい場合は、 ``@`` をつけないで名前だけを書きましょう。(例: XXの件は takanory がやってくれたみたい→報告なのでmentionしない)

- メッセージのフォーマット(`Formatting your messages <https://get.slack.help/hc/en-us/articles/202288908-Formatting-your-messages>`_)

  - ``*アスタリスクで囲む*`` と **太字**
  - ``_アンダースコアで囲む_`` と *イタリック*
  - 最初に ``>`` をつけるとインデントされたテキスト(blockquote)
  - バッククォート(`````)で囲むと ``固定幅のフォント``
  - 3つのバッククォート(```````)で囲むと ``複数行で固定幅フォント``

- メッセージの編集と削除(`Editing or deleting messages <https://get.slack.help/hc/en-us/articles/202395258-Editing-or-deleting-messages>`_)

  - 自分が入力したメッセージをあとから編集、削除できます。
  - 直前のメッセージを編集、削除する場合はカーソルの ``↑`` を入力します。
  - 過去のメッセージの場合は、メッセージの上にカーソルを持っていくとメニューが表示されるので、そこをクリックして編集、削除ができます。

- Slackの使いこなしについては `Using Slack – Slack Help Center <https://get.slack.help/hc/en-us/categories/200111606-Using-Slack>`_ にいろいろヘルプがあるので参照してください。

さらなる使いこなし
------------------
- スター(`Using stars <https://get.slack.help/hc/en-us/articles/201331016-Using-stars>`_)

  - 発言にスターを付けて「お気に入り」に設定できます→あとで見るとかができます。
  - channel にもスターを付けて「お気に入り」に設定できます→チャンネル一覧で上の方に表示されます。
  - スターをつけた項目は、アプリ右上の **☆** をクリックすると参照できます。

- ``/`` コマンド(`Using slash commands <https://get.slack.help/hc/en-us/articles/201259356-Slash-Commands>`_)

  - ``/invite @user`` 指定したユーザーを channel に招待する
  - ``/msg user [message]`` ユーザーにダイレクトメッセージを送る
  - ``/shortcuts`` キーボードショートカットを表示する

- ``/remind`` コマンド

  - 日時とメッセージを指定すると、指定時刻に slackbot がメッセージを自分に送信してくれるので非常に便利です。
  - ``/remind help`` remind コマンドの使い方を表示します。
  - ``/reming list`` 現在登録している remind の一覧を表示します。削除もできます。
  - ``/remind me to [message] at [time]`` time 時刻に message が自分に送信されます。

.. tip::

   /remind コマンドの例::
   
     /remind me to drink water at 3pm every day
     /remind me on June 1st to wish Linda happy birthday
     /remind #team-alpha to update the project status every Monday at 9am
     /remind @jessica about the interview in 3 hours
     /remind @peter tomorrow "Please review the office seating plan"

JIRA(課題管理)
==============
- http://pyconjp.atlassian.net/
- PyCon JP の作業タスク(課題、チケットとも呼ぶ)の管理をするためのツールです。

{'fraction_non_alphanumeric': 0.1774222868569351, 'fraction_numerical': 0.029630976186147972, 'mean_word_length': 5.182022471910113, 'pattern_counts': {'":': 0, '<': 21, '<?xml version=': 0, '>': 23, 'https://': 20, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2841236', 'n_tokens_mistral': 3486, 'n_tokens_neox': 3169, 'n_words': 294}