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

Range-diff rd-130

title
lgtm
description
Patch added
old #0
(none)
new #1
5ea2b3a
title
docs: rewrite api-token page
description
Patch added
old #0
(none)
new #2
fc5db9c
title
chore: add token tui img
description
Patch changed
old #1
6429512
new #3
5ea2b3a
Back to top
-: ------- > 1: 5ea2b3a lgtm
-: ------- > 2: fc5db9c docs: rewrite api-token page

old


                    


                    

                      
new

                      

                        
                          old:posts/api-token.md
                          new:posts/api-token.md
                        
                      

                      
 
 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)
+![token-tui](token-tui.png)
 
-- SSH into our [pico TUI](/ui#ssh-tui)
-- Select "Manage Tokens" submenu
-- Type "n" to generate a new token
-- Save token someplace safe
+## Usage
+
+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


                    

                  

                

          

          

            

              
                1:  6429512 ! 3:  5ea2b3a chore: add token tui img
              
            


            
            

              

                
                
author changed

                

                  
- Noelle Leigh <noelle_leigh@fastmail.com>

                  
+ Eric Bower <me@erock.io>

                

                
                
                
title changed

                

                  
- docs: rewrite api-token page

                  
+ chore: add token tui img

                

                
                
                
message changed

                

                  
- * 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

                  
+ 

                

                
              

            

            

            

                  

                    

                      
old

                      

                        
                          old:posts/api-token.md
                          new:posts/api-token.md
                        
                      

                      
 
 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


                    


                    

                      
new

                      

                        
                      

                      

                    

                  

                
                  

                    

                      
old

                      

                        
                      

                      

                    


                    

                      
new

                      

                        
                          
                          new:static/token-tui.png