dashboard / erock/docs / docs: rewrite api-token page #63 rss

accepted · opened on 2025-04-13T17:09:08Z by noelle
Help
checkout latest patchset: 
ssh pr.pico.sh print pr-63 | git am -3
checkout any patchset in a patch request: 
ssh pr.pico.sh print ps-X | git am -3
add changes to patch request: 
git format-patch main --stdout | ssh pr.pico.sh pr add 63
add review to patch request: 
git format-patch main --stdout | ssh pr.pico.sh pr add --review 63
accept PR: 
ssh pr.pico.sh pr accept 63
close PR: 
ssh pr.pico.sh pr close 63

Logs

noelle created pr with ps-129 on 2025-04-13T17:09:08Z
erock added ps-130 on 2025-04-14T14:19:40Z
erock changed status on 2025-04-14T14:19:40Z {"status":"accepted"}

Patchsets

ps-129 by noelle on 2025-04-13T17:09:08Z
Range Diff ↕ rd-130
-: ------- > 1: 5ea2b3a lgtm
-: ------- > 2: fc5db9c docs: rewrite api-token page
1: 6429512 ! 3: 5ea2b3a chore: add token tui img
ps-130 by erock on 2025-04-14T14:19:40Z

Patchset ps-129

docs: rewrite api-token page

Noelle Leigh
2025-04-13T16:51:44Z
posts/api-token.md
+9 -8
Back to top

docs: rewrite api-token page

* Capitalized example items
* Removed screenshot that showed the old TUI.
  I didn't replace it because I didn't want to use a different terminal
  style than the other screenshots.
* Added Usage header
* Rewrote usage steps to be ordered, and reflect the new TUI
posts/api-token.md link
+9 -8 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

diff --git a/posts/api-token.md b/posts/api-token.md
index a6bf423..b10afb3 100644
--- a/posts/api-token.md
+++ b/posts/api-token.md
@@ -7,13 +7,14 @@ API tokens are used for when we cannot leverage SSH pubkey authentication.
 
 Common examples:
 
-- account recovery
-- [connecting to our bouncer](/irc)
-- pico+ rss feed
+- Account recovery
+- [Connecting to our IRC bouncer](/irc)
+- Pico+ rss feed
 
-![pico-token-menu](https://blog.pico.sh/pico-token-menu.png)
+## Usage
 
-- SSH into our [pico TUI](/ui#ssh-tui)
-- Select "Manage Tokens" submenu
-- Type "n" to generate a new token
-- Save token someplace safe
+1. SSH into our [pico TUI](/ui#ssh-tui)
+2. Select "tokens" submenu
+3. Type <kbd>c</kbd> to generate a new token
+4. Give it a descriptive name
+5. Copy the generated token string to where you want to use it