When Delphi documentation hurts: REST.Response.Adapter.TRESTResponseDataSetAdapter – RAD Studio API Documentation
Posted by jpluimers on 2015/04/01
A lot of the stuff on the Embarcadero docwiki hurts. For instance most of the REST stuff (I’m not calling it documentation) is just generated scaffolding. Like REST.Json.TJson.
But the TRESTResponseDataSetAdapter has some amazing documenation. About TComponent that is:
TComponent is the common ancestor of all component classes.
TComponent is the base class for all components. Components are persistent objects that have the following capabilities:
IDE integration. The ability to appear on an IDE palette and be manipulated in a Form Designer.
Ownership. The ability to manage other components. If component A owns component B, then A is responsible for destroying B when A is destroyed.
Streaming and filing. Enhancements of the persistence features inherited from TPersistent.
…
To assist the doc team: this is a query for all pages containing “TComponent is the common ancestor of all component classes.”. Feel free to [WayBack] QC or QP it.
–jeroen
via: REST.Response.Adapter.TRESTResponseDataSetAdapter – RAD Studio API Documentation.
The Wiert Corner - irregular stream of stuff 
garymueller2014 said
I agree with the call to help with the documentation. I understand the furious pace needed to try and keep up with the latest trends which causes a lack of resources to handle the parallel development of documentation. It would help if we could at least get the unit tests. I appreciate the skill sprints and other similar forms of help but the first place I always go to first is the documentation. JVCL/JCL suffers with the same issue. I am guilty of starting to fill in notes once I get something figured out but end up getting sidetracked before finalizing it.
Eric Fleming Bonilha said
Have you actually seen that they clearly state that the documentation is from TComponent??
“REST.Response.Adapter.TRESTResponseDataSetAdapter inherits from System.Classes.TComponent. All content below this line refers to System.Classes.TComponent.”
Maybe they have no documentation for the class you are looking for and show the documentation from its ancestor instead…