Re: New website design: help needed

Thanks for the detailed feedback!

> On 11. Mar 2025, at 20:44, Oswald Buddenhagen via mc-devel <mc-devel-+hD5IHI5XseWCegYutOAJTiNl0CLU6MPYPYVAmT7z5s@public.gmane.org> wrote:
> 
> - i think it's unwise to use a fixed-width font for the main text. i get
>  the "joke", but it looks so alien in a browser.

You have a good point, but I like my joke too much.

Also, I have noticed that it has the positive effect of forcing you to keep the text short. I have struggled with outdated documentation so much lately that I am now painfully aware of how often this aspect is underappreciated.

> - i'm not sure i like the super-subtle links. with just slightly worse
>  lighting/gamma, i wouldn't see them at all.

I just set the base colors of the scheme to ANSI (another inside joke) and let the theme generate the rest. As mentioned in another thread, I'd appreciate PRs with theme improvements.

However, I think this particular problem can be solved by adding underlining for links. I think this is a good thing in general, but not offered by the theme by default, so I decided to go for it.

> - the last paragraph of the intro text is historical trivia. it should
>  be somewhere else, if anywhere at all. maybe generalize "maintainers"
>  to "credits"?

Moved.

> - the intro should probably mention "twin-panel manager (like norton
>  commander)". and a screenshot seems appropriate.

Yes, a screenshot would be nice. But I'm not much of an artist. I think even nicer would be a hip recording with a tool like this:

  https://asciinema.org

Maybe someone can contribute anything other than throwing the list of HTML tags at me... Otherwise, I'll pass for now.

> - the tab deck for the man pages seems a bit silly. it would however
>  make sense to link to html-rendered pages which are uploaded at
>  release time.

Well, it's only semi-silly. I think not many people today would even know how to open the man pages, and even fewer would suspect that a project would use them as a primary source of documentation.

However, the idea of rendering HTML pages has a lot of merit. It was a terrible can of worms to open, but I've added rendering of the development version: 
  https://github.com/MidnightCommander/mc/pull/4666

I don't think the release version makes much sense, unless we do it like many projects do, with a drop-down menu. But that's way too much work for me.

> - don't use contractions in user-facing text.

Like "don't"? OK, I've fixed what I found.

> - the maintainer page lists slava redundantly. while this might be
>  intentional, it doesn't seem useful.

Fixed.


-- 
mc-devel mailing list
mc-devel-+hD5IHI5XseWCegYutOAJTiNl0CLU6MPYPYVAmT7z5s@public.gmane.org
https://lists.midnight-commander.org/mailman/listinfo/mc-devel