Proposal to facilitate Style changes in the Docs
Since MR !37 (closed) and !38 (closed) are getting complicated and even tho fixing the issues; they are creating a whole set of different issues.
Right now, we're using https://pmarsceill.github.io/just-the-docs/docs/customization/#override-and-completely-custom-styles to add our GNOME library themes inside Just the Docs, which is not recommended / optimal.
I would recommend that we:
- We need to do #44 and #45 first (@gnome/websites-framework)
- Fork the
just-the-docs
theme from GitHub - Create a new repository for the
gnome-websites-framework-docs
- Make this repository an NPM package
- Refactor Just-the-Docs only to use Tailwind styles.
- Basically, just-the-docs has its own styling
- Remove all of it
- Replace for plain tailwind ;)
- TADA! No more CSS and styling conflicts.
- Add the new docs repository to the NPM registry (npmjs.org) (like @gnome/websites-framework-docs)
- Change the
gnome-websites-framework
to use as dev-dependency thegnome-websites-framework-docs
- Change the pipelines to build the Jekyll of
gnome-websites-framework-docs
- Publish to GitLab pages ;)
It is hard work, and we would need to create some issues both for this repo and the new one. But it would be a great challenge...