Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refer to reusable blocks as 'Shared Blocks' #5322

Merged
merged 1 commit into from
Mar 6, 2018

Conversation

noisysocks
Copy link
Member

@noisysocks noisysocks commented Mar 1, 2018

Closes #3810.

Makes the UI surrounding reusable blocks more consistent by referring to them as Shared Blocks. See #3810 and below for discussion on the name.

Internally and within the codebase we will still refer to them as reusable blocks—that name has stuck, I think.

For a regular block For a reusable block
screen shot 2018-03-01 at 15 37 15 screen shot 2018-03-01 at 15 39 02

@noisysocks noisysocks added [Type] Enhancement A suggestion for improvement. [Feature] Synced Patterns Related to synced patterns (formerly reusable blocks) labels Mar 1, 2018
@noisysocks noisysocks requested a review from jasmussen March 1, 2018 04:50
@noisysocks noisysocks force-pushed the update/reusable-block-copy branch from 56654c2 to a8d7e2a Compare March 1, 2018 05:24
@jasmussen
Copy link
Contributor

Change seems good!

It's unclear if there was any consensus on the name from #3810. I think Saved is fine, but CC @karmatosed and @melchoyce for input.

@melchoyce
Copy link
Contributor

I keep calling them "shared blocks" by accident ¯_(ツ)_/¯

@karmatosed
Copy link
Member

Saved works for me, although yes I have noticed myself saying 'shared'.. which is interesting.

@brandonpayton
Copy link
Member

I think "Shared" is clearer. All block content is technically "Saved".

@jasmussen
Copy link
Contributor

The blocks aren't shared between blogs in a multi site install, though, and I believe for security reasons they aren't even shared between authors on the same site. This is a confusion I had to explain on Twitter recently.

@brandonpayton
Copy link
Member

@jasmussen I hadn't considered that. What do we think about the possibility of sharing between authors and even across sites in the future?

@jasmussen
Copy link
Contributor

To my understanding that's not in the cards, as these are user created and it would be easy for a user to accidentally share private information. But cc @mtias and @pento as I'm sure they have more context.

@leahkoerper
Copy link
Contributor

Until I read this I didn't actually realize that the Reusable/Saved blocks were in fact sharing information, e.g. an update on one would update the other instances. I had previously thought that the Reusable blocks were more like shortcuts you could drop into a post and tweak as needed, but that they were more or less individual entities once inserted into a post. Perhaps that's my bad for not paying attention but... I'd consider it a vote in favor of changing the name to Shared Blocks :)

@noisysocks noisysocks force-pushed the update/reusable-block-copy branch from a8d7e2a to ca2e243 Compare March 6, 2018 02:34
@noisysocks
Copy link
Member Author

It sounds like Shared is gelling more with everyone. I've updated the PR 🙂

@noisysocks noisysocks changed the title Refer to reusable blocks as 'Saved Blocks' Refer to reusable blocks as 'Shared Blocks' Mar 6, 2018
@westonruter
Copy link
Member

I also prefer “Shared Blocks” instead of “Saved Blocks”.

@jasmussen
Copy link
Contributor

jasmussen commented Mar 6, 2018

I disagree with the name "Shared" because they are only shared between posts by the same author, and "Shared" can imply that they can be shared across authors, perhaps even across sites.

However, this shed has been painted :) — and although I disagree, the time to test these things is now, and since it's a text change, there's no reason to hold things up. We can always revisit.

Feel free to go ahead and merge, and thank you for your work!

@pento
Copy link
Member

pento commented Mar 6, 2018

I disagree with the name "Shared" because they are only shared between posts by the same author, and "Shared" can imply that they can be shared across authors, perhaps even across sites.

Sorry I didn't clarify this earlier. They are shared between all users with Contributor role and above, regardless of who the block author is.

See #4725 for related capabilities discussions.

@jasmussen
Copy link
Contributor

Sorry I didn't clarify this earlier. They are shared between all users with Contributor role and above, regardless of who the block author is.

Well in that case, I rescind my disagreement, but maintain my 👍 👍 for merge :D

@noisysocks noisysocks merged commit d23c6d9 into master Mar 6, 2018
@noisysocks noisysocks deleted the update/reusable-block-copy branch March 6, 2018 10:08
@@ -19,7 +19,7 @@ describe( 'ReusableBlockSettings', () => {
);

const text = wrapper.find( 'IconButton' ).children().text();
expect( text ).toEqual( 'Convert to Reusable Block' );
expect( text ).toEqual( 'Convert to Shared Block' );
Copy link
Member

Choose a reason for hiding this comment

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

What about file names? Should we update them, too?

Copy link
Member Author

Choose a reason for hiding this comment

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

Internally we're still referring to these things as reusable blocks. My feeling is that the name has traction within the team, e.g. in GitHub we have a Reusable Blocks label. Happy to go on a renaming spree if we think it's worth doing, though.

Copy link
Member

Choose a reason for hiding this comment

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

Yeah, we should rename everything, as well. We won't be able to do it after merge, so better to do it before.

Copy link
Member

Choose a reason for hiding this comment

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

Yes, let's rename.

@carlhancock
Copy link

carlhancock commented Mar 6, 2018

@pento @jasmussen With roles/capabilities coming into play on who can create/read/update/delete a block it means the issue that it's not obvious a block is a reusable/shared block unless you actually attempt to edit it becomes even more of an annoyance. Because now it's not obvious what is and isn't a reusable/shared block to be able to know what I can and cannot edit based on my user role.

It now means not only is it not obvious a block is reusable/shared without attempting to edit it, it also means there isn't a visual cue or UI element that makes it obvious that a block can or cannot be edited based on my role/capability. There should be a UI element such as an icon that makes it obvious that it is a reusable block AND another UI element such as a lock icon that makes it obvious that it is locked from allowing me to edit it.

See #5225.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Feature] Synced Patterns Related to synced patterns (formerly reusable blocks) [Type] Enhancement A suggestion for improvement.
Projects
None yet
Development

Successfully merging this pull request may close these issues.