Feedback for the technical documentation page

Hello Everyone,
I just finished making the technical documentation. I would be happy for some constructive criticism in terms of fonts, colors, anything else that I could do to improve the page.
I made a light and a dark version. I thought I might make a toggle switch later for them.
Here they are:

the light mode:

The dark mode:

Thanks in advance :slight_smile:


1 Like

Your page looks good @Koraavo. Some things to revisit;

  • Run your HTML code through the W3C validator.
    There are HTML syntax/coding errors you should be aware of and address.
    Since copy/paste from codepen you can ignore the first warning and first two errors.
  • Codepen provides validators for HTML, CSS and JS. Click on the chevron in the upxper right of each section and then click on the respective ‘Analyze’ link.
    The one for CSS is good. Use it and address the issue(s).
    (The one for HTML misses things which is why I recommend W3C)

Hi Roma,
Thanks for your inputs. I did go through the Validator and it seems that there are issues similar to the technical-documentation page example by fcc. They ask us to use headers instead of h2/h6 heads. I am going to work on correcting them anyway and shall look at the analyse CSS and make sure it is cleaner :slight_smile:

Thanks so much:)

I mean to correct the errors.
You can ignore those warnings if you’d like. They have to do with semantics.

Ah got it! Let me work on it right away and update the code :slight_smile:
Thanks so much :slight_smile:

1 Like

Done. Now I see only warnings, no errors :slight_smile:
Thanks once again. I learn’t that I was nesting my lists wrongly :slight_smile:

1 Like

This topic was automatically closed 182 days after the last reply. New replies are no longer allowed.