Proposals, issues and discussions

You can help improve artifacts you do not own in three ways.

Propose a change

A proposal is a suggested new version that the owner accepts or declines.

1. On a public artifact, press Propose a change.
2. Edit the files right on the page and explain why in Proposal Note.
3. Press Submit proposal. It gets a Health check, and its files count toward your storage.

You can have one open proposal per artifact: submitting again replaces it, and you can Withdraw it while it is open. If you can already publish to the artifact, you are sent to its publish page instead.

The owner sees it on the artifact's Proposals tab and either chooses a version number and presses Accept and publish, or presses Decline with a reason. You cannot accept your own proposal.

Personal artifacts accept proposals by default; organisation artifacts do not until someone switches Accept proposals on. On a personal artifact that is not public, people it was shared with as editors can propose too.

Open an issue

An issue says a specific version did not work for you. On the Issues tab, press Open an issue, pick the Version and a Kind (Failed, Unclear, Outdated or Improvement), add a title and Details, and press Open issue. An issue can be closed as fixed in a newer version, closed as not planned, or reopened. Publishing a version can close issues it fixes.

Discussions and comments

A public artifact's page has a Discussion for questions and ideas. Press Start a thread, or reply to a post; replies nest under the post they answer, up to three levels. Sort posts by Top (most upvoted) or New, vote with the up arrow, and use Report on a post that breaks the rules. New accounts wait a short time before they can post. Posts here show as plain text, so Markdown stays as typed and writing an @handle tells nobody. The Community works the same way for questions that are not about one artifact, with two differences: only a Community thread has an accepted answer, so posts here always follow the sort you chose, and a Community thread loads replies five at a time where this Discussion loads twenty.

When a conversation gets several replies while you are away, you get one notification for it until you read it, and at most one email a day for that conversation. The preview in a notification shows the words a reader sees, so formatting and hidden HTML comments are left out. Reviews and proposals have their own comment threads between the author and the people who decide.

You can edit your comment for a few minutes after posting it. You can hide your own comment; the artifact's owner and moderators can hide any post in its discussion. A hidden comment leaves a marker and takes no replies. A post moderators removed after a report shows "Removed by a moderator" to everyone but its author.