Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Write documentation for migrating workflow code

クローズ
#903 コメント 0 件 リアクション 0 件 担当者 1 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@PiusKariuki がすでに取り組んでいます。

2026年10月7日 から。

  • #904 @PiusKariuki による — マージ済み

評価

この issue はまだ評価されていません。

説明

P1

Objective

Document how a user can migrate a workflow from one OpenFn project to another by copying its YAML on Lightning.

Scope

  • In scope: Copying workflow YAML between projects via the Lightning UI (export from source, paste into target).

Required Sections

  1. Overview — one paragraph: what YAML migration is, when to use it, what it does not carry over (credentials, run history, webhook URLs).
  2. Prerequisites
    • Access to both source and target projects
    • Matching adaptor versions available on the target instance.
  3. Steps
    • Open the source workflow and export/copy its YAML
    • Open the target project and create a new workflow (or open the workflow editor)
    • Paste the YAML, review the diff, confirm deploy
    • Screenshots for each step
  4. What gets migrated vs. what doesn't
  • Table: jobs, triggers, edges, workflow structure (migrated) vs. credentials, run history, webhook URLs, collaborators (not migrated).
  1. Reconnecting credentials on the target
  • Credentials are referenced by name/ID; show how to recreate or remap them in the target project
  1. Verification checklist
    • Workflow appears in target, adaptor versions resolved, trigger reconfigured, one test run completes
  2. Common pitfalls
    • Adaptor version mismatch
    • Stale credential references

Acceptance Criteria

  • UI steps documented with screenshots
  • Explicit list of what does and does not transfer with the YAML
  • Credential-remapping steps included
  • Verification checklist a user can run through in under 5 minutes
  • Common pitfalls section with at least the 2 cases above
  • Linked from the Workflows index page
主要言語
JavaScript
スター
25
フォーク
21
平均マージ
1日 5時間
マージ済み PR(30日)
51

環境構築

  • Dockerfile・Docker Compose ファイルなし
  • プルリクエストのテンプレートあり
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

OpenFn/docs のほかの issue

OpenFn/docs の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。