Light theme for the documentation

[AzarguNazari]

The documentation seems very nice written, however the dark theme seems very uneasy to read. The light theme would be a great help for reading the doc.

[jasperblues]

Hello @AzarguNazari. Thanks for opening this issue.

Many folks prefer a light theme, and we'll gladly accept a pull request for the asciidocs. It is something that has been discussed in past issues. I can point you at the history if you're interested!

Otherwise, if you want access to a light theme today, I suggest using the Embabel Hub (pictured). There is an early access for the hub here: https://hub.docker.com/r/embabel/hub

Besides having a very nice light (and dark) theme to read the docs, there is an Embabel-powered chatbot that has access to docs, sourcecode and other resources to answer questions for you. There are different ways to read the docs, but this will definitely be the recommended way for most folks in the future.

[AzarguNazari]

Thanks @jasperblues for sharing it. The Embabel documentation could be migrated to Astro which seems good fit for the modern docs. It turns .md into more manageable pages. Here is an example I tried out. Easy page management, SEO friendly, and easy theme change.

[alexheifetz]

@jasperblues should we transfer this over to discussion?

[jasperblues]

@alexheifetz Yeah let's discuss first and then we can create some issues as needed.

[jasperblues]

@AzarguNazari The Astro documentation looks good! We're focusing energy on releasing the hub at the moment. The hub currently ingests the asciidocs, turning them into .mdx. (It could easily ingest .md though). The hub is expected to be how must people prefer to read the docs, with asciidocs as a simpler alternative.

If you wanted to outline a plan and contribute Astro as the simpler alternative, we're happy to consider that kind of contribution from the community.