[GH-ISSUE #1907] man page has poor SEO #966

New issue

Open

opened 2026-03-04 01:50:17 +03:00 by kerem · 2 comments

kerem commented

2026-03-04 01:50:17 +03:00

Owner

Originally created by @gaul on GitHub (Feb 21, 2022).
Original GitHub issue: https://github.com/s3fs-fuse/s3fs-fuse/issues/1907

The man page is hard for users to discover via Google search:

The first result is for a different s3fs, I believe the Python-based one abandoned in 2007, and maybe we can ask the die.net team to update to this s3fs.
The second result looks recent but the date at the bottom is February 2011. We should probably update this date in our source code and before every release.
The third result is for Ubuntu Xenial 16.04, seems like a Google fail since they should prefer the latest version

If the man page is the authoritative source for some information then we should ensure that users can find it. Another approach would be generating the man page from markdown which is more easily understood by crawlers. Related to #1225. CC: @CarstenGrohmann

Originally created by @gaul on GitHub (Feb 21, 2022). Original GitHub issue: https://github.com/s3fs-fuse/s3fs-fuse/issues/1907 The man page is hard for users to discover via [Google search](https://www.google.com/search?q=s3fs%20man%20page&oe=utf-8): * The first result is for a different s3fs, I believe the Python-based one abandoned in 2007, and maybe we can ask the die.net team to update to this s3fs. * The second result looks recent but the date at the bottom is February 2011. We should probably update this date in our source code and before every release. * The third result is for Ubuntu Xenial 16.04, seems like a Google fail since they should prefer the latest version If the man page is the authoritative source for some information then we should ensure that users can find it. Another approach would be generating the man page from markdown which is more easily understood by crawlers. Related to #1225. CC: @CarstenGrohmann

kerem commented

2026-03-04 01:50:18 +03:00

Author

Owner

@ggtakec commented on GitHub (Feb 23, 2022):

@gaul Thanks.
First, I will modify the following part of s3fs.1.
(I hope this is reflected)

.TH S3FS "1" "February 2011" "S3FS" "User Commands"

@ggtakec commented on GitHub (Feb 23, 2022): @gaul Thanks. First, I will modify the following part of `s3fs.1`. (I hope this is reflected) ``` .TH S3FS "1" "February 2011" "S3FS" "User Commands" ```

kerem commented

2026-03-04 01:50:18 +03:00

Author

Owner

@gaul commented on GitHub (Mar 7, 2022):

I emailed the die.net site owner but I am not optimistic since I also did this in 2020.

@gaul commented on GitHub (Mar 7, 2022): I emailed the die.net site owner but I am not optimistic since I also did this in 2020.