Opened 13 months ago

Last modified 13 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

Description

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 13 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 13 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