Replace Complex components documentation with a better strategy
The Complex components section in the component lifecycle docs describes an approach for building and styling GitLab UI components that are widely used in GitLab. This approach has created significant technical-debt so far so we have to revisit it.
The following discussion from !1133 (merged) should be addressed:
-
@sarahghp started a discussion: (+1 comment) I thought we were not continuing this process. The way this is written reads as though it is the approved way forward. It is also unclear whether developers should use the
NewX
components, even though in other discussionsMy preference would be to not enshrine this method but instead, with complex items, develop them in a separate branch or throw on
created
until they are ready to be used.Obviously all of that is not going to happen within the confines of this MR, but I would like to see us give the recommended path forward. (And maybe I'll add this discussion to our meeting agenda.)