AdobeDocs / AdobeDocs/express-add-ons-docs

Unclear "'Single-click to Add' functionality" guideline

Open
#192 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
13
Forks
56
Avg merge
3d 7h
Merged PRs (30d)
4

Description

### Is there an existing issue for this?

- [x] I have searched the existing issues

### Which topic?

https://developer.adobe.com/express/add-ons/docs/guides/build/distribute/guidelines/general/features/

### What's wrong with the content?

The phrasing is confusing:

> Any add-on where content can be added to a document should also support the option to add an image with a single click. This means that users can click on the desired location to integrate an image.

Suppose my add-on adds placeholder text, which is arguably _content_, to the document. Why should I support "the option to add **an image** with a single click"?

### What changes do you propose?

I don't know what this is trying to say. Assuming it has something to do with supporting clicking instead of drag and drop, that should be specified.

### Anything else that can help to cover this?

See my live reaction at https://www.youtube.com/live/2gxN_VZVyFU?si=-A61Q8uiJaJg2w_q&t=6856.

Contributor guide

Open the contributing guide

Research direction

Read the guideline at the linked Adobe Express documentation page, especially the quoted “Single-click to Add” wording, and compare it with the surrounding guidance. Clarify what kinds of content and interactions the guideline covers so the revised text no longer implies that every add-on must add an image; done means the requirement is unambiguous.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.