TODO(mdc-migration) I need more than this

[charlesritchea]

Documentation Feedback

As you well know, it was all too easy to customize styles on Angular Material components prior to the MDC transition. Maybe it's just as easy now, but it's completely different. I understand why it's different, but since I'm just trying to upgrade a codebase that I didn't write. I have no idea how to do that or what any of these TODO comments mean.

   .my-user-edit-body {
    @extend .my-grid-cell-auto;
    @extend .my-grid;
    /* TODO(mdc-migration): The following rule targets internal classes of card that may no longer apply for the MDC version. */
    /* TODO(mdc-migration): The following rule targets internal classes of card that may no longer apply for the MDC version. */
    mat-card.my-user-edit-card {
      @extend .my-grid-cell-auto;
      @extend .my-grid;
      @extend .my-grid-center;
      /* TODO(mdc-migration): The following rule targets internal classes of card that may no longer apply for the MDC version. */
      mat-card-content.my-user-edit-card-content {
        @extend .my-grid;

        .my-user-information {
          @extend .my-grid-vertical;
          @extend .my-grid-cell-center;
          padding-left: 20px;

          .my-user-name {
            font-weight: bold;
          }
        }
      }
    }
  }
}

If you think that is clear then you have the curse of knowledge. That is incredibly obscure and I can't find any clear guide on what I'm supposed to do. The documentation essentially looks like the South Park Gnome Graph. Stack Overflow is full of people asking QUESTIONS about this, but no useful answers. I probably have over a thousand of these! Please offer some guidance here

Affected documentation page

https://v15.material.angular.io/guide/mdc-migration#3-check-for-todos-left-by-the-migration-tool