Repository navigation
docs: Community Translation feature - #1130
Merged
Merged
Conversation
✅ Deploy Preview for tolgee-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Anty0
force-pushed
the
jirikuchynka/community-translations-docs
branch
from
August 24, 2026 06:23
5000564 to
f756e51
Compare
Anty0
marked this pull request as ready for review
August 24, 2026 11:47
Barush
requested changes
Sep 2, 2026
Add a Community Translation page covering public projects, the community permission, the public projects discovery page, reviewing community suggestions, and unpublishing. Cross-link and update related pages: - suggestions: two accept actions (Accept only / Accept and decline others) and the three-suggestions-with-Show-all display - project_settings: Public project advanced setting - members: community-permission note on public projects - sidebar: new page entry
Cover the Contributors release (contributors tab, community projects
page, My contributions only toggle) and add UI screenshots to the
Community Translation, Suggestions, and Member Management pages.
- community_translation: contributors ('See who has contributed'),
community projects page + 'My contributions only', screenshots for
the public toggle, public projects page, community projects, the two
accept actions, and the contributors tab
- members: 'Community contributors' section with the Team/Community tabs
- suggestions: screenshot of the two accept actions
…highlight The ScreenshotWrapper renders window chrome, so interior crops looked wrong. Retake the public toggle, contributors tab, community projects page, and suggestion accept actions as full-viewport shots with the relevant area outlined in red.
…out highlight These two capture the page's main content, so no red highlight is needed. Also fix their sizing: trim the excess width (side gutters) and, for the contributors tab, the trailing vertical whitespace.
Condense the Community Translation and Member Management pages and fix subject/verb and article agreement in the community-permissions wording.
Use the list view to match the other screenshots, and tighten the highlight to just the Accept only button and the Accept and decline others menu item.
Anty0
force-pushed
the
jirikuchynka/community-translations-docs
branch
from
September 20, 2026 15:42
428415f to
317cf0e
Compare
1 of 2 tasks
- Move the Community Translation pages under Translation Process with kebab-case names, and rename the contributor page to translate-with-tolgee.mdx - Restructure Community Translation by owner and contributor point of view, with a self-contained lead, numbered procedures, the exposure of a public project, who may accept and publish, and the self-hosted requirements - Name the free Business plan for non-commercial open source with a mailto:sales@tolgee.io link - Fill in the released versions, the suggestions_disabled status (409), and the plugin and dialog labels as the products spell them - Build the in-context suggestions section on main's sign-in rewrite and link to oauth_sign_in.mdx instead of a second self-hosting section - Retake the advanced project settings screenshot with Public project and move it to the top of the section; add a suggest-only dialog screenshot
…y-sdk-suggestions # Conflicts: # js-sdk/in_context.mdx
Barush
approved these changes
Oct 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents Community Translation end to end: public projects and community contributors in the platform (pitch tolgee/tolgee-platform#3806), and suggesting translations in context through the Tolgee Tools browser plugin (pitch tolgee/tolgee-platform#3780). It includes the changes from #1144, which was built on top of this branch and is merged into it.
The feature is released:
Community translationswitcher entryCommunitytab,Invite to Teamtolgee.oauth2.browser-extension-enabled)@tolgee/web7.3.0, Tolgee v3.227.0New pages
platform/translation_process/community-translation.mdx, the feature hub. It has a part for owners and members (making a project public and what that exposes, sharing it, reviewing suggestions, seeing who contributed, making it private again) and a part for contributors (what they can do, finding the projects they helped with). It also covers the self-hosted requirements: version floor, authentication and open registrations.platform/translation_process/community-translation-in-context.mdx, for owners whose website uses the Tolgee JS SDK. It covers what to switch on in the project and on a self-hosted server, what to declare on the website (apiUrl,projectId, noapiKey), what contributors need, theTranslate with Tolgeebadge, and what contributors can do in the dialog.platform/translate-with-tolgee.mdxis the page the badge links to, through the short link/translate-with-tolgeethatstatic/_redirectspoints to it. It walks a first-time contributor through installing the plugin, signing in and Alt+clicking a string, and lists fixes for common problems.Updated pages
js-sdk/in_context.mdxgets a new section, "Suggesting Translations in Context". It covers theSave/Suggest/Save & suggestbutton, the per-field notes, partial failures, reviewing suggestions in the dialog, suggest-only permissions and troubleshooting. A short paragraph links the sign-in section to it. The page is based on main's version from docs: sign in with a Tolgee account for the CLI, the browser extension and MCP clients #1151.suggestions.mdxdescribes the two accept actions (Accept onlyandAccept and decline others) and the display of up to three suggestions withShow all. It notes thatSuggestions modeoff rejects new suggestions withsuggestions_disabled(HTTP 409), and it documents theDelete ownpermission. It also corrects which permissions accepting and declining need.project_settings.mdxgets aPublic projectsection, and the Advanced screenshot is retaken and moved to the top of the section (see the review comments below).members.mdxgets aCommunity Contributorssection (theTeamandCommunitytabs) and a community-permissions note.sidebarPlatform.js: both community pages sit under Translation Process, and the contributor page sits under Get Started.Review comments addressed
mailto:sales@tolgee.io.Community translationappears.My contributions onlyfilters, and thatCommunity translationis not a real organization.Public projectand sat at the bottom of the section. It is retaken withPublic projecton top and moved directly under the section heading.Read morefrom the settings page links to the "Making a Project Public" anchor.public projectlinks on the Members page go to the "Making a Project Public" anchor instead of the page top.Screenshots
These are captured against a local Tolgee v3.236.0 and the
@tolgee/webtest app, or reused from main.Connect to Tolgeepopup and consent screen, reused from main's docs: sign in with a Tolgee account for the CLI, the browser extension and MCP clients #1151 imagesOpen
/translate-with-tolgeeanswers 301 to/platform/translate-with-tolgee).static/img/docs/platform/oauth/consent-screen-browser-extension.webpon the contributor page with a capture made as a contributor. The current one shows a user with edit rights.The branch is up to date with
main. Checked withnpm run build, which throws on broken links and anchors.