☂️ Website for release #496
Comments
|
Once i wake up, i'll take care of the tasks that can already be applied to the current website. Then, i'll check out Eleventy! |
|
@sebmck shouldn't the README also be updated to remove the experimental warning and other things to keep in sync with the website? |
|
@sreetamdas Yeah it should. |
|
Just pushed a branch for the new website: EduardoLopes/new-website It setup eleventy with CSS and JS minification, syntax highlighting and automatic table of content using Tocbot. I've added purecss as well, i think it's cool because we don't need to write much css to deal with responsive grids and stuff. And we can use only the parts we need (the base and grids). If it's overkill anyways, it's ok to remove it! There's no design at all, i was just making things run! I care a lot about the design of the site, since i made the logo. I didn't make a doc to describe visual identity, so if you're working on the website, make sure to follow the design of the old website. I can tweak latter, if i feel like. instructions on the README.md! |
|
What points are still in need for documentation? I kind of lost the overview ^^" |
|
@MareikeTaeubner sorry, we're mixing both the "old" Docusaurus site and the "new" Eleventy site. Let's clean this up :) |
|
Your website is down |
|
It’s intentional. The site is at https://preview.romejs.dev/. Having the old site up was confusing because it was outdated. |
|
@sebmck please, change description on repo thanks |
|
New website issues that are unowned/unassigned if anyone is interested:
|
|
@sebmck I think we can close this one, the website is finally live :) |
|
🎉 |
This issue lists improvements that need to be done to the existing website before we release:
Fix dark logo not being used on page load. (You need to flip the toggle twice to correct it)Fixed by @EduardoLopes in Bump docusaurus version #497Remove star count from homepageFixed by @sreetamdas in chore: update website for release #498Update tagline "Rome is an experimental JavaScript toolchain" to "Rome is a JavaScript toolchain"Fixed by @sreetamdas in chore: update website for release #498Update tagline "A compiler, linter, formatter, bundler, testing framework and more" to "Linting, bundling, compiling, testing, and more"Fixed by @sreetamdas in chore: update website for release #498Remove experimental warning bannerFixed by @sreetamdas in chore: update website for release #498Remove Facebook open source footer and bannerRemove the selling point feature titlesMove all separate documentation pages into the homepageDark modeDrop tocbot and add a custom script that generates the TOCFix conflict of heading with the same id (Getting started and Contributing - > Getting Start)Add footer or a section with links for twitter, discord server, open collective and etcI think we should invoke the clean and simple vibe from successful open source projects of old. Notably CoffeeScript, Undercore, and Backbone (Basically any Jeremy Ashkenas project).
We should have a single page website that covers 90% of the documentation someone needs. It can be long. It should load fast. We should have a table of contents on the side to allow for quick jumping with excessive anchors to allow deep linking. It should be readable and understandable from someone reading top to bottom. We can have dedicated subpages for niche or advanced topics.
We don't need to prove ourselves to anyone. We don't need flashy bullet points or a comparison with existing tools right in your face when you go to the landing page. The website should be aimed at serving the users rather than serving as something flashy for adoption. Much less startupy.
It would be nice for us to migrate away from something complicated like Docusaurus that we use to something like Eleventy that better serves the fast single-page content focused website that we want.
The text was updated successfully, but these errors were encountered: