4 ms·

This sort of thing really bugs me when I work with Unity and Unreal. Sometime the documentation for something is just so useless. A lot of the time when trying

This sort of thing really bugs me when I work with Unity and Unreal. Sometime the documentation for something is just so useless. A lot of the time when trying to understand Unreal nodes, the documentation page is just a picture of the node and the name of the node restated in slightly longer words, as if that helps anything. And so many times when I'm using Unity at £JOB, I just want to know how to use a function properly, and a short example would help so much. It's generally good but some pages just have nothing of value on them. If I could submit my own additions to the Unity docs pages, I would probably end up doing that

squigz 1y ago
> £JOB Wait a second, do people use $ for `$job` because it's how they earn money and not, as I've always thought, used it as a variable name? Stop throwing my entire world view out of order please.
- voidUpdate 1y ago
  I actually don't know, I just assume the majority of people are americans and that's why they use $. I don't use $ in programming except for string interpolation, so it's never really registered as a variable sigil to me
  - squigz 1y ago
    Oh no my PHPness is showing! Also, many, many countries use $, like Canada.
    - tom_ 1y ago
      If you think it would reflect on you better, think of it as indicating regular POSIX shell use?! (I'm 99% sure it's intended to be reminiscent of that sort of syntax. Example use: https://news.ycombinator.com/item?id=42761939 https://news.ycombinator.com/item?id=42761939)
  - zahlman 1y ago
    > I don't use $ in programming except for string interpolation ... but the entire point of the "$JOB" etc. slang is that it's a string interpolation...
    - voidUpdate 1y ago
      Not how I use it, string interpolation would be $"{job}"
      - yjftsjthsd-h 1y ago
        That depends on the language. In unix shell, echo $JOB and echo ${JOB} are identical, though the latter is more flexible (Allowing eg. `echo ${JOB:-unemployment}` or `echo ${JOB}SUCKS`).
  - SAI_Peregrinus 1y ago
    Every time I use $word in a comment is to be reminiscent of POSIX-style string interpolation for some word. The vast majority of cases where I've seen it are such, only if "word" is numeric do I expect $ is used as a currency symbol.
- marcosdumay 1y ago
  The $ is for variables. And the upper case make it a BASIC variable, instead of something like Perl or PHP. Some times people put it in angle brackets <JOB>. I have no idea what system use variables like that.
  - 1718627440 1y ago
    Templates use this syntax in some languages.
teamonkey 1y ago
Unreal's lack of documentation is hugely frustrating and a massive time sink for me. They very much subscribe to a 'code is documentation' approach (I don't agree), but the 'screenshot of a node' documentation for blueprint is truly beyond parody.
- voidUpdate 1y ago
  I also had some issues recently where I was trying to build something in the latest Unreal version, and the docs for the thing I was trying to do said they were for that version, but obviously had screenshots from the last major version, which had a completely different interface style and menu items in different places, and as such was almost completely useless. Someone forgot to check it before bumping the version number on the docs

squigz 1y ago

> £JOB Wait a second, do people use $ for `$job` because it's how they earn money and not, as I've always thought, used it as a variable name? Stop throwing my entire world view out of order please.

voidUpdate 1y ago
I actually don't know, I just assume the majority of people are americans and that's why they use $. I don't use $ in programming except for string interpolation, so it's never really registered as a variable sigil to me
- squigz 1y ago
  Oh no my PHPness is showing! Also, many, many countries use $, like Canada.
  - tom_ 1y ago
    If you think it would reflect on you better, think of it as indicating regular POSIX shell use?! (I'm 99% sure it's intended to be reminiscent of that sort of syntax. Example use: https://news.ycombinator.com/item?id=42761939 https://news.ycombinator.com/item?id=42761939)
- zahlman 1y ago
  > I don't use $ in programming except for string interpolation ... but the entire point of the "$JOB" etc. slang is that it's a string interpolation...
  - voidUpdate 1y ago
    Not how I use it, string interpolation would be $"{job}"
    - yjftsjthsd-h 1y ago
      That depends on the language. In unix shell, echo $JOB and echo ${JOB} are identical, though the latter is more flexible (Allowing eg. `echo ${JOB:-unemployment}` or `echo ${JOB}SUCKS`).
- SAI_Peregrinus 1y ago
  Every time I use $word in a comment is to be reminiscent of POSIX-style string interpolation for some word. The vast majority of cases where I've seen it are such, only if "word" is numeric do I expect $ is used as a currency symbol.
marcosdumay 1y ago
The $ is for variables. And the upper case make it a BASIC variable, instead of something like Perl or PHP. Some times people put it in angle brackets <JOB>. I have no idea what system use variables like that.
- 1718627440 1y ago
  Templates use this syntax in some languages.

teamonkey 1y ago

Unreal's lack of documentation is hugely frustrating and a massive time sink for me. They very much subscribe to a 'code is documentation' approach (I don't agree), but the 'screenshot of a node' documentation for blueprint is truly beyond parody.

voidUpdate 1y ago
I also had some issues recently where I was trying to build something in the latest Unreal version, and the docs for the thing I was trying to do said they were for that version, but obviously had screenshots from the last major version, which had a completely different interface style and menu items in different places, and as such was almost completely useless. Someone forgot to check it before bumping the version number on the docs