Veido ziņu kartītes

Kartītes uzbūve

Kartītes daļas no augšas uz leju. Izlaid to, kas nav vajadzīgs: kartīte tikai ar virsrakstu arī der.

#github

Message from GitHub• acme/web

Atvērts pull request #212

Open

Ātrāka meklēšana kanālu sarakstā

Meklēšana tagad notiek pēc katra taustiņsitiena ar 120 ms debounce.

Autors

maya

Recenzenti

dani, sam

10:03

+86-12

1. Galvene„Message from“ un nosaukums: webhook nosaukums vai, ja tā ir atbilde uz komandu, tavas kopienas nosaukums. Atbilde var pievienot badge, piemēram, repozitoriju.
2. Virsraksts un statusstitle, kas kļūst par saiti, ja iestati title_url, ar status birku blakus.
3. ApakšvirsrakstsOtrā treknā rinda, sub_title.
4. AprakstsPamatteksts, markdown formātā.
5. LaukiNosaukuma un vērtības rindas ar kopēšanas pogu.
6. KājeneLaiks, kā arī pievienotās un dzēstās rindas, ja tās nosūti.

{
  "message_container": {
    "type": "embed_message",
    "badge": "acme/web",
    "color": "purple",
    "title": "Pull request #212 opened",
    "title_url": "https://github.com/acme/web/pull/212",
    "status": { "label": "Open", "color": "green", "icon": "pull_request" },
    "sub_title": "Faster search in the channel list",
    "description": "Search now runs **per keystroke** with a 120 ms debounce.",
    "fields": [
      { "field": "Author", "value": "maya" },
      { "field": "Reviewers", "value": "dani, sam" }
    ],
    "additions": 86,
    "deletions": 12,
    "files_changed": 3
  }
}

Visi lauki

Šie lauki tiek likti message_container. Kartītei vajadzīgs apraksts vai ielādes indikators. Lauki ar atzīmi „Komandu atbildes“ tiek izmesti, ja publicē caur webhook.

Statuss un diff statistika

Statusa birka izstāsta notikušo, pirms kāds izlasa tekstu. Tā atrodas blakus virsrakstam vai, ja virsraksta nav, kājenē; diff statistika redzama blakus laikam. Abas darbojas komandu atbildēs, un tās izmanto iebūvētā GitHub integrācija. Webhook tās izmet.

#github

Message from GitHub• acme/web

Pull request #212 sapludināts

Merged

11:20

Message from CI• acme/web

Būvējums zarā main neizdevās

Failing

search.test.js: neizdevās 2 no 212 testiem.

11:24

Message from GitHub• acme/web

maya veica push uz main

Commit

11:31

+14-3

{
  "message_container": {
    "color": "red",
    "title": "Build failed on main",
    "status": { "label": "Failing", "color": "red" },
    "description": "`search.test.js`: 2 of 212 tests failed."
  }
}

Ikonas

Kartējums, kas der GitHub

Iebūvētā GitHub integrācija izmanto šīs vērtības; nokopē tās saviem rīkiem.

Ielāde un spriešana

Visam, kas aizņem brīdi, piemēram, MI atbildei vai ilgam darbam, vispirms publicē kartīti ar rotējošu indikatoru un pēc tam aizstāj to ar rezultātu. Ielādes indikators darbojas webhook un komandu atbildēs. Komandas atbildē modeļa spriešanu vari ielikt arī laukā thinking: dalībnieki redz slēdzi Show thinking, nevis teksta sienu.

#assistant

Message from Assistant

Domāju…Lasu pēdējās 50 ziņas

09:02

Vispirms: ielādes indikators

#assistant

Message from Assistant

maya: kad ir standup?

Standup ir 09:30, kanālā #daily.

Show thinking

Pārbaudīju piespraustās ziņas un regulāro notikumu kanālā #daily.

09:02

Pēc tam: atbilde ar sakļautu spriešanu

{
  "message_container": {
    "type": "embed_message",
    "color": "blue",
    "loader": true,
    "loader_text": "Thinking…",
    "loader_sub_text": "Reading the last 50 messages"
  }
}

{
  "message_container": {
    "type": "embed_message",
    "color": "blue",
    "sub_title": "maya: when is the standup?",
    "description": "Standup is at **09:30**, in #daily.",
    "thinking": "Checked the pinned messages and the recurring event in #daily…"
  }
}

Lai ielādes indikatoru nomainītu pret atbildi, atjaunini ziņu ar jaunu kartīti bez loader. Kā to izdarīt, skaidrots lapā atjauninājumi reāllaikā.

Gari apraksti

Apraksts var būt līdz 50 000 baitiem. Pēc pirmajiem 1000 dalībnieki redz sākumu un pogu Show more, kas ielādē pārējo, tāpēc gara atskaite nepārpludina kanālu.

Sistēmas ziņas

Iestati "type": "system_message", ja tas ir paziņojums, nevis bota ieraksts: apkopes logi, noteikumu izmaiņas, viss, kas runā pašas kopienas vārdā. Tai ir tie paši lauki un pogas.

{
  "message_container": {
    "type": "system_message",
    "color": "orange",
    "title": "Maintenance tonight",
    "description": "The build servers are down from 22:00 to 23:00."
  }
}

Krāsas

Malas krāsa ir ātrākais signāls kartītē. Vienam un tam pašam ziņu veidam vienmēr lieto vienu un to pašu krāsu.