Dev experience
Eomm opened this issue · comments
We must work to improve the dev experience before working on this website takes days to run and build.
The issues to solve are:
- load a subset of versions to speed up the
npm startcommand. Note that it exists theonlyIncludeVersionsfor this purpose - generate static contents (
plugins.json,benchmarks.jsonetc..) on the fly because the website will not start without these mandatories files - suggestions?
I'll load up the website locally and report back if I think of any suggestions :)
Should we use typescript (tsx)?
I can't launch the project locally. It should be enough to do an npm install then npm start.
What do you think about creating a slack channel to discuss the project?
What do you think about creating a slack channel to discuss the project?
we can create a discord one - will do later today
I can't launch the project locally
Please, read the readme and run npm run build:website too. of course, this is one of the parts we need to improve 😄
I have created the discord channel: https://discord.com/channels/725613461949906985/1067900422376935504
@Eomm I can't access follow this https://support.discord.com/hc/en-us/articles/204155938-How-do-I-invite-friends-to-my-server-
You can find it in the main fastify repo
https://discord.gg/fastify
-
When I opened the repo in Vscode locally, the colors changed, I think it is too vibrant for me 😅
is it necessary to keep the colors saved in Vscode JSON? -
I wonder if there could another way other than installing GitHub CLI to run the website locally.
When I opened the repo in Vscode locally, the colors changed, I think it is too vibrant for me
Here my statement #60 (review)
TLDR: Yes, remove it and send a PR, but I think the suggested plugins are useful
I wonder if there could another way other than installing GitHub CLI to run the website locally.
Yes, but we need someone to replace it with bash scripting + we will need another GitHub token. the client is handy because it deals with it without annoying the dev IMHO
Sadly I've never contributed to the website repo, but my take from the comments it seems that we are mostly lacking portability to be able to run the project easily in locally.
Is there anything else do you think is missed or requires re-work?
@Eomm, I am trying to launch the website locally on my machine, I am following the instructions provided in fastify/website repo to launch the website locally, however npm start command keeps complaining about missing static/generated/benchmarks.json file while running docusaurus start, can someone please help me with this ?
What is the output of npm run build:website?
What is your system?
I am using a mac, when i run npm run build:website it downloads the releases and then it throws this error
node:internal/process/promises:289
triggerUncaughtException(err, true /* fromPromise */);
^
Error: Client network socket disconnected before secure TLS connection was established
at connResetException (node:internal/errors:720:14)
at TLSSocket.onConnectEnd (node:_tls_wrap:1682:19)
at TLSSocket.emit (node:events:524:35)
at endReadableNT (node:internal/streams/readable:1378:12)
at process.processTicksAndRejections (node:internal/process/task_queues:82:21) {
code: 'ECONNRESET',
path: undefined,
host: 'raw.githubusercontent.com',
port: 443,
localAddress: null
}
And then it fails with error [ERROR] Error: Missing generated file: static/generated/benchmarks.json. Run the "npm run build:website" once.
It seems an error connecting to github. are you logged in with your cli?
could you add all the output? it help us to understand which step of the process blocks you
Yes, it was github connectivity indeed. I have logged in but the connection was somehow not getting established, i am able to launch the application now. Please let me know if there are any immediate tasks which i can take up and start contributing.
I would start from this one: #131
No idea here - but you can add be creative!