Skip to content

Conversation

@d-bytebase
Copy link
Contributor

Summary

  • Restructured the what-is-bytebase.mdx introduction page to better position Bytebase as a DevSecOps control plane
  • Emphasized two core value propositions: Productivity & Reliability, and Security & Compliance
  • Retained product comparisons while improving their messaging

Changes Made

  • Updated title to "Bytebase: The DevSecOps Control Plane for Your Databases"
  • Reorganized content into two main workflow sections
  • Refined comparison sections with stronger positioning against alternatives
  • Maintained visual assets (comparison charts) to demonstrate market success

Test plan

  • Review markdown formatting and structure
  • Verify all links remain functional
  • Confirm images are properly referenced
  • Preview in Mintlify dev server to ensure proper rendering

🤖 Generated with Claude Code

Restructured the what-is-bytebase introduction to better communicate Bytebase as a DevSecOps control plane with two core value propositions:
1. Productivity & Reliability through managed schema changes
2. Security & Compliance through governed data access

The new content emphasizes enterprise outcomes while maintaining technical comparisons with existing tools.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Copilot AI review requested due to automatic review settings August 27, 2025 09:21
@vercel
Copy link

vercel bot commented Aug 27, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
bytebase-com Ready Ready Preview Comment Aug 27, 2025 9:42am

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR revamps the Bytebase introduction page to better position the product as a DevSecOps control plane for databases. The restructuring emphasizes two core value propositions while maintaining product comparison content.

  • Reorganized content into two main workflow sections focused on productivity/reliability and security/compliance
  • Updated the page title and messaging to emphasize DevSecOps positioning
  • Streamlined comparison sections while retaining competitive differentiation
Comments suppressed due to low confidence (1)

mintlify/introduction/what-is-bytebase.mdx:51

  • The CloudBeaver comparison link is retained but the corresponding section text was removed. Consider removing this link as well since the comparison context no longer exists in the document.
- [Bytebase vs. DBeaver](https://www.bytebase.com/blog/bytebase-vs-dbeaver/)

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@github-actions
Copy link

github-actions bot commented Aug 27, 2025

📝 Broken Links Check Report

Note: Entries under /api-reference/ are likely false positives and can be ignored.

The following is the output from the broken links check:

found 16 broken links in 9 files

integrations/api/audit-log.mdx
 ⎿  /api-reference/auditlogservice/post-v1auditlogs:search

integrations/api/authentication.mdx
 ⎿  /api-reference/authservice/post-v1authlogin

integrations/api/data-classification.mdx
 ⎿  /api-reference/settingservice/patch-v1settings
 ⎿  /api-reference/databaseservice/patch-v1instances-databases

integrations/api/issue.mdx
 ⎿  /api-reference/issueservice/post-v1projects-issues

integrations/api/permission.mdx
 ⎿  /api-reference/workspaceservice/get-v1workspaces-:getIamPolicy
 ⎿  /api-reference/projectservice/get-v1projects-:getIamPolicy
 ⎿  /api-reference/roleservice/get-v1roles
 ⎿  /api-reference/userservice/get-v1users
 ⎿  /api-reference/groupservice/get-v1groups

integrations/api/plan.mdx
 ⎿  /api-reference/planservice/post-v1projects-plans
 ⎿  /api-reference/sheetservice/post-v1projects-sheets

integrations/api/release.mdx
 ⎿  /api-reference/releaseservice/post-v1projects-releases

integrations/api/rollout.mdx
 ⎿  /api-reference/rolloutservice/post-v1projects-rollouts

integrations/api/sql-review.mdx
 ⎿  /api-reference/releaseservice/post-v1projects-releases:check
 ⎿  /api-reference/sqlservice/post-v1sqlcheck

Copy link
Member

@tianzhou tianzhou left a comment

Choose a reason for hiding this comment

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

I prefer to keep the image. It's quicker to consume and grasp the idea than to parse a lot of words at first sight.

@d-bytebase
Copy link
Contributor Author

I prefer to keep the image. It's quicker to consume and grasp the idea than to parse a lot of words at first sight.

Images are great. But not the existing images, need to replace the image in the next PR.

@d-bytebase d-bytebase requested a review from tianzhou August 27, 2025 09:26
@tianzhou
Copy link
Member

Then let's keep the image for now and replace it in the next PR for review. The wording improvement is good. But the current images are intentionally made this way.

@tianzhou
Copy link
Member

To provide more context about those 2 images in the first place:

  1. The first one is to showcase Bytebase's strength (in particular, showcase the API part)
  2. The 2nd one is to allow visitors to grasp the idea using tools they are familiar with quickly.

Copy link
Member

@tianzhou tianzhou left a comment

Choose a reason for hiding this comment

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

LGTM

@d-bytebase d-bytebase merged commit b337264 into main Aug 27, 2025
4 of 5 checks passed
@d-bytebase d-bytebase deleted the update-bytebase-introduction branch August 27, 2025 09:41
@tianzhou
Copy link
Member

CleanShot 2025-08-27 at 17 43 49@2x

nit: adjust the wording to avoid the line wrapping

@d-bytebase
Copy link
Contributor Author

CleanShot 2025-08-27 at 17 43 49@2x nit: adjust the wording to avoid the line wrapping

#849

Line wrapping isn't a problem when we have to reveal the full messaging. The real issue is that the excessive wording makes the "On this page" section look cluttered and awkward previously. Fixed.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants