mirror of
https://git.sr.ht/~seirdy/seirdy.one
synced 2024-11-23 21:02:09 +00:00
Compare commits
3 commits
0a51e4d5e6
...
65c6841f6a
Author | SHA1 | Date | |
---|---|---|---|
|
65c6841f6a | ||
|
48607ba2c2 | ||
|
56c9054950 |
8 changed files with 140 additions and 34 deletions
|
@ -57,6 +57,9 @@ My username is Seirdy on Reddit, Hacker News, Lobsters, Tildes.net, Linux Weekly
|
|||
|
||||
My secondary Matrix account for Synapse-only rooms is @seirdy:fairydust.space. My Matrix account used to be @seirdy:envs.net but I've since migrated to my own Conduit server.
|
||||
|
||||
If you want to follow me on Fedi, read this first:
|
||||
=> ../fediverse-greeting/ Fediverse greeting
|
||||
|
||||
|
||||
If you find a "Seirdy" somewhere else and don't know whether or not it's me, please contact me and ask instead of assuming that it must be me.
|
||||
|
||||
|
|
|
@ -80,6 +80,8 @@ At least two platforms listed in the "Social (centralized)" category are not end
|
|||
|
||||
I used to have the Matrix ID `@seirdy:envs.net`. I sometimes use `@seirdy:fairydust.space` for technical reasons (seirdy.one runs a Conduit server but certain features only work in Synapse rooms).
|
||||
|
||||
If you want to follow me on the Fediverse, [read my Fediverse greeting first](../fediverse-greeting/)
|
||||
|
||||
<small>Poggies</small>
|
||||
|
||||
</div>
|
||||
|
|
37
content/fediverse-greeting.gmi
Normal file
37
content/fediverse-greeting.gmi
Normal file
|
@ -0,0 +1,37 @@
|
|||
Hey, I’m @Seirdy@pleroma.envs.net. Please read the “Follow requests” section before following me on the Fediverse (Fedi). The rest is optional.
|
||||
|
||||
## Follow requests
|
||||
|
||||
If you want me to consider accepting your follow request, you need to have made multiple posts. Your profile should also contain at least three of the following:
|
||||
|
||||
* A profile picture
|
||||
* A bio
|
||||
* Your pronouns
|
||||
* A personal website
|
||||
|
||||
If you send a follow request and you haven’t done the above, I’ll wait a day or two before checking again. If you still haven’t done the above, I’ll reject it.
|
||||
|
||||
If you frequently and knowingly interact with hateful instances, I will respond to your follow request by blocking you. And possibly muting your instance.
|
||||
|
||||
## Moving
|
||||
|
||||
I’ll eventually move from Pleroma to my own Gotosocial instance, for many reasons. I’m first waiting for Misskey to fix its HTTP signatures so that it can federate with Gotosocial.
|
||||
|
||||
## Fedi practices
|
||||
|
||||
If I say something insensitive or interact with someone I shouldn’t, please let me know so I can be better.
|
||||
|
||||
I try to always always add content-warnings (CWs) to sensitive topics. Sometimes, I CW “regular” topics; common examples include “TechPost”, “accessibility”, and “shitpost”. The latter type of CW allows you to reduce the prevalence of some of my interests in your timeline.
|
||||
|
||||
I am okay with you using whichever post-visibility you wish when replying to me, but I speak only for myself. If I want to talk to you privately I will use an alternate means of communication.
|
||||
|
||||
If I want to make a well-thought-out post that could benefit others, I’ll post it to my website’s “notes” section and syndicate it to Fedi with the “#POSSE” (Publish on Own Site, Syndicate Elsewhere) hashtag.
|
||||
|
||||
=> https://seirdy.one/notes/ My notes
|
||||
=> https://indieweb.org/posse POSSE
|
||||
|
||||
My notes also have a dedicated Atom and RSS feed. This is much lower-volume and “cleaner” than my Fediverse profile, if that’s what you prefer.
|
||||
|
||||
I will probably not boost pictures lacking alt-text, descriptions in the post body, or captions in comments. If I see a nice un-captioned picture, I’ll comment with my own caption instead. I often use a screen reader to reduce overstimulation and eye strain, and I sometimes use textual clients that can't display images; alt-text is really important to me!
|
||||
|
||||
I restricted my followers after I already had a few hundred so be aware that I didn’t approve them all.
|
44
content/fediverse-greeting.md
Normal file
44
content/fediverse-greeting.md
Normal file
|
@ -0,0 +1,44 @@
|
|||
---
|
||||
outputs:
|
||||
- html
|
||||
- gemtext
|
||||
title: Fediverse greeting
|
||||
description: "Fediverse-related information about Seirdy. Follow-request information, Fedi practices, etc."
|
||||
date: "2022-06-11T18:20:00+00:00"
|
||||
---
|
||||
Hey, I'm [@Seirdy@pleroma.envs.net](https://pleroma.envs.net/Seirdy). Please read the "Follow requests" section before following me on the Fediverse (<abbr title="Fediverse">Fedi</abbr>). The rest is optional.
|
||||
|
||||
Follow requests
|
||||
---------------
|
||||
|
||||
If you want me to consider accepting your follow request, you need to have made multiple posts. Your profile should also contain at least three of the following:
|
||||
|
||||
- A profile picture
|
||||
- A bio
|
||||
- Your pronouns
|
||||
- A personal website
|
||||
|
||||
If you send a follow request and you haven't done the above, I'll wait a day or two before checking again. If you still haven't done the above, I'll reject it.
|
||||
|
||||
If you frequently and knowingly interact with hateful instances, I will respond to your follow request by blocking you. And possibly muting your instance.
|
||||
|
||||
Moving
|
||||
------
|
||||
|
||||
I'll eventually move from Pleroma to my own Gotosocial instance, for many reasons. I'm first waiting for Misskey to fix its HTTP signatures so that it can federate with Gotosocial.
|
||||
|
||||
Fedi practices
|
||||
--------------
|
||||
|
||||
If I say something insensitive or interact with someone I shouldn't, please let me know so I can be better.
|
||||
|
||||
I try to always always add content-warnings (<abbr title="content-warn or content-warning">CWs</abbr>) to sensitive topics. Sometimes, I CW "regular" topics; common examples include "TechPost", "accessibility", and "shitpost". The latter type of CW allows you to reduce the prevalence of some of my interests in your timeline.
|
||||
|
||||
I am okay with you using whichever post-visibility you wish when replying to me, but I speak only for myself. If I want to talk to you privately I will use an alternate means of communication.
|
||||
|
||||
If I want to make a well-thought-out post that could benefit others, I'll post it to [my website's "notes" section](../notes/) and syndicate it to Fedi with the "#POSSE" ([Publish on Own Site, Syndicate Elsewhere](https://indieweb.org/posse)) hashtag. My notes also have a dedicated Atom and RSS feed. This is much lower-volume and "cleaner" than my Fediverse profile, if that's what you prefer.
|
||||
|
||||
I will probably not boost pictures lacking alt-text, descriptions in the post body, or captions in comments. If I see a nice un-captioned picture, I’ll comment with my own caption instead. I often use a screen reader to reduce overstimulation and eye strain, and I sometimes use textual clients that can't display images; alt-text is really important to me!
|
||||
|
||||
I restricted my followers after I already had a few hundred so be aware that I didn't approve them all.
|
||||
|
|
@ -38,7 +38,9 @@ Options:
|
|||
|
||||
1. Borders in TUIs should always be drawn with characters specifically intended for textual interfaces (e.g., boxdraw characters). While I do think the GIF followed this advice, I think it’s worth explicitly saying it. Accessible terminal emulators can figure out what these mean and factor them into what they report through an accessibility API. But breaking these borders up with descriptive text makes detection of readable text error-prone.
|
||||
|
||||
2. Decorative content in CLI output should be limited, since the output of CLI utilities can be piped through other programs. At the very least, these tools should be able to detect whether their standard output is being re-directed or piped and sanitize output accordingly.
|
||||
2. Borders should be used sparingly, as they end up causing issues when the window is re-sized.[1] Re-sizing terminal windows is quite common: think about the combined user-base of tiling window managers, tiling terminal session managers (Tmux, Screen, etc.), multiplexing terminal emulators, and plain old split-windows.
|
||||
|
||||
3. Decorative content in CLI output should be limited, since the output of CLI utilities can be piped through other programs. At the very least, these tools should be able to detect whether their standard output is being re-directed or piped and sanitize output accordingly.
|
||||
|
||||
The “Colours, Emojis, and Layouting” (sic) section has similar issues:
|
||||
|
||||
|
@ -62,7 +64,7 @@ This is a non-exhaustive list of simple, baseline recommendations for designing
|
|||
|
||||
Avoiding reliance on color and using whitespace and/or indentation for pseudo-headings are two sample recommendations from the WCAG.
|
||||
|
||||
4. Write man pages! Man pages have a standardized,[1] predictable, searchable format. Many screen-reader users actually have special scripts to make it easy to read man pages. A man page is also trivial to convert to HTML for people who prefer web-based documentation.[2] If your utility has a config file with special syntax or vocabulary, write a dedicated man page for it in section 5 and mention it in a “SEE ALSO” section.[3]
|
||||
4. Write man pages! Man pages have a standardized,[2] predictable, searchable format. Many screen-reader users actually have special scripts to make it easy to read man pages. A man page is also trivial to convert to HTML for people who prefer web-based documentation.[3] If your utility has a config file with special syntax or vocabulary, write a dedicated man page for it in section 5 and mention it in a “SEE ALSO” section.[4]
|
||||
|
||||
5. Try adding shell completions for your program, so users can tab-complete options. This is particularly helpful in shells like Zsh that support help-text in tab completions, especially when combined with plugins like fzf-tab that enable fuzzy-searching help-text (see "code snippet 2")
|
||||
|
||||
|
@ -70,13 +72,13 @@ Avoiding reliance on color and using whitespace and/or indentation for pseudo-he
|
|||
|
||||
6. Related to no. 5: use a well-understood format for "-h" and "--help" output. This makes auto-generating shell completions much easier. Alternatively, delegate the generation of both to a library that follows this advice.
|
||||
|
||||
7. Follow convention: use POSIX-like options. Consider supplementing them with GNU-style long options if your tool has a significant number of them.[4]
|
||||
7. Follow convention: use POSIX-like options. Consider supplementing them with GNU-style long options if your tool has a significant number of them.[5]
|
||||
|
||||
8. Either delegate output wrapping to the terminal, or detect the number of columns and format output to fit. Prefer the former when given a choice, especially when the output is not a TTY.
|
||||
|
||||
9. Make sure your web-based documentation and forge frontends are accessible, or are mirrored somewhere with good accessibility. I love what the Gitea folks are doing, but sadly their web frontend has a number of critical issues.[5] For now, if your forge has accessibility issues, mirroring to GitHub and/or Sourcehut seems like a good option.
|
||||
9. Make sure your web-based documentation and forge frontends are accessible, or are mirrored somewhere with good accessibility. I love what the Gitea folks are doing, but sadly their web frontend has a number of critical issues.[6] For now, if your forge has accessibility issues, mirroring to GitHub and/or Sourcehut seems like a good option.
|
||||
|
||||
10. Avoid breaking changes to you program’s CLI. Remember that its argument parsing is an API, unless documentation explicitly states otherwise.[6] Semantic versioning is your friend.
|
||||
10. Avoid breaking changes to you program’s CLI. Remember that its argument parsing is an API, unless documentation explicitly states otherwise.[7] Semantic versioning is your friend.
|
||||
|
||||
11. Be predictable. Users expect "git log" to print a commit log. Users do not expect "git log" to make network connections, write something to their filesystem, etc. Try to only perform the minimum functionality suggested by the command. Naturally, this disqualifies opt-out telemetry.
|
||||
|
||||
|
@ -102,7 +104,7 @@ $ moac -
|
|||
|
||||
These considerations are far more subjective, debatable, and deserving of skepticism than the previous recommendations. There’s a reason I call this section “considerations”, not “recommendations”. Exceptions abound; I’m not here to think on your behalf.
|
||||
|
||||
1. Remember that users aren’t always at their best when they read "--help" output; they could be trying to solve a frustrating problem, feeling a great deal of anxiety. Keep the output clean, predictable, boring, and *fast.* A 2-second delay and spinning fans will probably be extremely unpleasant for already-stressed users, especially if they need to use it often.[7]
|
||||
1. Remember that users aren’t always at their best when they read "--help" output; they could be trying to solve a frustrating problem, feeling a great deal of anxiety. Keep the output clean, predictable, boring, and *fast.* A 2-second delay and spinning fans will probably be extremely unpleasant for already-stressed users, especially if they need to use it often.[8]
|
||||
|
||||
2. Include example usage in your man pages and accompanying documentation. Consider submitting the example usage to the tldr-pages project if your tool gets popular:
|
||||
=> https://tldr.sh/ tldr-pages
|
||||
|
@ -123,12 +125,12 @@ These considerations are far more subjective, debatable, and deserving of skepti
|
|||
|
||||
8. Don’t conflate CLIs and TUIs. A CLI should be non-interactive; a TUI should be interactive. Exceptions exist for really simple interfaces (e.g. Magic-Wormhole and others like it) that accept user input; however, as the interface grows more complex, consider splitting the program into two sibling programs, one of which can have a “pure” non-interactive CLI.
|
||||
|
||||
9. Go above and beyond by writing separate integrations for environments like Emacspeak.[8]
|
||||
9. Go above and beyond by writing separate integrations for environments like Emacspeak.[9]
|
||||
=> http://emacspeak.sourceforge.net/ Emacspeak homepage
|
||||
|
||||
## Name conflicts
|
||||
|
||||
This section might be the most important part of this post. If a CLI executable has a binary name conflict, packagers may have to re-name it. Otherwise, users will have to juggle $PATH overrides.[9]
|
||||
This section might be the most important part of this post. If a CLI executable has a binary name conflict, packagers may have to re-name it. Otherwise, users will have to juggle $PATH overrides.[10]
|
||||
|
||||
Before publishing your software, test for binary name conflicts. Many package managers have built-in functionality to search for package files. I recommend doing so with large repositories to test for conflicts.
|
||||
|
||||
|
@ -164,22 +166,24 @@ Thanks to Emily for reminding me of this on Fedi.
|
|||
|
||||
## Footnotes
|
||||
|
||||
1. Well, they’re *somewhat* standardized compared to plain stdout.
|
||||
1. Yes, it's possible to support re-sizing by using a TUI library like ncurses. Unfortunately, TUIs are out of scope for this article; I'm focusing mainly on CLIs.
|
||||
|
||||
2. My other article on accessible textual websites is probably relevant when it comes to Web-based documentation:
|
||||
2. Well, they’re *somewhat* standardized compared to plain stdout.
|
||||
|
||||
3. My other article on accessible textual websites is probably relevant when it comes to Web-based documentation:
|
||||
=> gemini://seirdy.one/posts/2020/11/23/website-best-practices/ Best practices for inclusive textual websites
|
||||
|
||||
3. For more on man page sections, see the "man" man page.
|
||||
4. For more on man page sections, see the "man" man page.
|
||||
|
||||
4. I need to take my own advice for programs like MOAC. Ugh.
|
||||
5. I need to take my own advice for programs like MOAC. Ugh.
|
||||
|
||||
5. See this Fediverse thread about forge accessibility:
|
||||
6. See this Fediverse thread about forge accessibility:
|
||||
=> https://mastodon.technology/@codeberg/108403449317373462
|
||||
|
||||
6. For a good example, see Git’s distinction between regular output and porcelain-friendly output. The instability of the former and stability of the latter are explicitly documented in the Git man pages and in the official Git book.
|
||||
7. For a good example, see Git’s distinction between regular output and porcelain-friendly output. The instability of the former and stability of the latter are explicitly documented in the Git man pages and in the official Git book.
|
||||
|
||||
7. The slow responses to basic flags like "--help" is one of many reasons I dislike Java command-line utilities (signal-cli, Nu HTML Checker). I believe I’m not alone when I say this.
|
||||
8. The slow responses to basic flags like "--help" is one of many reasons I dislike Java command-line utilities (signal-cli, Nu HTML Checker). I believe I’m not alone when I say this.
|
||||
|
||||
8. I used to not-very-seriously claim that Neovim, my preferred $EDITOR, is better than Emacs. Then I tried Emacspeak. I still make the same claim, but more softly and with an exception for Emacspeak.
|
||||
9. I used to not-very-seriously claim that Neovim, my preferred $EDITOR, is better than Emacs. Then I tried Emacspeak. I still make the same claim, but more softly and with an exception for Emacspeak.
|
||||
|
||||
9. A notable exception is executables that are supposed to conflict with others. Distributions like Fedora, Debian, and derivatives have an “alternatives” system to manage these overrides using symlinks. Examples include toolchains (`cc` and `ld` could point to their GCC or Clang implementations) and mail transfer agents (`sendmail` and `mta` have been re-implemented many times over).
|
||||
10. A notable exception is executables that are supposed to conflict with others. Distributions like Fedora, Debian, and derivatives have an “alternatives” system to manage these overrides using symlinks. Examples include toolchains (`cc` and `ld` could point to their GCC or Clang implementations) and mail transfer agents (`sendmail` and `mta` have been re-implemented many times over).
|
||||
|
|
|
@ -54,7 +54,9 @@ Options:
|
|||
|
||||
1. Borders in TUIs should always be drawn with characters specifically intended for textual interfaces (e.g., boxdraw characters). While I do think the GIF followed this advice, I think it's worth explicitly saying it. Accessible terminal emulators can figure out what these mean and factor them into what they report through an accessibility API. But breaking these borders up with descriptive text makes detection of readable text error-prone.
|
||||
|
||||
2. Decorative content in CLI output should be limited, since the output of CLI utilities can be piped through other programs. At the very least, these tools should be able to detect whether their standard output is being re-directed or piped and sanitize output accordingly.
|
||||
2. Borders should be used sparingly, as they end up causing issues when the window is re-sized.[^1] Re-sizing terminal windows is quite common: think about the combined user-base of tiling window managers, tiling terminal session managers (Tmux, Screen, etc.), multiplexing terminal emulators, and plain old split-windows.
|
||||
|
||||
3. Decorative content in CLI output should be limited, since the output of CLI utilities can be piped through other programs. At the very least, these tools should be able to detect whether their standard output is being re-directed or piped and sanitize output accordingly.
|
||||
|
||||
The "Colours, Emojis, and Layouting" (sic) section has similar issues:
|
||||
|
||||
|
@ -73,19 +75,19 @@ This is a non-exhaustive list of simple, baseline recommendations for designing
|
|||
|
||||
3. Refer to the latest <abbr title="Web Content Accessibility Guidelines">WCAG</abbr> publication (currently WCAG 2.2) and take a look at the applicable criteria. Many have [accompanying techniques for plain-text interfaces.](https://w3c.github.io/wcag/techniques/#text). Avoiding reliance on color and using whitespace and/or indentation for pseudo-headings are two sample recommendations from the WCAG.
|
||||
|
||||
4. Write man pages! Man pages have a standardized,[^1] predictable, searchable format. Many screen-reader users actually have special scripts to make it easy to read man pages. A man page is also trivial to convert to HTML for people who prefer web-based documentation.[^2] If your utility has a config file with special syntax or vocabulary, write a dedicated man page for it in section 5 and mention it in a "SEE ALSO" section.[^3]
|
||||
4. Write man pages! Man pages have a standardized,[^2] predictable, searchable format. Many screen-reader users actually have special scripts to make it easy to read man pages. A man page is also trivial to convert to HTML for people who prefer web-based documentation.[^3] If your utility has a config file with special syntax or vocabulary, write a dedicated man page for it in section 5 and mention it in a "SEE ALSO" section.[^4]
|
||||
|
||||
5. Try adding shell completions for your program, so users can tab-complete options. This is particularly helpful in shells like Zsh that support help-text in tab completions, especially when combined with plugins like [fzf-tab](https://github.com/Aloxaf/fzf-tab) that enable fuzzy-searching help-text (see [code snippet 2](#code-2)).
|
||||
|
||||
6. Related to no. 5: use a well-understood format for `-h` and `--help` output. This makes auto-generating shell completions much easier. Alternatively, delegate the generation of both to a library that follows this advice.
|
||||
|
||||
7. Follow convention: use POSIX-like options. Consider supplementing them with GNU-style long options if your tool has a significant number of them.[^4]
|
||||
7. Follow convention: use POSIX-like options. Consider supplementing them with GNU-style long options if your tool has a significant number of them.[^5]
|
||||
|
||||
8. Either delegate output wrapping to the terminal, or detect the number of columns and format output to fit. Prefer the former when given a choice, especially when the output is not a TTY.
|
||||
|
||||
9. Make sure your web-based documentation and forge frontends are accessible, or are mirrored somewhere with good accessibility. I love what the Gitea folks are doing, but sadly their web frontend has a number of critical issues.[^5] For now, if your forge has accessibility issues, mirroring to GitHub and/or Sourcehut seems like a good option.
|
||||
9. Make sure your web-based documentation and forge frontends are accessible, or are mirrored somewhere with good accessibility. I love what the Gitea folks are doing, but sadly their web frontend has a number of critical issues.[^6] For now, if your forge has accessibility issues, mirroring to GitHub and/or Sourcehut seems like a good option.
|
||||
|
||||
10. Avoid breaking changes to you program's CLI. Remember that its argument parsing is an API, unless documentation explicitly states otherwise.[^6] Semantic versioning is your friend.
|
||||
10. Avoid breaking changes to you program's CLI. Remember that its argument parsing is an API, unless documentation explicitly states otherwise.[^7] Semantic versioning is your friend.
|
||||
|
||||
11. Be predictable. Users expect `git log` to print a commit log. Users do not expect `git log` to make network connections, write something to their filesystem, etc. Try to only perform the minimum functionality suggested by the command. Naturally, this disqualifies opt-out telemetry.
|
||||
|
||||
|
@ -111,7 +113,7 @@ $ moac -
|
|||
|
||||
These considerations are far more subjective, debatable, and deserving of skepticism than the previous recommendations. There's a reason I call this section "considerations", not "recommendations". Exceptions abound; I'm not here to think on your behalf.
|
||||
|
||||
1. Remember that users aren't always at their best when they read `--help` output; they could be trying to solve a frustrating problem, feeling a great deal of anxiety. Keep the output clean, predictable, boring, and _fast._ A 2-second delay and spinning fans will probably be extremely unpleasant for already-stressed users, especially if they need to use it often.[^7]
|
||||
1. Remember that users aren't always at their best when they read `--help` output; they could be trying to solve a frustrating problem, feeling a great deal of anxiety. Keep the output clean, predictable, boring, and _fast._ A 2-second delay and spinning fans will probably be extremely unpleasant for already-stressed users, especially if they need to use it often.[^8]
|
||||
|
||||
2. Include example usage in your man pages and accompanying documentation. Consider submitting the example usage to the [tldr pages](https://tldr.sh/) project if your tool gets popular.
|
||||
|
||||
|
@ -127,12 +129,12 @@ These considerations are far more subjective, debatable, and deserving of skepti
|
|||
|
||||
8. Don't conflate CLIs and TUIs. A CLI should be non-interactive; a TUI should be interactive. Exceptions exist for really simple interfaces (e.g. Magic-Wormhole and others like it) that accept user input; however, as the interface grows more complex, consider splitting the program into two sibling programs, one of which can have a "pure" non-interactive CLI.
|
||||
|
||||
9. Go above and beyond by writing separate integrations for environments like [Emacspeak](http://emacspeak.sourceforge.net/).[^8]
|
||||
9. Go above and beyond by writing separate integrations for environments like [Emacspeak](http://emacspeak.sourceforge.net/).[^9]
|
||||
|
||||
Name conflicts
|
||||
--------------
|
||||
|
||||
This section might be the most important part of this post. If a CLI executable has a binary name conflict, packagers may have to re-name it. Otherwise, users will have to juggle `$PATH` overrides.[^9]
|
||||
This section might be the most important part of this post. If a CLI executable has a binary name conflict, packagers may have to re-name it. Otherwise, users will have to juggle `$PATH` overrides.[^10]
|
||||
|
||||
Before publishing your software, test for binary name conflicts. Many package managers have built-in functionality to search for package files. I recommend doing so with large repositories to test for conflicts.
|
||||
|
||||
|
@ -177,22 +179,24 @@ References and further reading
|
|||
</section>
|
||||
|
||||
|
||||
[^1]: Well, they're _somewhat_ standardized compared to plain stdout.
|
||||
[^1]: Yes, it's possible to support re-sizing by using a TUI library like ncurses. Unfortunately, TUIs are out of scope for this article; I'm focusing mainly on CLIs.
|
||||
|
||||
[^2]: [My other article on accessible textual websites](https://seirdy.one/posts/2020/11/23/website-best-practices/) is probably relevant when it comes to Web-based documentation
|
||||
[^2]: Well, they're _somewhat_ standardized compared to plain stdout.
|
||||
|
||||
[^3]: For more on man page sections, see the [`man(1)`](https://man.openbsd.org/man) man page.
|
||||
[^3]: [My other article on accessible textual websites](https://seirdy.one/posts/2020/11/23/website-best-practices/) is probably relevant when it comes to Web-based documentation
|
||||
|
||||
[^4]: I need to take my own advice for programs like [moac](https://sr.ht/~seirdy/moac). Ugh.
|
||||
[^4]: For more on man page sections, see the [`man(1)`](https://man.openbsd.org/man) man page.
|
||||
|
||||
[^5]: See [this Fediverse thread](https://mastodon.technology/@codeberg/108403449317373462) about forge accessibility.
|
||||
[^5]: I need to take my own advice for programs like [moac](https://sr.ht/~seirdy/moac). Ugh.
|
||||
|
||||
[^6]: For a good example, see Git's distinction between regular output and porcelain-friendly output. The instability of the former and stability of the latter are explicitly documented in the Git man pages and in the official Git book.
|
||||
[^6]: See [this Fediverse thread](https://mastodon.technology/@codeberg/108403449317373462) about forge accessibility.
|
||||
|
||||
[^7]: The slow responses to basic flags like `--help` is one of many reasons I dislike Java command-line utilities (signal-cli, Nu HTML Checker). I believe I'm not alone when I say this.
|
||||
[^7]: For a good example, see Git's distinction between regular output and porcelain-friendly output. The instability of the former and stability of the latter are explicitly documented in the Git man pages and in the official Git book.
|
||||
|
||||
[^8]: I used to not-very-seriously claim that Neovim, my preferred `$EDITOR`, is better than Emacs. Then I tried Emacspeak. I still make the same claim, but more softly and with an exception for Emacspeak.
|
||||
[^8]: The slow responses to basic flags like `--help` is one of many reasons I dislike Java command-line utilities (signal-cli, Nu HTML Checker). I believe I'm not alone when I say this.
|
||||
|
||||
[^9]: A notable exception is executables that are supposed to conflict with others. Distributions like Fedora, Debian, and derivatives have an "alternatives" system to manage these overrides using symlinks. Examples include toolchains (`cc` and `ld` could point to their GCC or Clang implementations) and mail transfer agents (`sendmail` and `mta` have been re-implemented many times over).
|
||||
[^9]: I used to not-very-seriously claim that Neovim, my preferred `$EDITOR`, is better than Emacs. Then I tried Emacspeak. I still make the same claim, but more softly and with an exception for Emacspeak.
|
||||
|
||||
[^10]: A notable exception is executables that are supposed to conflict with others. Distributions like Fedora, Debian, and derivatives have an "alternatives" system to manage these overrides using symlinks. Examples include toolchains (`cc` and `ld` could point to their GCC or Clang implementations) and mail transfer agents (`sendmail` and `mta` have been re-implemented many times over).
|
||||
|
||||
|
||||
|
|
|
@ -238,10 +238,12 @@ I’m unable to evaluate these engines properly since I don’t speak the necess
|
|||
* Sogou: Chinese
|
||||
* Yisou: Chinese
|
||||
* Naver: Korean. Allows submitting sitemaps and feeds. Discovered via some Searx metasearch instances.
|
||||
* Daum: Korean. Also unsure about its independence.
|
||||
* Seznam: Czech, seems relatively privacy-friendly. Discovered in the seirdy.one access logs. It allows site submission with webmaster tools.
|
||||
* Cốc Cốc: Vietnamese
|
||||
* go.mail.ru: Russian
|
||||
|
||||
=> https://www.daum.net/ Daum (Korean)
|
||||
=> https://search.naver.com Naver
|
||||
=> https://www.seznam.cz/ Seznam
|
||||
=> https://coccoc.com/search Cốc Cốc
|
||||
|
@ -249,11 +251,13 @@ I’m unable to evaluate these engines properly since I don’t speak the necess
|
|||
|
||||
### Smaller indexes
|
||||
|
||||
* ALibw.com: Chinese, found in my access logs.
|
||||
* Vuhuv: Turkish
|
||||
* Parsijoo: Persian
|
||||
* search.ch: Regional search engine for Switzerland; users can restrict searches to their local regions.
|
||||
* fastbot: German
|
||||
|
||||
=> https://www.alibw.com/ ALibw.com (Chinese)
|
||||
=> https://www.vuhuv.com.tr/ Vuhuv
|
||||
=> https://tr.vuhuv.com/ Yuhuv (alternate domain)
|
||||
=> https://www.parsijoo.ir/ Parsijoo
|
||||
|
@ -268,6 +272,10 @@ I’m unable to evaluate these engines properly since I don’t speak the necess
|
|||
=> https:solofield.net SOLOFIELD
|
||||
=> https://kaz.kz/ kaz.kz
|
||||
|
||||
### Unknown
|
||||
|
||||
I'm unable to determine if these engines are independent; help would be appreciated!
|
||||
|
||||
## Misc
|
||||
|
||||
* Ask.com: The site is back. They claim to outsource search results. The results seem similar to Google, Bing, and Yandex; however, I can’t pinpoint exactly where their results are coming from. Also, several sites from the "ask.com network" such as directhit.com, info.com, and kensaq.com have uniqe-looking results.
|
||||
|
|
|
@ -230,6 +230,8 @@ I'm unable to evaluate these engines properly since I don't speak the necessary
|
|||
|
||||
- [Naver](https://search.naver.com): Korean. Allows submitting sitemaps and feeds. Discovered via some Searx metasearch instances.
|
||||
|
||||
- [Daum](https://www.daum.net/): Korean. Also unsure about this one's independence.
|
||||
|
||||
- [Seznam](https://www.seznam.cz/): Czech, seems relatively privacy-friendly. Discovered in the seirdy.one access logs. It allows site submission with webmaster tools.
|
||||
|
||||
- [Cốc Cốc](https://coccoc.com/search): Vietnamese
|
||||
|
@ -238,6 +240,8 @@ I'm unable to evaluate these engines properly since I don't speak the necessary
|
|||
|
||||
### Smaller indexes
|
||||
|
||||
- [ALibw.com](https://www.alibw.com/): Chinese, found in my access logs.
|
||||
|
||||
- [Vuhuv](https://www.vuhuv.com.tr/): Turkish. [alt domain](https://tr.vuhuv.com/)
|
||||
|
||||
- [Parsijoo](https://www.parsijoo.ir/): Persian
|
||||
|
|
Loading…
Reference in a new issue