Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jetify Sandbox Docs Draft #2255

Open
wants to merge 12 commits into
base: main
Choose a base branch
from
Open

Jetify Sandbox Docs Draft #2255

wants to merge 12 commits into from

Conversation

Lagoja
Copy link
Contributor

@Lagoja Lagoja commented Sep 5, 2024

  • reorganize docs

  • remove deploy references

  • Adding content to Sandboxes Docs

  • add more content

title: "Jetify Docs",
tagline: "Instant, easy, and predictable shells and containers",
url: "https://www.jetify.com",
baseUrl: "/",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Wait, I don't think this is right. What are we trying to do here?

Copy link
Contributor Author

@Lagoja Lagoja Sep 27, 2024

Choose a reason for hiding this comment

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

We're trying to split the docs into Devbox and Cloud, so we can have urls like: https://www.jetify.com/devbox/docs and https://www.jetify.com/cloud/docs. Further down you'll see that each of the docs folders have their own route base paths:

 docs: {
          routeBasePath: "/devbox/docs",
          sidebarPath: require.resolve("./sidebars.js"),
          // Please change this to your repo.
          // Remove this to remove the "edit this page" links.
          docItemComponent: "@theme/ApiItem",
          editUrl: "https://github.com/jetify-com/devbox/tree/main/docs/app/",
        },

Is there a better way to do this? It works well in Vercel, but not sure if it will interfere with other pages

Copy link
Collaborator

Choose a reason for hiding this comment

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

oh I see 👍

Copy link
Collaborator

@LucilleH LucilleH left a comment

Choose a reason for hiding this comment

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

🎉

1. Navigate to the **Projects** tab in the Jetify Dashboard
2. Click on the `Create New` button on the top right corner of the page
3. In the modal that appears, give the project a name, and then click "Create Project"
4. In the new project, navigate to the Settings tab, and then click "Connect with Github" to connect the project to a Github repository
Copy link
Collaborator

Choose a reason for hiding this comment

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

No longer need to navigate to the Settings tab unless you have created a sandbox for that project already (the empty state also has a Connect with Github or Choose Repository

4. In the new project, navigate to the Settings tab, and then click "Connect with Github" to connect the project to a Github repository
5. Select the account and repository to link to the project.

Once the project is linked to a repository, developers can automatically create a new Sandbox for that repository by navigating to the project and clicking on the `New Sandbox` button.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Once the project is linked to a repository, developers can automatically create a new Sandbox for that repository by navigating to the project and clicking on the `New Sandbox` button.
Once the project is linked to a repository, developers can automatically create a new Devspace for that repository by navigating to the project and clicking on the `New Devspace` button.

@@ -11,7 +11,7 @@ If you don't already have Devbox installed, see our [Quickstart](https://www.jet

You can authenticate with Jetify Cloud by running `devbox secrets auth login`. This will launch the browser authentication flow to sign into Jetify Cloud.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
You can authenticate with Jetify Cloud by running `devbox secrets auth login`. This will launch the browser authentication flow to sign into Jetify Cloud.
You can authenticate with Jetify Cloud by running `devbox auth login`. This will launch the browser authentication flow to sign into Jetify Cloud.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

2 participants