Skip to content

feat(docs-infra): implement figure styles#33259

Closed
sjtrimble wants to merge 7 commits into
angular:masterfrom
sjtrimble:figure-rehaul
Closed

feat(docs-infra): implement figure styles#33259
sjtrimble wants to merge 7 commits into
angular:masterfrom
sjtrimble:figure-rehaul

Conversation

@sjtrimble

Copy link
Copy Markdown
Contributor

PR#28396 originally addressed an update via issue #23983 to make images more visible with a white background (implementation of gray "lightbox").

This PR implements those styles defined in PR#28396.

PR Checklist

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • CI related changes
  • Documentation content changes
  • angular.io application / infrastructure changes
  • Other... Please describe:

What is the current behavior?

Images are often lost since the background change to white.

Issue Number: #23983 | and PR #28396

What is the new behavior?

Add a shadowed gray 'lightbox' to better define images throughout the documentation.

Does this PR introduce a breaking change?

  • Yes
  • No

PR#28396 originally addressed an update via issue angular#23983 to make images more visible with a white background (implementation of gray "lightbox").

This PR implements those styles defined in PR#28396.
@sjtrimble sjtrimble added action: review The PR is still awaiting reviews from at least one requested reviewer comp: docs-infra labels Oct 18, 2019
@sjtrimble sjtrimble requested review from a team and gkalpak October 18, 2019 23:24
@sjtrimble sjtrimble self-assigned this Oct 18, 2019
@ngbot ngbot Bot modified the milestone: needsTriage Oct 18, 2019
@mary-poppins

Copy link
Copy Markdown

You can preview 187a492 at https://pr33259-187a492.ngbuilds.io/.

@gkalpak gkalpak left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are there occurrences of figure > img, without .lightbox (or a .card)?
If so, how does one decide when to use .lightbox and .card and when not?

Comment thread aio/content/guide/forms-overview.md Outdated
Comment thread aio/content/guide/hierarchical-dependency-injection.md Outdated
Comment thread aio/content/guide/hierarchical-dependency-injection.md Outdated
Comment thread aio/content/guide/lazy-loading-ngmodules.md
Comment thread aio/content/guide/lazy-loading-ngmodules.md
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/index.md Outdated
Comment thread aio/content/start/index.md Outdated
Comment thread aio/content/start/routing.md Outdated
Comment thread aio/src/styles/2-modules/_images.scss Outdated
@sjtrimble

Copy link
Copy Markdown
Contributor Author

@gkalpak eek :/ It looks like one my fixup commits never made it on there?

I "THINK" I took care of everything.

The extra lines were there originally and sometimes my editor made it look like I wasn't supposed to indent properly so I thought maybe it would break the markdown if I did...
Screen Shot 2019-10-21 at 1 14 27 PM


I was going to update the style guide to reflect when to use the lightbox and card etc.

@mary-poppins

Copy link
Copy Markdown

You can preview 65e6295 at https://pr33259-65e6295.ngbuilds.io/.

Comment thread aio/angular.json Outdated
Comment thread aio/angular.json Outdated
Comment thread aio/content/guide/dependency-injection-in-action.md Outdated
Comment thread aio/content/guide/dependency-injection-in-action.md Outdated
Comment thread aio/content/guide/forms-overview.md Outdated
Comment thread aio/content/guide/hierarchical-dependency-injection.md Outdated
Comment thread aio/content/guide/router.md Outdated
@gkalpak

gkalpak commented Oct 22, 2019

Copy link
Copy Markdown
Member

Are there occurrences of figure > img, without .lightbox (or a .card)?
If so, how does one decide when to use .lightbox and .card and when not?

I was going to update the style guide to reflect when to use the lightbox and card etc.

Were or are? 😕 😛
I definitely agree this should be in the guide 💯

My concern is that we are complicating the conventions one has to follow, which will inevitably result in them not being consistently followed 😟
I would love if we could simplify things. For example, if .card should always be used with .lightbox, then we might be able to get rid of the nested .card and style the .lightbox (or the contained imaged) instead. Or if most fixures will use .lightbox, we could make it the default and have another class to "opt-out" of the .lightbox styling.

@sjtrimble

Copy link
Copy Markdown
Contributor Author

@gkalpak Is there anything missing for this PR?

@mary-poppins

Copy link
Copy Markdown

You can preview 81d5340 at https://pr33259-81d5340.ngbuilds.io/.

Comment thread aio/content/guide/dependency-injection-in-action.md Outdated
Comment thread aio/content/guide/dependency-injection-in-action.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
Comment thread aio/content/start/data.md Outdated
@gkalpak gkalpak added action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews target: patch This PR is targeted for the next patch release and removed action: review The PR is still awaiting reviews from at least one requested reviewer labels Oct 23, 2019
@googlebot

Copy link
Copy Markdown

All (the pull request submitter and all commit authors) CLAs are signed, but one or more commits were authored or co-authored by someone other than the pull request submitter.

We need to confirm that all authors are ok with their commits being contributed to this project. Please have them confirm that by leaving a comment that contains only @googlebot I consent. in this pull request.

Note to project maintainer: There may be cases where the author cannot leave a comment, or the comment is not properly detected as consent. In those cases, you can manually confirm consent of the commit author(s), and set the cla label to yes (if enabled on your project).

ℹ️ Googlers: Go here for more info.

@gkalpak

gkalpak commented Oct 23, 2019

Copy link
Copy Markdown
Member

@sjtrimble, I pushed a fixup commit with some indentation fixes. If you are happy with that, feel free to mark the PR for merging (remove the PR action cleanup label and add the PR action: merge and PR action: merge-assistance labels).

@gkalpak

gkalpak commented Oct 23, 2019

Copy link
Copy Markdown
Member

@googlebot I consent.

@googlebot

Copy link
Copy Markdown

CLAs look good, thanks!

ℹ️ Googlers: Go here for more info.

@gkalpak

gkalpak commented Oct 23, 2019

Copy link
Copy Markdown
Member

merge-assistance: Global approval for this docs(-infra)-only change.

@mary-poppins

Copy link
Copy Markdown

You can preview 771a723 at https://pr33259-771a723.ngbuilds.io/.

@sjtrimble sjtrimble added action: merge The PR is ready for merge by the caretaker and removed action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews labels Oct 23, 2019
@sjtrimble

Copy link
Copy Markdown
Contributor Author

Thanks @gkalpak , u da best :P

AndrewKushnir pushed a commit that referenced this pull request Oct 23, 2019
PR#28396 originally addressed an update via issue #23983 to make images more visible with a white background (implementation of gray "lightbox").

This PR implements those styles defined in PR#28396.

PR Close #33259
gkalpak pushed a commit to sjtrimble/angular that referenced this pull request Nov 13, 2019
Reference angular#33259
Removes figures elements as AIO is not typically using captions or image groups where figures would be necessary or appropriate
alxhub pushed a commit that referenced this pull request Nov 14, 2019
…33748)

Reference #33259
Removes figures elements as AIO is not typically using captions or image groups where figures would be necessary or appropriate

PR Close #33748
alxhub pushed a commit that referenced this pull request Nov 14, 2019
…33748)

Reference #33259
Removes figures elements as AIO is not typically using captions or image groups where figures would be necessary or appropriate

PR Close #33748
@angular-automatic-lock-bot

Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot Bot locked and limited conversation to collaborators Nov 23, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

action: merge The PR is ready for merge by the caretaker cla: yes target: patch This PR is targeted for the next patch release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants