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. We have updated the language to the Editor Terms based on feedback from our employees and community. Learn more.
    Dismiss Notice
  3. Join us on November 16th, 2023, between 1 pm and 9 pm CET for Ask the Experts Online on Discord and on Unity Discussions.
    Dismiss Notice

Too many minor suggestions/edits/typos on here. Embedded feedback in online docs?

Discussion in 'Documentation' started by feiting, Jan 7, 2016.

  1. feiting

    feiting

    Joined:
    Oct 26, 2012
    Posts:
    33
    Apple and MS have this, can your document generator test to see if it's "online" and embed a feedback box, so you can directly get input and have the page automatically fed?

    I see half the posts here are "missing an e" or something. A forum is too heavyweight for that type of thing.

    I personally notice a ton of typos, but never report them unless I can't get the meaning. Apple has a ton of homonyms in their documentation, although reported 7 years ago, they haven't fixed any afaik... but still, embedded feedback tool, very handy, quick, and this forum will be less cluttered with trivial things so we can focus on things like... I suppose missing topics? Desires for fresh perspectives? A separate documentation section for newbies vs seasoned? (The way neural networks form in the brain is different when you have starting ground vs nada). The design/appearance of the docs? How to edit them -> Where the community additions are...
    Printable versions, how you should go through the manual if you're new, where you should start if you're making a 2D game... blah blah blah. Just brainstorming.

    I would find all of those valuable. You could probably erase half the posts here, and another 30% by categorizing the above, as many of the questions will fall under "Didn't you get the basics of 2d? Follow the sticky with the path to completing a block-breaker" or something.

    SJ
     
  2. duck

    duck

    Unity Technologies

    Joined:
    Oct 21, 2008
    Posts:
    358
    We did actually try out a feedback field in the docs for a while, but the sheer volume of duplicate comments, spam and nonsense meant that it wasn't viable to process the incoming comments at the time. We are however looking at various ways of bringing back some kind of more sensible feedback system so that what we collect is managable!

    That said, thanks for the comments, it's always good to hear ideas about how the docs could be improved, either specific fixes or broad brainstorming. I'll make sure this gets discussed at the next docs team meeting.
     
    feiting likes this.
  3. feiting

    feiting

    Joined:
    Oct 26, 2012
    Posts:
    33
    I know the spam wars have been solved and then re-attacked new ways for about as long as they exist, if your system is proprietary then good luck, otherwise the "latest" hip thing from your CMS's add-ons maybe with some customizing.

    I searched the forum first to see if this idea was done before, looks like it was more your-side than community. Thanks duck.