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

Add redis to contributor guide #7369

Merged
merged 4 commits into from
Oct 1, 2024
Merged

Add redis to contributor guide #7369

merged 4 commits into from
Oct 1, 2024

Conversation

charlesBochet
Copy link
Member

@charlesBochet charlesBochet commented Oct 1, 2024

Context

We are adding redis to default twenty configuration.

What

  1. This PR sets up the local setup for contributors accordingly

  2. I'm also updating the code blocks guide:

Before:
image

After:
image

@@ -10,8 +10,6 @@
"@blocknote/react": "^0.15.3",
"@codesandbox/sandpack-react": "^2.13.5",
"@dagrejs/dagre": "^1.1.2",
"@docusaurus/core": "^3.1.0",
Copy link
Member Author

Choose a reason for hiding this comment

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

we are not using Docusaurus anymore

@@ -14,6 +14,8 @@
"database:generate:pg": "npx drizzle-kit generate:pg --config=src/database/drizzle-posgres.config.ts"
},
"dependencies": {
"@docsearch/react": "^3.6.2",
"gray-matter": "^4.0.3",
Copy link
Member Author

Choose a reason for hiding this comment

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

as we deprecate docusaurus, we need to re-add docsearch (search) and gray-matter (mdx header parsing)

Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

PR Summary

This PR adds Redis setup instructions to the local setup guide for Twenty, enhancing the contributor onboarding process.

  • Added Step 4 in packages/twenty-website/src/content/developers/local-setup.mdx for Redis database setup, including platform-specific installation instructions
  • Removed Docusaurus-related dependencies from the root package.json, indicating a shift in documentation tooling
  • Added '@docsearch/react' and 'gray-matter' dependencies to packages/twenty-website/package.json, suggesting new search and markdown processing capabilities
  • Modified styling in ArticleContent.tsx and layout.css to improve code block appearance and remove inline code styling

5 file(s) reviewed, 3 comment(s)
Edit PR Review Bot Settings

@@ -10,6 +10,12 @@ const StyledContent = styled.div`
flex: 1;
max-width: 950px;

pre {
background: #1414140a;
Copy link
Contributor

Choose a reason for hiding this comment

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

style: Consider using a CSS variable for the background color to maintain consistency with the theme

@@ -10,6 +10,12 @@ const StyledContent = styled.div`
flex: 1;
max-width: 950px;

pre {
background: #1414140a;
padding: 4px;
Copy link
Contributor

Choose a reason for hiding this comment

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

style: 4px padding might be too small for code blocks. Consider increasing to 8px or 12px for better readability

Comment on lines 124 to 126
font-weight: 500;
text-decoration: none;
}
Copy link
Contributor

Choose a reason for hiding this comment

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

style: Consider keeping or updating the code element styling to maintain visual distinction for code snippets.

@@ -138,19 +140,35 @@ You can access the database at [localhost:5432](localhost:5432), with user `twen
</ArticleTab>
</ArticleTabs>

## Step 4: Set up a Redis Database (cache)
Copy link
Contributor

Choose a reason for hiding this comment

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

Since we offer a docker PostgreSQL. Can we offer a docker option also? @charlesBochet

Copy link
Member Author

Choose a reason for hiding this comment

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

@hozza We actually want to get rid of docker in the contributor guide.
While I personally think docker is the best way, most of the contributors are not at ease with it and this was generating too much friction on the install (many thread on Discord). We've chosen not to maintain docker containers ourselves.

Setting up redis with docker is straightforward and I believe that contributors wanting to provision it through docker will manage to do it by themselves.

I would say docker setup should not be part of the local setup guide and we will (or the community!) will likely write a blog post about it at some point

Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks, your comments here may help to explain this as well #7370

@charlesBochet charlesBochet merged commit 4008f8f into main Oct 1, 2024
9 of 16 checks passed
@charlesBochet charlesBochet deleted the add-redis-to-docs branch October 1, 2024 13:21
harshit078 pushed a commit to harshit078/twenty that referenced this pull request Oct 14, 2024
## Context

We are adding redis to default twenty configuration. 

## What

1. This PR sets up the local setup for contributors accordingly

2. I'm also updating the code blocks guide:

Before:
<img width="921" alt="image"
src="https://github.com/user-attachments/assets/2203cc99-b5a5-4d05-a8b1-98a348aee9df">


After:
<img width="921" alt="image"
src="https://github.com/user-attachments/assets/5b3e6f34-723d-4309-888b-c02ce794891d">
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