Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Lack of contrast and separators in topics #351

Open
denil-ct opened this issue Jun 9, 2022 · 2 comments
Open

Lack of contrast and separators in topics #351

denil-ct opened this issue Jun 9, 2022 · 2 comments

Comments

@denil-ct
Copy link

denil-ct commented Jun 9, 2022

I feel like the different color given to the topics at the end of each page was a nice touch in the previous style. That along with the separators between topic headers helped to group information better. Both of those are missing in the new style. Adding the separator lines alone will help a lot in improving grouping among topics.

New Style

image

Old Style

image

@karwa
Copy link

karwa commented Jul 16, 2022

I think this can be improved significantly by adding separators between each topic section. I've implemented it on my fork of docc-render: karwa@0efb533

And here's the live documentation, if you want to see how it looks in practice:

https://karwa.github.io/swift-url/main/documentation/weburl/weburl

image

@denil-ct
Copy link
Author

Yes @karwa , this looks great and much more readable at a glance.

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

No branches or pull requests

2 participants