Opened 22 months ago

Last modified 22 months ago

#21993 new Cleanup/optimization

Messages documentation is topic style, there is no ref

Reported by: mjtamlyn Owned by: nobody
Component: Documentation Version: master
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no


The messages documentation lives in ref not in topics, but it's written as a topic style document. There is no "list of the messages API".

Change History (2)

comment:1 Changed 22 months ago by timo

All of the contrib modules are documented in ref, even if the document is written topic style. I don't see much benefit in splitting things up except for the more complicated modules that are already split. Could you clarify what you mean by "list of of the messages API"?

comment:2 Changed 22 months ago by bmispelon

Regardless of whether it should be split over two pages or not, I think the messages framework documentation could benefit from having a technically-oriented exhaustive list of its API (contrib.messages.api).

As things are now, the available functions are mentionned in various places on the page (sometimes only briefly)

Note: See TracTickets for help on using tickets.
Back to Top