Will Quality of Documentation be better in 2024 Products?
George Carlisle
on 13 Mar 2024
Latest activity Reply by George Carlisle
on 16 Mar 2024
Mathworks has always had quality documentation but in 2023, the documentation quality fell. Will this improve in 2024?
12 Comments
Time Descending
Note: I would not be surprised if this question is transferred to a discussion. In fact, I am considering doing exactly that myself, as this is not a question that is appropriate for Answers. If so, the appropriate forum would be discussions/general.
If there is something specific that you think was lacking, then it is your responsibility to tell TMW what was missing. Don't just post some random rant about how the documentation has decreased. We cannot possibly know what it is that you think is poor. So that is all you have done, is make a random rant.
I'm sorry, but the onus is on you to tell TMW where you see something lacking. Are the authors of the docs perfect? Of course not! Everybody has an occasional blind spot.
But you can help to improve things, instead of just complain. Be positive. Be constructive. AND, contact the right people, via the proper channel. Answers is not that. One thing I have always seen are quick responses to the support questions I have sent into tech support. And given that your issues seem to be with perceived flaws in one or more docs, any appropriate fix should be almost trivial, at least if you carefully explain what was lacking. Again, Answers is not tech support.
(And, yes, I am sure you will decide to flag my response as a troll, as you did with the response from Walter.)
As I expected from you based on your responses elsewhere, I got sworn at. There was no reason for you to do that, so I removed your curse.
And, YES, if you perceive a problem, then it is your responsibility, OR live with what they give you. You can either help to improve the product, or just be a troll. As I suggested, Try being constructive. You might make the world just a tiny bit the better place if you do.
So it's my job now to tell Mathworks how to do documentation?
No, it will not improve in R2024a.
Release R2024a has not been released yet. As such we can't answer questions about it.
But I am curious about your first sentence. You said "the documentation quality feel." Feel what? Is there some specific feedback about your experience with the documentation in release R2023a or R2023b that you want to share? Is it with the documentation in general, a specific product's documentation, or a specific documentation page?
If the last of those, navigate to the documentation page online (like the documentation page for the sin function as an example), scroll to the end of the page, and give it a star rating. Once you've rated it you will be given the opportunity to provide some text feedback on the page. This information gets sent to the Documentation staff for review and consideration.
(It looks like GSG is Getting Started Guide, UG is Users Guide, IG I am not sure of, REF is probably Reference, RN I am not sure of.)
The message was edited to now say "fell". But I would still be interested in more information about what specific qualities of the documentation the poster feels decreased in quality in release R2023a and/or R2023b.
Sign in to participate
