Is there a specific project or label we should file docs bugs with? I used the link from the post in #general but wanted to make sure it was triaged correctly: https://youtrack.jetbrains.com/issue/KT-43807

love the new docs! looking 🔥 one small thing, I was just confused why the operator overloading concept is under the DSL drop down?

Tiny feedback: I kinda liked search in old doc: it provided more context (not just tiny area with results) and some classification for the returned result (e.g. tutorial or reference). Also "What's new" is always on top, but I'm expecting fundamental references to be more related for my search in language reference most of the time

If you open any documentation page you would typically see one-line definition of the methods and their usage. If you click one of the methods you would see the detailed documentation including exceptions and additional info. In the main page where all the methods are listed there is no indication that there may be additional information one can look up. Plus for each method I also have to do additional navigation into and out of the details page. This doesn't seem to be productive unless I am missing something.

Hi! I don't remember how it worked in the previous version, but in the new one code snippets don't have enough horizontal space. I disable

max-width

properties on

.layout--container-content-centered

and

.code-block

to read code without scrolling horizontally. Otherwise - docs look much better now! ❤️

The revamped docs destroyed web search engines rankings, and that's worrisome for people that don't know Kotlin by heart. Please, dear Kotlin team, when doing risky things like updating the website and affecting its semantics, keep in mind that about every single day, thousands of people discover Kotlin or learn something about it for the first time, and they will often use search engines.

i have posted something related to this in #javascript already but i wanted to post here as well as it seemed to be a better place. in the kotlin docs at https://kotlinlang.org/docs/using-packages-from-npm.html, there is a specific portion where it says: "Please note that if you're using CommonJS as a target, the 

@JsModule

 and 

@JsNonModule

 annotations need to be adjusted accordingly." but never gives an example on how to adjust them accordingly. this was very frustrating for my friend who was working with CommonJS as it was very hard to import a npm dependency. Im not familiar enough with the Kotlin / JS target to say what needs to be adjusted and cannot find it anywhere else in the documentation. I was hoping a little more could be added to this part of the documentation for more clarity. for the most part the docs are fantastic but for more multiplatform related topics, they are somewhat vague

Posted in general by mistake.

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!

KUG map doesn't work 🤔 https://kotlinlang.org/user-groups/user-group-list.html FYI @Nikolay Pachkov @Alina Dolgikh [JB]

hi, not sure if the right channel, but this issue seems to be still present and is affecting me now: Share code Embed iframe not working · Issue #103 · JetBrains/kotlin-playground> - any chance for some traction here?

hi folks! I just noticed something about the KUG map: with this change, we don't require position for KUGs because the virtual user group doesn't have one. But then there's no mechanism to ensure that other physical user groups have them, see last change which added two UGs without position. My idea for improvement: restore

position

being mandatory, but add a condition for the virtual KUG that it's not placed on the map. VKUG could have some dummy position, like (0.0, 0.0). WDYT?

the java toolchain doc have a wrong kotlin snippet, this should be

kotlin {
    jvmToolchain {
        (this as JavaToolchainSpec).languageVersion.set(JavaLanguageVersion.of(<MAJOR_JDK_VERSION>)) // "8"
    }
}

is there a way to insert an horizontal Rule/Line?

if I have that last line ("See Also"), then the description of the last param will be inserted in a new line

* @param variant is the variant number.
* @param major is the major version number.
* @param minor is the minor version number.
* @param patch is the patch version number.
* 
* ### See Also

Does Kdoc support table rendering?

I want to improve the compiler docs, but I have only 24 hours of experience with the source.

Hi! As the revamping process is over, I’m archiving this channel. Thank you everyone for your help with this improvement!