Skip to content

Docusaurus blog cleanup #14

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

Merged
merged 5 commits into from
Jan 29, 2024
Merged

Docusaurus blog cleanup #14

merged 5 commits into from
Jan 29, 2024

Conversation

karan925
Copy link
Collaborator

@karan925 karan925 commented Jan 29, 2024

Closes #13

Summary by CodeRabbit

  • New Features

    • Enhanced blog functionality and user interface with updated image paths and content restructuring for better accessibility and readability.
    • Introduced specific settings for blog functionality, improving navigation and user experience on the website.
    • Updated the website configuration for a more intuitive and seamless user interface.
  • Documentation

    • Improved clarity and organization of blog posts on AI code reviews, OpenAI rate limits, and the modern AI stack for developer productivity through content rephrasing, restructuring, and the addition of new images and code blocks.
  • Refactor

    • Optimized website structure and navigation by reorganizing sidebar items and adjusting website base URL configuration.
  • Style

    • Adjusted formatting of URLs and tags in blog posts for consistency and improved readability.

@karan925 karan925 added the documentation Improvements or additions to documentation label Jan 29, 2024
@karan925 karan925 requested a review from guritfaq January 29, 2024 18:49
@karan925 karan925 self-assigned this Jan 29, 2024
Copy link

netlify bot commented Jan 29, 2024

Deploy Preview for reliable-buttercream-0e11cf ready!

Name Link
🔨 Latest commit 5dbdbce
🔍 Latest deploy log https://app.netlify.com/sites/reliable-buttercream-0e11cf/deploys/65b7f33ce4aafa0008c499a8
😎 Deploy Preview https://deploy-preview-14--reliable-buttercream-0e11cf.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor

coderabbitaidev bot commented Jan 29, 2024

Walkthrough

The recent changes across the CodeRabbit blog and site configuration reflect a comprehensive update aimed at enhancing user experience and content accessibility. These updates range from minor adjustments, such as image path corrections and content rephrasing, to more significant modifications like configuration updates in docusaurus.config.ts and structural changes in sidebars.ts. Collectively, these modifications aim to streamline content presentation, improve site navigation, and ensure that developer resources are up-to-date and easily accessible.

Changes

Files Summary of Changes
blog/.../welcome/index.md Updated image path; added hide_table_of_contents field.
blog/.../ai-code-reviews-reclaims/... Corrected image paths; content rephrasing and reorganization.
blog/.../coderabbit-openai-rate-limits/... Content restructuring; added images and code blocks; URL formatting adjustments.
blog/.../modern-ai-stack-for-developer-productivity/index.md Content rephrasing and reorganization; updated references to AI tools.
docusaurus.config.ts Updated baseUrl; modified presets and plugins; expanded blog settings.
sidebars.ts Reorganized "get-started" and "guides" sections.

Assessment against linked issues

Objective Addressed Explanation
Fix blog issue where one specific blog isn't showing up on the columned list (#13) The provided summaries do not directly address an issue related to a blog not appearing in a columned list.

Poem

