Hi, I'm trying to contribute to <https://github.co...

# docs-revamped

[Piotr Krzemiński]

Hi, I'm trying to contribute to https://github.com/JetBrains/kotlin-web-site (add a non-trivial issue where local testing is a must) but I cannot make the server run locally. The README says "Currently, there is no way to deploy the Kotlin website locally. We'll add this support later.". Is there any ETA for enabling easy local development? Thanks!

[Piotr Krzemiński]

CC @Alina Dolgikh [JB] - I want to add the map with user groups I promised some time ago 🙂

[Alina Dolgikh [JB]]

Hi Piotr! I cannot share any ETA with you, but let me ping the web team and see what they would recommend

[Piotr Krzemiński]

thanks Alina! it would be also nice to have some tracking ticket in YouTrack/GitHub, and there we can also document some short-term workarounds to test it locally.

[Nikolay Pachkov]

Hi Piotr!
Thanks for you effort 🙂
You can try running the site locally:
• You need to install Docker and yarn
• Check out the project from GitHub
• Copy sample file .env.sample and rename it to .env
• run "docker-compose up" 
• run "yarn install && yarn start"
It will run webpack-dev-server on localhost:9000.

The "Docs" page won't work,
we are working to remove these restrictions - you can track https://youtrack.jetbrains.com/issue/KT-47049

[Piotr Krzemiński]

thanks a lot Nikolay, will try it one evening 🙂

[Piotr Krzemiński]

a quick PR: README: refer to ticket regarding adding support for local testing by krzema12 · Pull Request #2312 · JetBrains/kotlin-web-site

[Piotr Krzemiński]

your instructions work, thanks! I'm unblocked with my work

[Piotr Krzemiński]

FTR, I created a ticket for what I want to contribute and will keep track of my work there - feel free to assign it to me, set subsystem or whatever is needed: Add a map of user groups on kotlinlang.org : KT-47068

[Piotr Krzemiński]

friendly ping about the PR - I'd be grateful for at least some initial feedback 🙂

[Nikolay Pachkov]

Hi, Piotr! i'm going to review the PR today🙂

[Piotr Krzemiński]

thanks, comments applied ✅

[Nikolay Pachkov]

Thank you, i will take a look at PR today

[Piotr Krzemiński]

thanks Nikolay for approval! as I cannot merge the PR myself, are we waiting for the second reviewer (@c0nst)?

[Piotr Krzemiński]

hi folks! if you have a spare moment, please take a look at a pretty simple PR KT-47068: Add schema for data/user-groups.yml by krzema12 · Pull Request #2337 · JetBrains/kotlin-web-site - I'd like to have this before I add latitudes and longitudes for the groups (separate PR)

[Piotr Krzemiński]

friendly ping 🙂 this PR should be fairly simple, backfiling user group locations will be more hard-core 😉

[Nikolay Pachkov]

Hi! 🙂
Yes, the change is fairly simple, but it made us think about how exactly we want to validate yaml and similar data files 😅. It seems that GitHub action would be perfect for this purpose. I will give a detailed answer in the PR a little later (today).

[Piotr Krzemiński]

Yeah, I thought the same, but I also thought about adding the GitHub action in a separate PR. Up to you, I'm waiting for your further guidance :)

[Piotr Krzemiński]

(unless we don't want to use YML schema)

[Piotr Krzemiński]

FTR, I added the GitHub action

[Piotr Krzemiński]

next PR: KT-47068: Allow specifying positions for user groups by krzema12 · Pull Request #2371 · JetBrains/kotlin-web-site on Friday I'm leaving for ~2 weeks for vacation, so I won't bother you for at least that period of time 🤣

[Nikolay Pachkov]

Thanks, I've merged it. Have a nice vacation!🙂

[Piotr Krzemiński]

hi, I'm back with such change 🙂 KT-47068: Backfill user groups positions and make position mandatory by krzema12 · Pull Request #2417 · JetBrains/kotlin-web-site. After that, the only thing missing will be finally adding the actual map 🎉

[Piotr Krzemiński]

sneak peek of a helper map I used for the backfill:

[Piotr Krzemiński]

friendly ping about the latest PR (to avoid merge conflicts) 🙂

[Piotr Krzemiński]

🎉 KT-47068: Display a map of user groups by krzema12 · Pull Request #2426 · JetBrains/kotlin-web-site 🎉

[Piotr Krzemiński]

the map is live! 🎉 https://kotlinlang.org/user-groups/user-group-list.html thanks everyone for support, glad to see it working after 2 months of step-by-step work 🙂

[Piotr Krzemiński]

https://youtrack.jetbrains.com/issue/KT-47068 can be resolved 🙂

[Nikolay Pachkov]

🎉 @Piotr Krzemiński thank you very much for the work that you have done! 🎉