Migration of the documentation

[oliviertassinari]

This is an issue to track the progress of this big task:

• AppBar: [docs] Autogenerate the property description for the AppBar #2382 @oliviertassinari
• AutoComplete: [Docs] Update Documentation for Auto Complete #2838 @Zadielerick
• Avatar: [Doc] Convert Avatar to use the new standard #2407 @oliviertassinari
• Badge [Doc] Migrate Badge to the new format #2489 @oliviertassinari
• Button: Update Documentation for Buttons #2745 @Zadielerick
• Card: [Docs] Updated Card Docs to new format #2590 @Zadielerick
• DatePicker updated docs for date picker to new format #2622 @Zadielerick
• Dialog: [Doc] Convert Dialog to use the new standard. #2483 @alitaheri
• DropDownMenu: [Docs] [DropDownMenu] [Composable] Migrate to new standard #2565 @alitaheri
• GridList [Docs] Updated Docs for Grid List #2681 @Zadielerick
• Icon [Docs] Icon's docs update #2695 @Zadielerick
• IconButton [Docs] Update docs for Icon Button #2700 @Zadielerick
• IconMenu: [Docs] Update Documentation for Icon Menu #2842 @Zadielerick
• LeftNav: [Doc] Convert LeftNav to use the new standard. #2507 @alitaheri
• Lists: [Docs] Update Documentation for Lists #2782 @Zadielerick
• Menu: [Docs] Update Documentation for Menus #2785 @Zadielerick
• Paper: [Docs] Update Documentation for Paper #2797 @Zadielerick
• Popover: [Docs] Update Documentation for Popover #2846 @Zadielerick
• Progress: [Docs] Update Documentation for Progress #2798 @Zadielerick
• Refresh Indicator: [Docs] Update Documentation for Refresh Indicator #2799 @Zadielerick
• SelectField: [Docs] migrate select-field to the new standard #2694 @alitaheri
• Slider: [Docs] Update Documentation for Sliders #2800 @Zadielerick
• Switch: [Docs] Update Documentation for Switches #2814 @Zadielerick
• Snackbar [Doc] Convert the Snackbar to the new format #2562 @oliviertassinari
• Table: [Docs] Update Documentation for Table #2848 @oliviertassinari and @Zadielerick
• Tabs: [Doc] Convert the Tabs page to the new format #2515 @oliviertassinari
• TextField: [Docs] Update Documentation for Text Field #2850 @oliviertassinari and @Zadielerick
• TimePicker: [Docs] Update Documentation for Time Picker #2849 @oliviertassinari and @Zadielerick
• Toolbars: [Doc] Convert Toolbars to use the new standard. #2415 @alitaheri

[alitaheri]

@oliviertassinari Please check this place before migrating any doc page, I'll keep it updated too. 👍 👍

P.S. I think we should move the examples and readme folders to pages/components, it's will populate the docs/src/app/components too much. don't you agree?

[oliviertassinari]

I think we should move the examples and readme folders to pages/components, it's will populate the docs/src/app/components too much.

Regarding the file/folder organisation. I think that the current solution in a tradeoff.
I think that we should have one folder per component, it makes each component more modular.
I don't like spreading the different files (readme, test, source code, documentation, examples) between different folders.

[alitaheri]

no no, i meant like this:

instead of:

---docs/src/app/components 
    --- Leftnav
    --- Dialog
    --- ...

We put them in the docs/src/app/components/pages/components:

---docs/src/app/components/pages/components
    --- Leftnav
    --- Dialog
    --- ...

I like it this way, I just mean put these folders in the docs/src/app/components/pages/components folder, it keeps the Folders close to the doc page that uses them.

[oliviertassinari]

I just mean put these folders in the docs/src/app/components/pages/components folder, it keeps the Folders close to the doc page that uses them.

That makes sense 👍.

[alitaheri]

@oliviertassinari All right, then. I'll try to run a clean up after the PRs are merged.

[newoga]

@alitaheri @oliviertassinari Just letting you know that I'm not ignoring this issue, but didn't went to step on your toes either. If you'd like me to assist with this effort before we tackle some of the other pull requests I previously submitted, let me know. 😄