In the heart of the code, where the rabbits dwell,
Changes bloom, in the docs they swell.
Paths and prose, reformed with care,
🥕 A digital garden, growing rare.


Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>.
    • Generate unit-tests for this file.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit tests for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai generate interesting stats about this repository from git and render them as a table.
    • @coderabbitai show all the console.log statements in this repository.
    • @coderabbitai read src/utils.ts and generate unit tests.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (invoked as PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai help to get help.

Additionally, you can add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.

CodeRabbit Configration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • The JSON schema for the configuration file is available here.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/coderabbit-overrides.v2.json

CodeRabbit Discord Community

Join our Discord Community to get help, request features, and share feedback.

Copy link
Contributor

@coderabbitaidev coderabbitaidev bot left a comment

Choose a reason for hiding this comment

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

Review Status

Actionable comments generated: 2

Configuration used: CodeRabbit UI

Commits Files that changed from the base of the PR and between 6e9de05 and 5dbdbce.
Files ignored due to path filters (17)
  • blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg is excluded by: !**/*.jpeg
  • blog/2023-08-26-welcome/CodeRabbitSecurity.jpg is excluded by: !**/*.jpg
  • blog/2023-08-26-welcome/coderabbit-openai-rate-limit-exceed.png is excluded by: !**/*.png
  • blog/2023-10-05-ai-code-reviews-reclaims/ai-powered.png is excluded by: !**/*.png
  • blog/2023-10-05-ai-code-reviews-reclaims/engineer.png is excluded by: !**/*.png
  • blog/2023-10-05-ai-code-reviews-reclaims/software-lifecycle.png is excluded by: !**/*.png
  • blog/2023-10-23-coderabbit-openai-rate-limits/flow-analytics-dark.png is excluded by: !**/*.png
  • blog/2023-10-23-coderabbit-openai-rate-limits/flow-analytics-light.png is excluded by: !**/*.png
  • blog/2023-10-23-coderabbit-openai-rate-limits/priorities-dark.png is excluded by: !**/*.png
  • blog/2023-10-23-coderabbit-openai-rate-limits/priorities-light.png is excluded by: !**/*.png
  • blog/2023-10-23-coderabbit-openai-rate-limits/request-flow.svg is excluded by: !**/*.svg
  • blog/2023-10-23-coderabbit-openai-rate-limits/token-rate-dark.png is excluded by: !**/*.png
  • blog/2023-10-23-coderabbit-openai-rate-limits/token-rate-light.png is excluded by: !**/*.png
  • blog/authors.yml is excluded by: !**/*.yml
  • blog/img/CodeRabbitDesign.jpg is excluded by: !**/*.jpg
  • package-lock.json is excluded by: !**/*.json
  • package.json is excluded by: !**/*.json
Files selected for processing (6)
  • blog/2023-08-26-welcome/index.md (2 hunks)
  • blog/2023-10-05-ai-code-reviews-reclaims/2023-10-05-ai-code-reviews-reclaims.md (4 hunks)
  • blog/2023-10-23-coderabbit-openai-rate-limits/2023-10-23-coderabbit-openai-rate-limits.md (9 hunks)
  • blog/2024-01-05-modern-ai-stack-for-developer-productivity/index.md (3 hunks)
  • docusaurus.config.ts (1 hunks)
  • sidebars.ts (1 hunks)
Files skipped from review due to trivial changes (3)
  • blog/2023-10-05-ai-code-reviews-reclaims/2023-10-05-ai-code-reviews-reclaims.md
  • blog/2024-01-05-modern-ai-stack-for-developer-productivity/index.md
  • sidebars.ts
Additional comments: 9
docusaurus.config.ts (3)
  • 71-82: The expansion of the blog section under presets includes several new settings like blogTitle, blogDescription, and blogSidebarTitle. Verify these changes enhance blog functionality as intended and check for consistency in naming and description across the site.
  • 48-58: The configuration for the docusaurus-tailwindcss plugin includes appending TailwindCSS and AutoPrefixer to postcssOptions. Ensure that the required npm packages for tailwindcss and autoprefixer are included in package.json and that the TailwindCSS configuration file exists and is correctly set up.
Verification successful

The verification confirms that both tailwindcss and autoprefixer are included in the package.json dependencies, and a tailwind.config.js file exists in the project. This aligns with the requirements mentioned in the review comment for the docusaurus-tailwindcss plugin configuration.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Check for tailwindcss and autoprefixer in package.json dependencies.
rg '"tailwindcss":' package.json
rg '"autoprefixer":' package.json
# Ensure TailwindCSS config file exists.
fd tailwind.config.js

Length of output: 181

* 110-177: The `themeConfig` section updates include settings for `colorMode`, `docs.sidebar`, `metadata`, `headTags`, `image`, and `navbar`. Confirm these changes align with the site's branding and functionality requirements. Specifically, verify the `navbar` items and `prism` theme settings to ensure they match the desired user experience and aesthetic.
Verification successful

The verification process has provided specific insights into the navbar and prismThemes configurations within the docusaurus.config.ts file. Based on the output:

  1. The navbar configuration is only explicitly mentioned in the docusaurus.config.ts file, suggesting that the navbar items' consistency across the site is centralized in this configuration. This implies that the changes made to the navbar items in the provided code snippet are consistent across the site, as they are defined in a single, central location.

  2. The prismThemes import and usage are also confined to the docusaurus.config.ts file. The script output confirms the import of prismThemes from "prism-react-renderer" and their application as themes for code syntax highlighting within the site. This directly aligns with the verification goal to ensure that the prism theme settings for code syntax highlighting match the desired aesthetic and functionality.

Given these findings, the changes to the themeConfig section, specifically regarding the navbar items and prism theme settings, are verified to align with the site's branding and functionality requirements as per the original review comment. The verification process has confirmed the consistency and appropriateness of these configurations within the docusaurus.config.ts file.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Check for consistency in navbar items across the site.
rg 'navbar' --type ts
# Verify prism theme settings for code syntax highlighting.
rg 'prismThemes' --type ts

Length of output: 279

blog/2023-08-26-welcome/index.md (2)
  • 8-8: The addition of hide_table_of_contents: false explicitly enables the table of contents for this blog post. Confirm this setting is consistent with the desired layout and presentation of blog posts on the site.
  • 85-85: The image path correction from ./CodeRabbitDesign.jpg to ../img/CodeRabbitDesign.jpg ensures the image is correctly displayed. Verify the new path is accurate and the image exists at the specified location.
Verification successful

The image CodeRabbitDesign.jpg exists at the path blog/img/CodeRabbitDesign.jpg, which confirms that the corrected path ../img/CodeRabbitDesign.jpg in the markdown file is accurate, assuming the markdown file's location is within the blog/2023-08-26-welcome/ directory. This ensures the image is correctly referenced and should display as intended.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Ensure the image exists at the new path.
fd 'CodeRabbitDesign.jpg' src/img

Length of output: 128



Script:

#!/bin/bash
# Search for 'CodeRabbitDesign.jpg' without specifying a directory to find its actual location.
fd 'CodeRabbitDesign.jpg'

Length of output: 55

blog/2023-10-23-coderabbit-openai-rate-limits/2023-10-23-coderabbit-openai-rate-limits.md (4)
  • 77-83: The explanation of OpenAI's rate limits and the computational intensity of the gpt-4 model provides valuable context. Ensure the details are accurate and reflect the current state of OpenAI's API limitations and infrastructure.
  • 93-93: The inclusion of an image to illustrate the CodeRabbit Pull Request Review Workflow enhances understanding. Confirm the image is correctly displayed and relevant to the content discussed.
Verification successful

The image CodeRabbitDesign.jpg exists in the specified path blog/img/, confirming that the image is correctly placed for inclusion in the blog post as intended.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Ensure the image file exists in the specified path.
fd 'CodeRabbitDesign.jpg' blog/img

Length of output: 64

* 157-184: The detailed implementation of the Aperture TypeScript SDK showcases a sophisticated approach to managing OpenAI rate limits. Ensure the code snippet is up-to-date with the latest SDK version and follows best practices for asynchronous operations and error handling. * 288-324: > 📝 **NOTE** > This review was outside the diff hunks and was mapped to the diff hunk with the greatest overlap. Original lines [257-367]

The policy configuration for managing quotas with Aperture is crucial for aligning with OpenAI's rate limits. Verify the YAML configuration matches the current Aperture and OpenAI specifications, ensuring optimal performance and compliance.

@guritfaq guritfaq merged commit 315619b into master Jan 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Fix blog issue where one blog specific blog isn't showing up on the columned list
2 participants