ionic-team / ionic-site

Repo for the ionicframework.com site

Home Page:https://ionicframework.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Documentation for lists inside of cards is contradictory/unclear

brandyscarney opened this issue · comments

From @orasestravis on February 22, 2018 16:26

Ionic version: (check one with "x")
(For Ionic 1.x issues, please use https://github.com/ionic-team/ionic-v1)
[ ] 2.x
[x] 3.x
[ ] 4.x

I'm submitting a ... (check one with "x")
[x] bug report
[ ] feature request

Current behavior:

This is a bug in the documentation.

See "Lists In Cards": https://ionicframework.com/docs/components/#card-list

The docs say "Add an ion-list component inside of the ion-card-content to display a list".

However, the sample markup immediately below this sentence does not include an ion-card-content element – the ion-list is nested directly inside of the ion-card.

Should the ion-list be wrapped inside of an ion-card-content, or shouldn't it?

Experimentation suggests that a ion-card-content should not be used, but I'm not certain what's intended.

Expected behavior:

I expect the documentation to be self-consistent.

Copied from original issue: ionic-team/ionic-framework#14064

Thanks for moving this to the right place, @brandyscarney.

I'm going to close this since it's unlikely we'll have it updated as we work to update the docs to use v4. I've already made sure this is more clear in the latest documentation. If you feel strongly about this being updated in the v3 version please create a PR, thank you!