Search Unity

  1. Welcome to the Unity Forums! Please take the time to read our Code of Conduct to familiarize yourself with the forum rules and how to post constructively.
  2. Join us on Thursday, June 8, for a Q&A with Unity's Content Pipeline group here on the forum, and on the Unity Discord, and discuss topics around Content Build, Import Workflows, Asset Database, and Addressables!
    Dismiss Notice

Official DOTS Best Practices Guide 1.0 is here

Discussion in 'Entity Component System' started by SteveM_Unity, Mar 14, 2023.

  1. SteveM_Unity

    SteveM_Unity

    Unity Technologies

    Joined:
    Nov 21, 2017
    Posts:
    33
    The DOTS Best Practices guide has been updated to match the latest Entities 1.0 pre-release. The old versions of the guide are still up on Learn for people who haven't updated their packages to 1.0 yet, but the version you want is listed in the dropdown at the top right of each page as "2022.1". (Entities 1.0 pre-release is only compatible with Unity 2022.2 and newer - this is just how versioning works on Unity Learn).

    Here's where to find the Guide:

    https://learn.unity.com/course/dots-best-practices?uv=2022.1

    The revised version of the guide covers a number of changes, including:
    • A new section about ISystem, and why we recommend it over SystemBase for new systems
    • Updated code samples throughout, demonstrating usage of the newer API
    • Freshly-recorded performance data comparing different methods for structural changes, with a pretty new graph and an overhaul to the advice about structural changes.
    • Lots of minor tweaks and clarifications

    I hope you find it useful. And, as always, feedback is welcome.
     
    Last edited: Mar 14, 2023
  2. Thygrrr

    Thygrrr

    Joined:
    Sep 23, 2013
    Posts:
    507
    upload_2023-3-15_19-58-2.png

    Despite having the OS Language (and browser language) set to English, this page is quite the hodgepodge of German and English.

    upload_2023-3-15_19-59-35.png

    Workaround is to force the browser to US English. Not the best.
     
    Last edited: Mar 15, 2023
  3. SteveM_Unity

    SteveM_Unity

    Unity Technologies

    Joined:
    Nov 21, 2017
    Posts:
    33
    As far as I know, there are no versions of the guide that we've produced in any language other than English. I assume that the German translations are being auto-generated by Chrome itself. All of this content should definitely render properly as English and not rely on US English. I'll pass this on to the Learn team who are responsible for this kind of thing.
     
  4. Thygrrr

    Thygrrr

    Joined:
    Sep 23, 2013
    Posts:
    507
    Blabla about locales, TLDR, no auto translate was used:
    Nope, no auto-translate at play here, I have set both German and English to "never translate" - this is a typical issue that crops up every now and then, for example commonly for people running Windows or Browsers under the en_DE "English (Germany)" locale, but the en "English" locale should always be supported, not just specific child locales such as en_UK and/or en_US.

    In my case, the browser was set to en, [already to circumvent the common en_DE probems, and as I work for a company that uses en_PK "English (Pakistan)" in many places interchangeably with en_UK, I just use the parent locale]

    Unity Learn would only display a non-mangled version if the primary language was set to en_US for me.

    Thanks for passing it on; I couldn't find a good place to give feedback on these things and your guide was quite egregiously affected. :)
     
    Last edited: Mar 16, 2023
  5. SteveM_Unity

    SteveM_Unity

    Unity Technologies

    Joined:
    Nov 21, 2017
    Posts:
    33
    I've been asked to pass this on by a Project Manager on the Learn team. Let me know if it helps.

    Here are the images they shared of where to set the preferences:

    image (17).png Screenshot 2023-03-16 at 8.37.21 AM.png
     
  6. Thygrrr

    Thygrrr

    Joined:
    Sep 23, 2013
    Posts:
    507
    Thanks! I can switch with these links. The real bug here is that the webpage automatically prefers de_DE and defaults to it even though en is the preferred Browser locale. It correctly autodetects en_US, if present and higher up in the list than de_DE.
     
  7. SteveM_Unity

    SteveM_Unity

    Unity Technologies

    Joined:
    Nov 21, 2017
    Posts:
    33
    Okay, thanks. I've passed that on. But I guess it's also an interesting data point that I tried to reproduce this by copying your language settings (on Chrome, on a MacBook), clearing site data and visiting the site in incognito mode, and it's all in English for me. So I guess something else is at play here?
     
  8. runner78

    runner78

    Joined:
    Mar 14, 2015
    Posts:
    727
    I have seen several times that many websites often use the country and not the browser language for automatic language selection, which is annoying if you belong to a linguistic minority in a country.
     
    Selmar likes this.
  9. SteveM_Unity

    SteveM_Unity

    Unity Technologies

    Joined:
    Nov 21, 2017
    Posts:
    33
    More from the Learn team:

    For the record, I tried setting my language settings in Chrome to be the same as yours and opened the site in an incognito window and it rendered in English, which is what we'd expect. If Learn is trying to set a default by asking the browser its location and making assumptions based on that, that's unexpected and they'd need to investigate more.
     
    Last edited: Mar 29, 2023
  10. Thygrrr

    Thygrrr

    Joined:
    Sep 23, 2013
    Posts:
    507
    Interesting, it should be asking the browser its preferred locale, not location.