Find/Replace overlay: New/Noteworthy Entry

[Wittmaxi]

N&N for eclipse-platform/eclipse.platform.ui#1192

[Wittmaxi]

@HannesWell I created this PR following your comment on my PR.
I am not sure yet how I can correctly render this page and I am not quite sure how to word the N&N. If you could give me a few hints and/or review my text, i'd be very thankful :)

[HannesWell]

Thanks for providing this.

I am not sure yet how I can correctly render this page and I am not quite sure how to word the N&N. If you could give me a few hints and/or review my text, i'd be very thankful :)

Sure. :) In general you have already found the right place and after a coarse view it looks good already.

The Contributing Guide leads you to more detailed instructions and recommendations about the content and how to validate it:
https://github.com/eclipse-platform/www.eclipse.org-eclipse/blob/0ef3497d054caaed1d4e335192ce0c563088db76/CONTRIBUTING.md

You can try it out by simply opening the modified html file in your browser. It does not look exactly as deployed to the website (I think the theming is missing), but it should give you a good general impression.

Once this is submitted it will be published at https://eclipse.dev/eclipse/news/4.33/platform.php shortly later.

When you think this is ready I can have a detailed review.

[fedejeanne]

Thank you for contributing this!
I just made some corrections based on the instructions.

Could you please also:

• Rename the files to use "-" instead of "_"
• Remove the "noise" (parts from buttons and texts in the background) from the edges of the screenshots

?

[fedejeanne]

Also, I would rather have the screenshots in the "default" theme as opposed to the "dark" theme in order to be consistent across the document (see screenshots from previous feature).

[Wittmaxi]

@fedejeanne @HeikoKlare I have updated the PR according to your suggestions. I have anticipated the merge of the Find/Replace History and already documented it in this PR

[Wittmaxi]

[fedejeanne]

@fedejeanne @HeikoKlare I have updated the PR according to your suggestions.

You didn't provide an empty alt text for the images

Additionally

• The word shift needs to be properly capitalized (Shift)
• I would remove the screenshot showing the overlay at the bottom and simply mention the fact that you can have at the bottom before the previous screenshot since that one already shows the option right below "Use find/replace overlay" anyway.

I have anticipated the merge of the Find/Replace History and already documented it in this PR
👍

[HeikoKlare]

To have this N&N in soon and make people aware of the new feature, I have improved the N&N proposal according to the review and recent changes to the look and feel.
In more detail:

• Updated all screenshots with the current look and feel and proper cropping at the borders of the according shells.
• Removed the screenshot showing an overlay at the bottom of an editor. The editor was not completely shown so the screenshot looked a bit misplaced.
• Added a screenshot showing the expanded replace bar for comparison with the collapsed version.
• Added alternative descriptions for images.
• Made the shortcut references OS independent by referring to both the Windows/Linux and MacOS versions.
• Slightly improved the text.

A preview can be seen here: https://htmlpreview.github.io/?https://github.com/Wittmaxi/www.eclipse.org-eclipse/blob/MW_NN_find_replace_overlay/news/4.33/platform.html

@fedejeanne could you please have another look?

[fedejeanne]

Remove the file .png, it's not necessary.

The rest looks good.

I trust you'll remove the file before merging so it's all good on my side :-)

[HeikoKlare]

Removed the obsolete file in df372a9.