datastax / cassandra-quarkus

An Apache Cassandra(R) extension for Quarkus
Apache License 2.0
40 stars 28 forks source link

[JAVA-2771] Use fonts and styles for documentation by fetching them via URL instead of hosting in our repo #30

Closed adutra closed 3 years ago

adutra commented 4 years ago

Imported from [JAVA-2771](https://datastax-oss.atlassian.net/browse/JAVA-2771), originally reported by tomekl007 on Wed, 13 May 2020 10:38:20 GMT.


In the [https://datastax-oss.atlassian.net/browse/JAVA-2684](https://datastax-oss.atlassian.net/browse/JAVA-2684) we did implement the documentation of our extension. The generated docs should have the same styles and fonts as used on the quarkus docs site (i.e. [https://quarkus.io/guides/writing-extensions](https://quarkus.io/guides/writing-extensions))

Currently, we needed to copy all fonts and styles from the quarkus repository. It may get out of sync if those styles will be changed in the quarkus repo. Ideally, the quarkus team should expose their styles on the web, then we could use those in the HTML file by importing them via URL.

I’ve asked a question on the cassandra-quarkus extension ticket: [https://github.com/quarkusio/quarkus/issues/7876#issuecomment-626725515](https://github.com/quarkusio/quarkus/issues/7876#issuecomment-626725515)

Once the solution will be provided, we should change our docs.

┆Issue is synchronized with this Jira Task by Unito

adutra commented 3 years ago

Not relevant anymore, closing.