51–60 of 79 posts
I like the site! Question, any reason why your internal hyperlinks ( ) jump to beneath the header of the section instead of showing the header of the section?
This is a common issue when using links to jump to page headings, when the top bar has fixed positioning: https://stackoverflow.com/questions/4086107/fixed-page-heade...
Give more context to the site for initial visitors. Its going to be more obvious to those who visited from HN but not to those who stumbled upon it somehow. A little blurb at the top saying this is a reference site for bash scripting syntax and maybe why you saw the need for such a thing would do ease people into the site a bit.
I hate the popup at the bottom, I will hesitate to use the site again because of that (just like many of us avoid news sites with pesky popups), Its a major turn-off. Probably an unpopular opinion around here, but just maybe make a note at the bottom regarding the privacy stuff unless there are legal reasons not to (I'm not up on all the regulations) If you can't avoid it, make it way less intrusive.
Overall its really nice and I love to see better documentation made around old-school linux/bash tools and syntax as I often feel the documentation can be unwieldy with a lot of knowledge assumed. +1 to examples as others have said. Keep it up! :)
Some feedback you probably won't hear from the HN crowd: Give more context to the site for initial visitors. Its going to be more obvious to those who visited from HN but not to those who stumbled upon it somehow. A little blurb at the top saying this is a reference site for bash scripting syntax and maybe why you saw the need for such a thing would do ease people into the site a bit. I hate the popup at the bottom,…
I'll see if I can come with some non-disruptive way of adding some context to the site upon entering it.
Earlier quoted context omitted.
This is a common issue when using links to jump to page headings, when the top bar has fixed positioning: https://stackoverflow.com/questions/4086107/fixed-page-heade...
Ah, and this is why I despise working with CSS/layouting/etc. Thanks!
I always find the context switch to get to a website jarring, and really really love tools that give me documentation on the command line. For example, I can type "go doc foo.Bar" and instantly read the docs for foo.Bar (where foo is usually resolved to example.com/some/go/package/foo, based on what is in go.mod and installed on the system). So for this, I would really like bash's built-in help to show me all this st…
Well, knowing that `[` is the same as `test`, you can `man test` to see the available options.
Personally, I avoid `[` for `[[`. To see the options for that, I do `man bash`, then type `/\[\[`, hit Enter, and press `n` a few times until the list of options appears. It's in the "CONDITIONAL EXPRESSIONS" section.
Almost everything shown in this site is available in bash's manpage.
GNU's `ls` has most of its documentation in `info ls`.
There's no need to turn to websites. All documentation is available locally from the command line. If anything, it just requires a bit of skill in searching. With `man`/`less`, you search with `/` like I showed; in `info`, you search with .
Also, `command [ --help` does work. It's not the same as the built-in, but it should be mostly the same.
I really want to check this out, but my eyes hurt reading the page because the contrast of gray on black is so low. A vision-impaired person might not be able to read it at all. Please consider using this tool to pick a text color that provides sufficient contrast: https://snook.ca/technical/colour_contrast/colour.html#fg=90...
Good advice - didn't cross my mind at all. I'm working on some theming and the contrast should be suited for vision-impaired or have an option for this, in about a week or so.
- There's a lot of info here, so I think you should aim for curation and conciseness, rather than completeness. For example, in File Test Operators, your first two entries (effectively, the first two entries a visitor sees) is `-e` and `-a`, both of which you describe as "File exists", though for the latter, you write: "(identical to -e but is deprecated and outdated)". Is there any reason for `-a` to be included if it's not useful? When I use a cheatsheet, I just want what's most useful, not a full historical reference.
- This is a minor thing, and very much imho, but it was a little distracting to see Times New Roman (or rather, the Mac default serif font) as the base font for the descriptive text, which is a font that I associate with an unstyled (i.e. unpolished) website. IMHO , it looks a bit better in Georgia, or a sans-serif like "Helvetica Neue". Again, just imho, I'm sure others might vehemently disagree.
- The associated twitter handle looks like @shellmagic1 – why not use the handle @shellmagicxyz, which is currently unused?