Everyone please fill out this survey from unity regarding the docs!

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! :smile:

6 Likes

I wonder how many people will point towards MSDN with #12.

3 Likes

I remember starting filling this survey but I ended up always checking “sometimes” so I quit.

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)

1 Like

The learning section is already designed for mobile and tablets, all the rest will follow, forums, doc etc.

yeah, that is the nightmare i’m most afraid of :slight_smile:

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.

4 Likes

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.

3 Likes

^ 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.

^But there’s no way around that for mobile, except maybe making the API less verbose :smile:

Have you seen learn section? Looks like mobile … :slight_smile:

Does not have to, if the web page is designed correctly.
Simple as text area for code, with overflow.
This forum code tag works well on mobile.

I use google and YT when unity does not have the exact example or specific edge case I’m interested in which happens about 50% 90% of the time.

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.

Murg what you need is one of these, then you’re only limited by the size of your wrist and the coloration of your skin tone.

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 :slight_smile:

But seems Unity thinks all should be mobile now (including editor?) :stuck_out_tongue:

Question 1 is already a red flag to me.

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…

1 Like

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!