Open sk1nzz opened 3 years ago
Hi, I assume core team is focused now on pushing next major express
version. If you have something to propose opening a PR is more than welcome!
PRs always welcome, of course, but this proposal would be a significant project. Does Gatsby have a GitHub integration? That's one of the main advantages of Jekyll.
I'd be more than happy to contribute to this, but not sure pushing a massive PR would be helpful.
I'm assuming there are several people involved in maintaining the website, I think they should be involved in the process at the very least with regards to UX and sitemap.
It would likely take several steps to get to an updated version of
Happy to put in work there, but again I'm mostly concerned with how we should break this work down.
I'm fine with either:
@dougwilson I'd be curious to know who leads on the expressjs.com front (yourself?) and where contributors hang out (IRC seems dead and Gitter mostly looks like user support).
There's a lot to be said about a docs and design overhaul.
But let's break it down slightly
The content of the documentation itself is due for shaking the dust out and improving. A full rewrite would be costly in man hours and overseeing it, but would be worth considering. Incremental changes to the corpus in the meantime are the most likely to get merged.
The actual site on which the docs are consumed. Same thing goes in terms of shaking out and improving, and how scope impacts likelihood to get changes landed while maintenance is ramping back up.
Here's a tracking issue where these dicussions will be gathered https://github.com/expressjs/discussions/issues/211
I'd prefer we prio the content of the docs, and lean on some existing software to turn that into a really good hostable docs site. The point of the website is to host the docs and guides. I see the site as an entrypoint to the docs, and should be no more technologically complicated than necessary to facilitate that.
to answer your question @hunvreus @crandmck leads in this repo, doug is a TC member as is rand, but rand specializes in technical writing
Thanks for the discussion @jonchurch @hunvreus ... I'm getting re-engaged with the project after some absence, and the project as a whole is being reinvigorated with short-term focus on the 5.0 release. But still, I'm working on this in my spare time (as most of us are), which is sadly limited.
I agree with @jonchurch that content updates should be the top priority. Certainly, we can improve the presentation (i.e. framework, css, etc.) but that is secondary to the actual information.
See https://github.com/expressjs/discussions/issues/211 for more of my thoughts.
Immediate priorities are reviewing/landing open PRs and issues and preparing for 5.0 release. After that, we can reassess.
Hi there. It's 2020 and Express remains the most popular Node framework. However, we still have an obsolete docs site that doesn't meet today's design trends.
I think it's time to:
Your opinions?