Skip to content

Commit e3be3b9

Browse files
authored
Add notes about PR branch management (#14)
1 parent dc2bf24 commit e3be3b9

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

automation.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,9 @@ Records of requested and performed actions are under `./records`.
3131
Content automation is done in the form of adding new JSON files to `records/new`. To submit the request:
3232

3333
1. Open a pull request targeting the `main` branch to add a JSON file or multiple JSON files to `records/new/`.
34+
- Currently, the PR branch should be opened from the nodejs repository if you have write access to it, so that the PR gets full validation using the secrets in the repository. PRs from forks cannot get a full validation due to GitHub workflow restrictions.
3435
- The file name can be anything, as long as it ends with `.json`, though its better to give it a descriptive name like `repost.json`. The file will be renamed and moved to `records/processed` later so it doesn't matter how it is named during the draft phase.
35-
- For example, see https://github.com/joyeecheung/bluesky-playground/pull/8
36+
- For example, see https://github.com/nodejs/bluesky/pull/8
3637
2. The JSON files must contain at least the two required fields:
3738
- `"account"`: a pre-configured account name, see [repository setup](#set-up-automation-in-a-repository) on account name configuration.
3839
currently the following accounts are supported:
@@ -45,6 +46,7 @@ Content automation is done in the form of adding new JSON files to `records/new`
4546
- For other fields see the examples under [`records/new`](./records/new).
4647
3. When the PR is opened, the [validate-json](./.github/workflows/validate.yml) workflow will run to make sure the JSON files are correctly filled. It will verify the URLs filled in the JSON files are valid.
4748
4. When the PR is merged, the [process-json](./.github/workflows/process.yml) workflow will run to perform the requested actions, and when it's done, it will move the processed JSON files to `./records/processed` and renamed the file to `YYYY-MM-DD-ID.json` where ID is an incremental ID based on the number of files already processed on that date. It will also add in additional details of the performed actions (e.g. CID and URI of the posted post).
49+
5. When the process workflow is complete (likely within a minute), you should see a commit from the GitHub bot in the main branch moving the JSON file. **Important**: do not delete the PR branch until the process workflow is complete!
4850

4951
## Set up automation in a repository
5052

0 commit comments

Comments
 (0)