Skip to content

Conversation

erioluwa-asiru
Copy link

Description

This PR adds a comprehensive guide for migrating projects from Bitbucket to GitHub. The guide provides step-by-step instructions to help users successfully migrate their repositories while maintaining their project history and structure.

Added docs pages

  • Migrate Project from Bitbucket to GitHub (/guides/all/migrate-project-from-bibucket-to-github)

Updated docs pages

  • No existing pages were updated

Summary

The new guide covers the complete migration process including:

  • Pre-migration preparation and checklist
  • Step-by-step migration instructions
  • Post-migration verification steps
  • Common issues and troubleshooting tips

This addresses the need for clear documentation on migrating between Git hosting platforms, making it easier for Port users to transition their projects from Bitbucket to GitHub.

Copy link

This pull request is automatically being deployed by Amplify Hosting (learn more).

Access this pull request here: https://pr-2744.d2ngvl90zqbob8.amplifyapp.com

Copy link
Contributor

@sivanel97 sivanel97 left a comment

Choose a reason for hiding this comment

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

Hi, left some comments on the PR :)

@@ -0,0 +1,794 @@
Migrating From Bitbucket to GitHub

# Outline
Copy link
Contributor

Choose a reason for hiding this comment

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

The title of the page should be more specific in regards to what the guide does.


# Outline

## 1. Introduction
Copy link
Contributor

Choose a reason for hiding this comment

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

No need to number the headers :)

- A Bitbucket account with the specified project and set of repositories you want to migrate to GitHub
- A GitHub organization where you have owner permissions or permissions to create a repository

## 3. Setting Up the GitHub and Bitbucket Integrations on Port
Copy link
Contributor

Choose a reason for hiding this comment

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

All headers should have a capital letter only for the first word. The rest of the sentence will be in lowercase letters. For example: "Promote scorecards". Unless one of them is a well known product such as Lambda, Kubernetes, ArgoCD, etc.

2. Click on **+ Blueprint** to create a blueprint
3. Click on the **Edit JSON** button to enter JSON mode and paste the blueprint definition below

```json
Copy link
Contributor

Choose a reason for hiding this comment

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

Please number the line like so:
And if the code is long put it in a collapsible as well. Same for the rest of the code snippets

Suggested change
```json
<details>
<summary><b>Port port-app-config.yml (click to expand)</b></summary>
```json showLineNumbers
...
</details>


Next, we define a mapping configuration to ingest GitHub repositories, associating them to the `githubService` blueprint in Port.

1. From the **Builder Page**, select **Data sources**
Copy link
Contributor

Choose a reason for hiding this comment

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

Please add links to the relevant pages like so:

Suggested change
1. From the **Builder Page**, select **Data sources**
1. From the [Builder](https://app.getport.io/settings/data-model) page, select [data sources](https://app.getport.io/settings/data-sources).

@@ -0,0 +1,794 @@
Migrating From Bitbucket to GitHub
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't really see the purpose of this line, Is it suppose to be the header? :)

I suggest using the CONTRIBUTING.md file either with Cursor or ChatGPT to make sure the change is compatible with the docs standards.

You also need to add the guide to the /src/components/guides-section/consts.js so it appears in the guides section.

@sivanel97 sivanel97 added the WIP label Sep 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants