Skip to content

For the complete documentation index, see llms.txt.

Keep localized docs current

When your docs ship in more than one language, the translated pages fall behind each time the source content changes. Most teams write in one language, often English, and mirror it into the others. To keep the translations current, pair a trigger on the directory you write in with translation instructions. When source pages change, Promptless drafts the matching updates for your other languages.

Add a trigger on your source-language directory

Section titled “Add a trigger on your source-language directory”

A GitHub commits trigger runs when new commits are pushed to a branch, whether or not the commits came through a pull request.

  1. On the Configuration page, open the Triggers tab.

  2. Select Add an automatic or scheduled trigger, then select GitHub commits.

  3. Expand More filters (optional).

  4. Under Only when files in these folders change, enter the directory you write in, such as docs/en, and press Enter.

  5. Select Add trigger.

Only commits that change files in that directory start a run, so a commit that touches only translated directories doesn’t.

The trigger decides when Promptless runs. Your instructions tell it how to handle the translation. Put them in PROMPTLESS.md, which Promptless loads at the start of every run.

  1. Open PROMPTLESS.md in your Agent Knowledge Base.

  2. Name the directory you write in, the directories to update, and any terms to keep in the source language. For example: “docs/en is the documentation source directory. Localize changes into docs/es and docs/ja, and keep product names untranslated.”

  3. Select Save.

For the “If, then” hook format and where longer workflows live, see Teach Promptless a custom task.

When a source page changes, Promptless opens a suggestion with the translated changes. Have someone fluent in the target language review and publish it. You can’t judge a translation’s correctness from the diff alone.

Teach translation conventions with feedback

Section titled “Teach translation conventions with feedback”

Expect to refine your translation instructions over the first few suggestions, especially when you maintain several target languages or are catching up a backlog. Product names, terms of art, and phrases you leave untranslated need to come out the same way every time.

When you correct a translation, teach the convention with feedback. When you close a suggestion with a reason, leave Send to Promptless checked so the feedback shapes future suggestions. Promptless records what it learns in your Agent Knowledge Base. For example, it records which terms stay in the source language or how to render a feature name.

Catch up translations that are already behind

Section titled “Catch up translations that are already behind”

The trigger acts on new commits. It doesn’t scan pages that are already out of date. For one-time work across all your translated pages, use Deep Analysis. Describe the catch-up in its instructions, and Promptless returns a coordinated set of suggestions. Once your translations are current, new commits to your source-language directory start runs as usual.

Review localization pull requests at first. Once a fluent reviewer trusts the output, you can have Promptless merge them automatically:

  1. On the Configuration page, open the Policies tab.

  2. Add a rule, and under When this matches, choose your translation trigger.

  3. Turn on Open a pull request automatically and Merge the pull request automatically. Auto-merge requires automatic pull request creation.

  4. Select Save policies.

The rule applies only to your translation trigger. Your other suggestions follow your default policy. Promptless doesn’t auto-merge into a protected branch. With the GitHub (read-only) app, Promptless opens pull requests from a fork and doesn’t merge them automatically, so merge those yourself.

Promptless drafts translations from the instructions you provide. It has no documented integration with a translation management system (TMS) such as Phrase, Crowdin, or Lokalise. If your team uses a TMS and wants Promptless to hand off to it, email help@gopromptless.ai to discuss your requirements.