#7187 and #7184 graduated Buttons and TextFields theming extensions to ready, but didn't update the docs. Similarly, #7190, which has not yet been merged in, is not updating the docs to reflect the graduation of the Dialogs theming extension to ready.
This PR updates docs for Dialogs and TextFields theming extensions to reflect them being marked ready. Once #7190 is merged in the Dialogs changes here will be accurate.
I will address the out-of-date Buttons docs once #7206 is merged in.
Context is in the associated issue.
This affects the perl expression that prepends `docs/` to local urls. Specifically, it makes the perl expression only modify urls that link to a sibling markdown file composed of `\w` characters (e.g. `theming.md`). This is not perfect, but it addresses our needs for now. If/when we encounter other types of local urls that we can address them separately.
For now, this change fixes the incorrect behavior described in the associated bug.
Closes https://github.com/material-components/material-components-ios/issues/7203
Fixes the following error in the website job:
```
Error:
Broken link docs/../../contributing/beta_components.md in /Volumes/BuildData/tmpfs/src/github/repo/docsite-generator/.stage/ios/catalog/dialogs/index.md
```
The readme was regenerated by running `./scripts/generate_readme Dialogs`
## Related links
* Related bug: #5772
* Blocking PR: #6460
## Introduction
The team has decided to pivot to theming extensions instead of _Themer_ objects. As we pivot we need to document how these new extensions work, for clients to use them. This adds documentation for dialogs with the new theming extensions.
_Note_ This is blocked by #6460 until that is resolved and merged then some of these links will not work.
## The problem
We don't have documentation on theming extensions for dialogs.
## The fix
Add theming extension documentation for clients to see how we intend for them to use our new theming extensions within the button component.
## Remaining work
- [x] Add documentation for container scheme
- [ ] README updates for Buttons using Material Theming Extensions
- [ ] README updates for Dialogs using Material Theming Extensions
{MDC iOS} No longer using `-init` for Color Scheme.
Based on the discussions in go/mdc-ios-theming, we should not use the `-init` default initializer. Instead, we should use an explicit set of defaults.
Search regex: '\[\[MDCSemanticColorScheme alloc\] init\]'
Context
We recently added an API for a DialogThemer but we are yet to update the README.
The problem
We are missing docs for the new API
The fix
Update the readme to have the new themer API
Related issues
b/116306933
As part of our readme generator, components can now opt in to displaying badges in their readme.
The badges are generated from https://shields.io/ and are focused on an individual component. We're currently generating the following badges:
- Open bug count.
This discourages depending on all of a component's extensions and aligns our targets more closely with how we expect them to be imported and depended upon.
This is a breaking change.
Pivotal story: https://www.pivotaltracker.com/story/show/157118721
* Updated known shortlink destination URLs to use short links.
* Updated stray links in the CHANGELOG.md.
* Fixed FAB shortlink.
* Applied replacements to everything outside of components/.
* [Docs] Marks component files as API documentation roots.
Used by the site generator to determine where to build API docs. I
marked everything built by the previous version.
* [Docs] Adds a prefix to all Material guidelines links.
* [Docs] Adds API doc links to some components.
* [Docs] Changes an icon list class name.
* [Docs] Adds annotations to all installation code snippets.
* [Docs] Fixes screenshot sizes in PageControl README.
* [Docs] Fixes a broken link on the homepage.
* [Docs] Adds a stable repository branch field to the site metadata.
Used to link to the GitHub source tree.
* [Docs] Specify platform in docs root title.
* [Docs] Adds platform configuration for the doc site.
* [Docs] Adds path metadata for documentation site.
This field is used to determine where the file will appear in the
doc site.
* [Docs] Updates Material guideline links to latest URL.
material.google.com -> material.io/guidelines
* [Docs] Introduces a separate component index for the docsite.
* [Docs] Changes the directory used for site generation.
* [Docs] Moves documentation-site-only Markdown into its own directory.
* [Docs] Changes material.io links to use https.
* [Docs] Renames the howto and contributing docsite sections to docs.
* [Docs] Adds a navTitle field to the collection editing/styling pages.
* [Docs] Changes the FAQ heading to be one size bigger.
* [Docs] Changes the tutorial title.
* [Docs] Adds icons to three more components.
* [Docs] Introduces a root component directory called /catalog/.
* [Docs] Adds an icon to the AnimationTiming component.
* [Docs] Adds an icon for the typography component.
* [Docs] Reformats the docsite index.
There are more changes to come, but it's time we merged back.
Changes:
* Re-introduces the doc site scripts and files that had been deleted previously.
* Updates contributing docs to reflect doc structure changes.
* Applies common header structure across all component documentation.
* Fixes a bunch of liquid syntax bugs.
* Inlines Front Matter metadata in README.md files as HTML comments. Any file prefixed with
<!--docs:
...yaml
-->
Will be converted into Front Matter when generating the site.
* .jekyll_prefix files, which previously stored the data, have been removed.
* [ActivityIndicator] Snippets in Swift 3
* [AnimationTiming] Snippets in Swift 3.
* [AppBar] Snippets in Swift 3 and corrections to snippets.
* [ButtonBar] Snippets in Swift 3 and corrections to snippets.
* [ButtonBar] Removing TODO.
* [Buttons] Snippets in Swift 3.
* [Collections] Snippets in Swift 3 and snippet corrections.
* [CollectionLayoutAttributes] Snippets in Swift 3.
* [Dialogs] Snippets in Swift 3 and snippets corrections.
* [FeatureHighlight] Snippets in Swift 3 and snippets corrections.
* [FeatureHighlight] Missing import specification.
* [FlexibleHeader] Snippets in Swift 3 and snippet corrections.
* [Dialogs] Corrections to snippets.
* [HeaderStackView] Adding import specifier.
* [Ink] Snippets in Swift 3 and snippets corrections.
* [NavigationBar] Snippets in Swift 3.
* [NavigationBar] Removing TODO.
* [OverlayWindow] Snippets in Swift 3 and snippets corrections.
* [PageControl] Snippets in Swift 3 and snippet corrections.
* [OverlayWindow] Snippets in Swift 3 and snippet corrections.
* [Palettes] Snippets in Swift 3 and snippet corrections..
* [ProgressView] Snippets in Swift 3 and snippet corrections.
* [Readmes] Snippet alignment corrections.
* [ActivityIndicator] Swift first in README
* [AnimationTiming] Swift first in readme.
* [AppBar] Swift first in readme.
* [ButtonBar] Swift first in readme.
* [Buttons] Swift first in readme.
* [CollectionLayoutAttributes] Swift first in readme
* [Collections] Swift first in readme.
* [Dialogs] Swift first in readme.
* [FeatureHighlight] Swift first in readme.
* [FlexibleHeader] Swift first in readme.
* [FontDiskLoader] Swift first in readme.
* [HeaderStackView] Swift first in readme.
* [Ink] Swift first in readme.
* [NavigationBar] Swift first in readme.
* [OverlayWindow] Adding missing site comments. Swift first in readme.
* [PageControl] Swift first in readme.
* [Palettes] Swift first in readme.
* [ProgressView] Swift first in readme.
* [RobotoFontLoader] Swift first in readme.
* [ShadowElevations] Swift first in readme.
* [ShadowLayer] Swift first in readme.
* [Slider] Swift first in readme.
* [Snackbar] Swift first in readme.
* [SpritedAnimationView] Swift first in readme.
* [Switch] Swift first in readme.
* [Typography] Swift first in readme.
* [ShadowLayer] Reducing font size in readme.
* [Switch] Reducing font size in readme.
Summary: Created separate README.md and README.yaml files to remove the odd display of the md in GitHub.
Reviewers: O1 Material components iOS, ajsecord
Reviewed By: O1 Material components iOS, ajsecord
Tags: #material_components_ios
Differential Revision: http://codereview.cc/D1496
Summary: This is the initial import of the material spec'd alert controller.
Reviewers: O1 Material components iOS, ajsecord
Reviewed By: O1 Material components iOS, ajsecord
Subscribers: ajsecord
Tags: #material_components_ios
Differential Revision: http://codereview.cc/D1258
