There is an official survey by unity docs team regarding docs. If you have ever found yourself cursing docs, this is the time to give some feedback and change them for the better!
Thanks everyone! And please be constructive, rather than just bashing!
ohnoâŚhopefully this is not some plan to re-design documentation site into some new-angular-mobile-first formatâŚ
(and then leave it broken for years with worse UX cough-assetstore-cough-connect-cough-lithium-coughâŚ, compared to current at-least-its-working-state)
Mobile compatibility was pretty much my second lowest choice, with my lowest being âdocuments translated into my own languageâ since theyâre already in english.
My big thing is that I want fewer parts of the scripting reference to be more than FartBargle.bargleFarts being described as âbargles farts built with the FartBargle constructorâ or whatever with no explanation as to how it does what it does or how to use the bargleFarts function.
Who on earth uses the documents on a mobile device?
For the most part you are sitting down at a laptop/desktop when using Unity. Which means that Unity documentation should be first and foremost optimized for the desktop.
Until Unity releases a viable editor for mobile, there is no need for mobile documentation.
^ In fairness making something mobile âresponsiveâ for documentation shouldnât be that much of a big deal anyway. It is just displayed running down in a column as opposed to two juxtaposed panels, with a hamburger slide out panel â looks to be how it is designed anyhoo.
This doesnât account for the fact that most of the code samples would be broken up really awkwardly across multiple lines, making it really difficult to parse. Screen size is a factor.
Doesnât quite work that way for c# though as it is pretty verbose. Have you tried to open a sample project on a mobile device and eye up where the brackets open and close if it just overflows and it doesnât really overflow it just adds horizontal scrolling on the forums?
Overflow is the problem I am literally describing. You can either make the user have to scroll side to side, have it break at the screen edge, or you can have tiny text. None of these make for an ideal experience compared to fitting the text to an 8" or wider display.
I filled out the survey, but the order of importance list puzzled me. Most of the items on the list were basically a tie for least important, and thereâs a bunch of stuff I would have added to the list of much higher importance.
All are correct. But considering mobile device, I think best option is overflow, when can scroll text area separately, without scrolling whole page. Better than having it all wrapped into size of screen.
Generally I donât bother to type any code, while I am on mobile. It would be nightmare exercise
But seems Unity thinks all should be mobile now (including editor?)
In any other part of the software industry âdeveloperâ is a specific enough term to be useful. In games a âdeveloperâ could mean lots of different thingsâŚ
The unity staff member that sent me this survey has deleted the comment on reddit, so I am not even sure if we are meant to still be using this survey, but its still live so while it is make the most of it!