Create a new website
cezaraugusto opened this issue · comments
from #435
While GitHub is popular, there are developers that rarely use source control at all, or just prefer another platform, so the website should be the go-to place for interview questions. Ours is kind of old and would be cool to have a better website.
I thought about Docusaurus but any other tool would be great to have.
Please note that after #445 each topic should have its own dedicated page.
Things to discuss:
- which tool?
- which design?
I definitely don't have time to build this in the near future but can definitely help/guide anyone who's interested.
Same. I won't have time to take this on for a month or two, but even until then I can help clear obstacles, etc. for anyone who's interested in picking this up.
I'm interested in working on this. What will it be built with?
@AndrewUsher thanks for your interest. Any tool that could read markdown files and generate pages from that would be nice.
I have a draft in Docusaurus which worked fine but any other tool that makes it would be ok. Let me know if you want to keep from there and I can share it in a branch.
I was planning something like:
- Home (just explaining the project and pointing to useful links)
- Questions (which splits into each question file)
- Contribute
- Contributors
- About (this is a nice to have, can be skipped from the first release)
We may have other tweaks along the way but having something public or in a PR would be a nice start and we can keep the conversation along like page design/architecture.
@cezaraugusto I'll just start working with whatever you have and go on from there.
@AndrewUsher i can help with that. Just say which branch you want to use for develop or with which tasks I can help.
@AndrewUsher @cezaraugusto I'm in as well
@cezaraugusto Is your branch in a place where you can share it? Let's take a look and get this kicked off.
I think there are three basic phases:
- 1. Finalize on a tool. Hopefully this is quick.
- 2. Update the the existing gh-pages branch to use that tool. We're three years out of date, so the sooner the better.
- 3. Iterate on the new site with new pages and a new design
That's not granular at all. Do we need more granular tasks?
To everyone who has volunteered to help, who is interested in doing what? If everyone is interested in doing look and feel or everyone is interested in doing automation we might have a problem :)
There's an existing, albeit barely used Gitter room if we want an open chat to work through the basics
https://gitter.im/h5bp/Front-end-Developer-Interview-Questions
Also, THANK YOU ALL FOR OFFERING TO HELP.
@roblarsen I'm looking at the gitter and see no answer for the branch request there.
Is it being developed privately or wasn't even started?
About the what, I can fill any needed gap.
cc. @cezaraugusto & @AndrewUsher
@GMaiolo I believe @cezaraugusto had a private branch that hasn't been published.
I can create one, but we would have to start from scratch.
I've created new-site
sorry for the delay, busy times. Thanks @roblarsen for the initiative.
Created a branch called "website" which is almost done with the architecture goals I had in mind. Needs rebranding but what we have now is a good start for new grabs. Links work fine and the next person would need to tweak the homepage and make a full rebrand of the website. There are two other pages that need editorial changes too, getting started and about which would be discussed later with the team.
Regarding the home page, we can discuss what to put in there once we have a PR. Rebrand could follow a similar standard of H5BP https://html5boilerplate.com/
To be able to run the website one needs to checkout this repo, checkout website branch then go to website folder following with yarn install && yarn start. Website will open at http://localhost:3000
Current Preview:
regarding the above please feel free to either push a PR with what we have, ping me on this issue or DM me over Twitter (same handler). I'll be glad to help. Let's make it cool!
@cezaraugusto i saw the progress on the branch. I think some things should be done first. What can I help with when I'm working on it? css?
I think that a PR with many changes does not make any sense, right?
@billyjov CSS would be great. We can discuss other things once we have a PR.
I'm open for design feedback but to unblock us for now, you can clone colors defined in https://html5boilerplate.com/. Just make sure the website has a proper branding too.
@cezaraugusto PR opened.
Thanks @billyjov
@cezaraugusto I made some content changes to the home page and the about page.
@roblarsen thanks I'll take it from there
💯
🏗 ?
What's left to do on this?
Is it still possible to contribute to this website?
@AlexanderDLe It is. This ticket has been stalled for a while now.
happy to say that the website is ready at #505. thanks for your patience on this.
closed by #505.