Bug 1214914

Summary: [doc] Issue in "Repairing and checking file systems"
Product: [SUSE Linux Enterprise Server] PUBLIC SUSE Linux Enterprise Server 15 SP3 Reporter: Mark Harvey <mark.harvey>
Component: DocumentationAssignee: Tomáš Bažant <tbazant>
Status: RESOLVED FIXED QA Contact: Frank Sundermeyer <fs>
Severity: Normal    
Priority: P5 - None CC: mark.harvey
Version: unspecifiedFlags: tbazant: needinfo? (mark.harvey)
Target Milestone: unspecified   
Hardware: Other   
OS: Other   
Whiteboard: https://jira.suse.com/browse/DOCTEAM-1111
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Mark Harvey 2023-09-03 16:34:02 UTC 
For these sections in our documentation, 

40.5.2.2 Repairing and checking file systems

https://documentation.suse.com/sles/15-SP3/single-html/SLES-administration/#sec-trouble-data-recover-rescue-filesystem

40.5.2.2 Repairing and checking file systems

https://documentation.suse.com/sles/15-SP3/html/SLES-all/cha-trouble.html#sec-trouble-data-recover-rescue-filesystem

I'm requesting an expansion on dealing with BTRFS file systems. 

Is fsck.FILESYSTEM an alias for using fsck on specific file systems?  


Request the following:  

1. avoid using alias commands ; use specific commands

2. correct the paragraph ; remove "fsck.btrfs" ; add "btrfs check" 

3. reference the storage guide section on BTRFS
https://documentation.suse.com/sles/15-SP3/single-html/SLES-storage/

4. add TID:  How to recover from BTRFS errors
https://www.suse.com/support/kb/doc/?id=000018769

5. add TID:  BTRFS Master TID
https://www.suse.com/support/kb/doc/?id=000018779


6. add a second paragraph that references the following site

https://btrfs.readthedocs.io/en/latest/btrfs-check.html
Comment 1 Tomáš Bažant 2023-09-13 07:23:10 UTC 
Thank you for reporting this bug!
It is being tracked and processed as part of our queue.
Comment 2 Tomáš Bažant 2023-10-09 13:58:28 UTC 
progress is tracked in https://github.com/SUSE/doc-sle/pull/1601
@MArk, can you review pls?
Comment 3 Tomáš Bažant 2023-10-10 10:36:45 UTC 
fixed by https://github.com/SUSE/doc-sle/commit/f7e3a97431cc9de4524beddbc0e7248fd3826fe7, reopen if needed