Skip to content

Docs dark theme rebased#1210

Merged
dgarcia360 merged 8 commits intoscylladb:masterfrom
kwiato:docs-dark-theme-rebased
Sep 20, 2024
Merged

Docs dark theme rebased#1210
dgarcia360 merged 8 commits intoscylladb:masterfrom
kwiato:docs-dark-theme-rebased

Conversation

@kwiato
Copy link
Copy Markdown
Contributor

@kwiato kwiato commented Sep 17, 2024

No description provided.

@dgarcia360
Copy link
Copy Markdown
Collaborator

Some comments:

  • Icon not rendering as expected:
image
  • Icon not aligned:
image
  • Icon significant smaller than the previous version -> is it intended?
image
  • Review default label color in light mode:
image
  • Review announcement button color in dark mode:
image
  • Review icons spacing:
image
  • The "User mailing list" icon should not render, we removed it recently:
image
  • Dropdown arrows are smaller -> is it intended?
image
  • Test do not pass. I'll send the fix.

}
}

.scylla-icon {
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks safe to remove part of these icons if we do not use them anymore and they are defined in the new icons font.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wanted to wait untill tested in other docs

@@ -1,102 +1,121 @@
/* Color names from https://chir.ag/projects/name-that-color */
:root {
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We are currently defining colors in two separate files: base/_variables.scss and variables/_colors.scss. To improve maintainability, we should consolidate these into a single file. Additionally, we should remove any unused variables and colors.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree, just want to make sure I don't break anything right now.

Comment thread src/css/main.scss Outdated
@@ -1,4 +1,6 @@
@import "~foundation-sites/dist/css/foundation.min.css";
@import "../../node_modules/foundation-sites/dist/css/foundation.min.css";
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is this change necessary?

@kwiato kwiato force-pushed the docs-dark-theme-rebased branch from 5e620c0 to 358366a Compare September 19, 2024 14:02
@dgarcia360
Copy link
Copy Markdown
Collaborator

dgarcia360 commented Sep 20, 2024

Feedback:

  • The "x" button to close the announcement banner has disappeared:
image
  • When navigating between pages in dark mode, the light mode briefly flashes for a few milliseconds. We can work on this as part of a separate PR. To evaluate if it's a blocker for releasing.

  • Review the footer in responsive mode:

    image

    Before:

    image
  • It's important to clean up the codebase before the release:

    We are currently defining colors in two separate files: base/_variables.scss and variables/_colors.scss. To improve maintainability, we should consolidate these into a single file. Additionally, we should remove any unused variables and colors.

    Styles are only defined in this project for all projects, so it should be safe to update them as long as we test them. If you'd prefer not to address this in the current PR, we can handle it as part of a separate one.

@dgarcia360
Copy link
Copy Markdown
Collaborator

Fixed tests: 70811e4

@dgarcia360
Copy link
Copy Markdown
Collaborator

Icons that are not using the new icons library:

  • Left sidebar expand button (fas fa-bars):
    image

  • Tables checks (fa fa-check) and cross marks (fa fa-times)
    image

  • Hero box & topic documentation examples: /examples/hero-box & /examples/topic-box

This was referenced Sep 20, 2024
@kwiato kwiato force-pushed the docs-dark-theme-rebased branch from 70811e4 to 6a2a3ef Compare September 20, 2024 11:11
@dgarcia360
Copy link
Copy Markdown
Collaborator

LGTM. Let's wait for @annastuchlik review before merging.

New issues derived from the changes in this PR:

To decide if we want to include them in the next release.

@dgarcia360 dgarcia360 self-requested a review September 20, 2024 11:36
Copy link
Copy Markdown
Collaborator

@annastuchlik annastuchlik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great :)

@annastuchlik
Copy link
Copy Markdown
Collaborator

@kwiato @dgarcia360 Thank you :) We can now merge and move on :)

@dgarcia360 dgarcia360 merged commit 566db08 into scylladb:master Sep 20, 2024
@tzach
Copy link
Copy Markdown
Collaborator

tzach commented Sep 24, 2024

@annastuchlik
Copy link
Copy Markdown
Collaborator

@tzach We need to merge this PR: #1216
We'll do it today.
The new version contains major changes, so we have do release the new theme with separate PRs.

@annastuchlik
Copy link
Copy Markdown
Collaborator

What I mean is that Dark Theme is part of the new theme that needs to be released yet.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants