Skip to content

Commit dc2bddc

Browse files
committed
Merge branch 'next' into kanad-2025-10-07/working-directory-CX-2286
2 parents 27d75cd + 3b84f42 commit dc2bddc

File tree

6 files changed

+13
-8
lines changed

6 files changed

+13
-8
lines changed

CONTRIBUTING.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@ bin/run.js openapi validate __tests__/__fixtures__/ref-oas/petstore.json
2626

2727
Your changes to the command code may make changes to [the command reference documents](./documentation/commands) — it is up to you whether you include those changes in your PR or if you let the release process take care of it. More information on that can be found in [`MAINTAINERS.md`](./MAINTAINERS.md).
2828

29+
## ReadMe Development 🦉
30+
31+
If you're a ReadMe team member that's testing `rdme` against a non-production ReadMe environment, you can either set the `RDME_LOCALHOST=true` environment variable (which points your CLI to the localhost version of ReadMe) or modify the URLs in `src/lib/config.ts` directly.
32+
2933
## Running GitHub Actions Locally 🐳
3034

3135
To run GitHub Actions locally, we'll be using [`act`](https://github.com/nektos/act) (make sure to read their [prerequisites list](https://github.com/nektos/act#necessary-prerequisites-for-running-act) and have that ready to go before installing `act`)!

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -114,11 +114,11 @@ For local CLI usage with a single project, you can authenticate `rdme` to your R
114114
> [!WARNING]
115115
> For security reasons, we strongly recommend providing a project API key via the `--key` option in automations or CI environments (GitHub Actions, CircleCI, Travis CI, etc.). It's also recommended if you're working with multiple ReadMe projects to avoid accidentally overwriting existing data.
116116
117-
You can also pass in your API key via environmental variable. Here is the order of precedence when passing your API key into `rdme`:
117+
You can also pass in your API key via environment variable. Here is the order of precedence when passing your API key into `rdme`:
118118

119119
1. The `--key` option. If that isn't present, we look for...
120-
1. The `RDME_API_KEY` environmental variable. If that isn't present, we look for...
121-
1. The `README_API_KEY` environmental variable. If that isn't present, we look for...
120+
1. The `RDME_API_KEY` environment variable. If that isn't present, we look for...
121+
1. The `README_API_KEY` environment variable. If that isn't present, we look for...
122122
1. The API key value stored in your local configuration file (i.e., the one set via `rdme login`)
123123

124124
`rdme whoami` is also available to you to determine who is logged in, and to what project. You can clear your stored credentials with `rdme logout`.
@@ -133,7 +133,7 @@ To set this up, check out [1Password's documentation on the ReadMe shell plugin]
133133

134134
## Proxy
135135

136-
`rdme` makes API requests to the ReadMe API, which is located at [dash.readme.com](https://dash.readme.com). If you need to configure a proxy for these requests, you can do so by setting the `HTTPS_PROXY` environmental variable.
136+
`rdme` makes API requests to the ReadMe API, which is located at [dash.readme.com](https://dash.readme.com). If you need to configure a proxy for these requests, you can do so by setting the `HTTPS_PROXY` environment variable.
137137

138138
```sh
139139
export HTTPS_PROXY=https://proxy.example.com:5678

documentation/synced/legacy/rdme.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -293,7 +293,7 @@ If you're working with the `docs` command specifically, we recommend using [dry
293293

294294
### Troubleshooting CLI
295295

296-
If you're troubleshooting issues with the CLI (or in some non-GitHub Actions environment), you can use the `DEBUG` environmental variable to print helpful debugging info to the console:
296+
If you're troubleshooting issues with the CLI (or in some non-GitHub Actions environment), you can use the `DEBUG` environment variable to print helpful debugging info to the console:
297297

298298
```sh
299299
DEBUG=rdme* rdme openapi validate [url-or-local-path-to-file]

documentation/synced/rdme.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -343,7 +343,7 @@ If you're working with the Markdown upload commands (e.g., `docs upload`, `refer
343343

344344
### Troubleshooting CLI
345345

346-
If you're troubleshooting issues with the CLI (or in some non-GitHub Actions environment), you can use the `DEBUG` environmental variable to print helpful debugging info to the console:
346+
If you're troubleshooting issues with the CLI (or in some non-GitHub Actions environment), you can use the `DEBUG` environment variable to print helpful debugging info to the console:
347347

348348
```sh
349349
DEBUG=rdme* rdme openapi upload [url-or-local-path-to-file] --key=...

package.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@
1313
"files": [
1414
"/bin/run*",
1515
"/dist",
16+
"/documentation",
1617
"/oclif.manifest.json"
1718
],
1819
"keywords": [

src/lib/config.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
const config = {
22
host: {
3-
v1: 'https://dash.readme.com',
4-
v2: 'https://api.readme.com/v2',
3+
v1: process.env.RDME_LOCALHOST ? 'http://dash.readme.local:3000' : 'https://dash.readme.com',
4+
v2: process.env.RDME_LOCALHOST ? 'http://api.readme.local:3000/v2' : 'https://api.readme.com/v2',
55
},
66
} as const;
77

0 commit comments

Comments
 (0)