Skip to content

fix: Use per OS login command in quick start guide#19095

Merged
kodiakhq[bot] merged 2 commits intocloudquery:mainfrom
erezrokah:fix/signin_docs_linux_windows
Sep 5, 2024
Merged

fix: Use per OS login command in quick start guide#19095
kodiakhq[bot] merged 2 commits intocloudquery:mainfrom
erezrokah:fix/signin_docs_linux_windows

Conversation

@erezrokah
Copy link
Copy Markdown
Member

Summary

In our quick start guides we tell users to run cloudquery login. However we use the same command for all operating systems. cloudquery login won't work for Linux (unless added to the PATH) or Windows
image

This PR fixes the issue by using cloudquery login on macOS, ./cloudquery login on Linux and cloudquery.exe login on Windows. The fix is consistent with how we tell users to run a sync a bit below in the guide:

macOS

image

Linux

image

Windows

image

@erezrokah erezrokah requested review from a team and marianogappa and removed request for a team September 5, 2024 14:38
import ConfigureSource from './_configure-source.mdx';
import ConfigureAuthenticateProvider from './_configure-authenticate-provider.mdx';
import ConfigureStartSyncing from './_configure-start-syncing.mdx';
import ConfigureSyncCommandUnixPrecompiled from './_configure-sync-command-unix-precompiled.mdx';
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated fix to make this filename more clear

import ConfigureSource from './_configure-source.mdx';
import ConfigureAuthenticateProvider from './_configure-authenticate-provider.mdx';
import ConfigureStartSyncing from './_configure-start-syncing.mdx';
import ConfigureSyncCommand from './_configure-sync-command.mdx';
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated fix to make this filename more clear

---

import Intro from '../../../components/mdx/_intro.mdx'
import SignIn from '../../../components/mdx/_cloudquery_sign_in.mdx'
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated fix to make this filename to have consistent casing like other files

---

import Intro from '../../../components/mdx/_intro.mdx'
import SignIn from '../../../components/mdx/_cloudquery_sign_in.mdx'
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated fix to make this filename to have consistent casing like other files

---

import Intro from '../../../components/mdx/_intro.mdx'
import SignIn from '../../../components/mdx/_cloudquery_sign_in.mdx'
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unrelated fix to make this filename to have consistent casing like other files

```bash
cloudquery login
```
<SignIn os={props.os} />
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the fix, pass the prop from each individual OS guide to the SignIn to render a different command

@erezrokah erezrokah added the automerge Automatically merge once required checks pass label Sep 5, 2024
@kodiakhq kodiakhq bot merged commit aa7801f into cloudquery:main Sep 5, 2024
@erezrokah erezrokah deleted the fix/signin_docs_linux_windows branch September 5, 2024 15:56
kodiakhq bot pushed a commit that referenced this pull request Sep 5, 2024
#### Summary

At the moment the quick start guide is split into many components making it harder to update it. This was done to support multiple operating systems via components composition. However we can use the same approach as in #19095 (a `switch/case` to handle the logic) instead.
That allows us to have a single component with all the guide, making it easier to update
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/website automerge Automatically merge once required checks pass

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants