CodeIgniter Forums
Additional "Class Reference" sections to docs please - Printable Version

+- CodeIgniter Forums (https://forum.codeigniter.com)
+-- Forum: CodeIgniter 4 (https://forum.codeigniter.com/forumdisplay.php?fid=28)
+--- Forum: CodeIgniter 4 Feature Requests (https://forum.codeigniter.com/forumdisplay.php?fid=29)
+--- Thread: Additional "Class Reference" sections to docs please (/showthread.php?tid=74340)



Additional "Class Reference" sections to docs please - dave friend - 09-12-2019

Prior to version 4 certain classes (e.g. Model) did not need a "Class Reference" because... well , there wasn't much to reference. However, the Model class in v4 is rich with functionality. While most (all?) of the available methods get discussed somewhere in the documentation nothing beats a comprehensive, single-location reference.

In addition to Model, the Entity and Validation classes would benefit from Class Reference sections.

There might be other classes too, but those three jump out at me.


RE: Additional "Class Reference" sections to docs please - kilishan - 09-12-2019

We have auto-generated API docs. I'm not sure if those currently get updated on every doc build, but I believe so. Jim's the one that handles that part.


RE: Additional "Class Reference" sections to docs please - ciadmin - 09-12-2019

I regenerate the API docs whenever there appears to be a change affecting them, and no later than with each release.

All three classes are there, for class reference:

Validation ... https://codeigniter4.github.io/api/classes/CodeIgniter.Validation.Validation.html
Model ... https://codeigniter4.github.io/api/classes/CodeIgniter.Model.html
Entity ... https://codeigniter4.github.io/api/classes/CodeIgniter.Entity.html

Part of my plan is to have cross-links between the user guide and the API docs, but that hasn't happened yet.


RE: Additional "Class Reference" sections to docs please - ciadmin - 09-12-2019

Just a note: there are still API doc errors in the codebase, and an external issue with phpDocumentor (https://github.com/codeigniter4/CodeIgniter4/issues/1988). The API docs should only get better with time, and with the cross-referencing Smile


RE: Additional "Class Reference" sections to docs please - dave friend - 09-12-2019

Thanks guys. I am aware of the API docs although at the moment I cannot find them online. (Where the heck did they go? Must be with my car keys.) But the API doc is not the same as right here at your fingertips on the same doc page you're reading.

I realize there things more pressing than this documentation request. What I ask for isn't a "gotta have it" by any stretch of the imagination. But if it could be put on to-do list for inclusion at a later date that would be fantastic.


RE: Additional "Class Reference" sections to docs please - abatrans - 11-16-2019

@ciadmin - a link on the User Guide to the API docs would be great.

Thanks to the team CI4 is great.


RE: Additional "Class Reference" sections to docs please - InsiteFX - 11-17-2019

You can find the API Documentation here.

CodeIgniter v4.0.0 API