Annaxs commented on issue #25123:
URL: https://github.com/apache/pulsar/issues/25123#issuecomment-4333666234

    Hi, I'd like to work on this issue. Here's my proposed fix:                 
                                                                              
                                                                                
                                                                               
     ---                                                                        
                                                                               
                     
     **Root Cause**                                                             
                                                                               
                     
     The broken link points to 
`https://bookkeeper.apache.org/docs/admin/bookies/autorecovery`, which returns 
404. The correct URL is                          
     `https://bookkeeper.apache.org/docs/admin/autorecovery/` (the `/bookies/` 
segment was removed in a BookKeeper docs restructure).
                                                                                
                                                                               
     Beyond fixing the broken link, Pulsar currently has no dedicated 
AutoRecovery administration page of its own. As @lhotari suggested, the right 
fix is to  
     create `administration-autorecovery.md` in `apache/pulsar-site`.
                                                                                
                                                                               
     ---             
   
     **Proposed Changes (in `apache/pulsar-site`)**                             
                                                                               
      
     1. **Create** `site2/docs/administration-autorecovery.md` — a new page 
covering:                                                                       
   
        - What AutoRecovery is and why it matters
        - How the Auditor and Replication Worker operate                        
                                                                               
        - Enabling/disabling AutoRecovery                                       
                                                                               
        - Key configuration properties (`bookkeeper.conf`)                      
                                                                               
        - Monitoring via Prometheus metrics and BookKeeper shell                
                                                                               
        - Links to the correct BookKeeper AutoRecovery docs and related Pulsar 
pages                                                                           
                                                                                
                                                                               
     2. **Update** `site2/sidebars.json` — register 
`administration-autorecovery` under the Administration section (near 
`administration-bookies`)             
                                                                                
                                                                               
     ---                                                                        
                                                                               
                     
     **Target repo:** `apache/pulsar-site` (not this repo)                      
                                                                               
     **Fixes:** apache/pulsar#25123
                                                                                
                                                                               
     I'll open a PR against `apache/pulsar-site` and link it here once ready


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to