diff --git a/docs/customizations.md b/docs/customizations.md
index a2e8b4793..27ab85d62 100644
--- a/docs/customizations.md
+++ b/docs/customizations.md
@@ -1,76 +1,76 @@
# Customizing and Creating Derivative Applications
-Creating a derivative application from big-AGI allows you to extend its capabilities, tailor the experience to your needs, or even target a completely new audience. This guide provides an overview of how to start this exciting journey.
+This document outlines how to develop applications derived from big-AGI, allowing for extension of its functionalities, adaptation to specific needs, or targeting new user groups.
## Manual Customization
-Customizing the application happens through manual code alterations or at best through environment variables.
-At the moment there is no "Wizard" or administation panel to customize the application.
-You will need to manually edit the source code to make changes, and this includes modifying the personas,
-adding new features, or integrating additional APIs.
+Application customization requires manual code modifications or the use of environment variables. Currently, there is no graphical interface for customization. Changes include editing source code for persona modifications, feature additions, or API integrations.
-| Code Alteration Required | Not Required |
-|-----------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
-| - Change personas
- Customize UI Theme
- Add or modify features | - Setting API keys in [environment variables](environment-variables.md)
- Toggle some dynamic features with environment variables |
+| Required Code Alteration | Not Required |
+|---------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------|
+| - Persona changes
- UI theme customization
- Feature additions or modifications | - Setting API keys in [environment variables](environment-variables.md)
- Toggling features with environment variables |
-When changes are needed/used:
+How:
-- **Code alterations**: on the source, before building the application
- - **Authentication**: requires a code alteration (renaming a file) before starting the build, see [deploy-authentication.md](deploy-authentication.md)
-- **Environment variables**: after building the application on your local computers or deploying to the cloud, and before running it
+- **Code alterations**: Apply these to the source code before building the application.
+- **Environment variables**: Set these post-build on local machines or cloud deployment, before application launch.
-### Code Alterations
+
-Begin by forking the [big-AGI repository](https://github.com/enricoros/big-AGI). This will create a copy under your GitHub account, providing a personal workspace for your project.
+## Code changes
-Understand the Architecture: big-AGI is built using Next.js, leveraging React for the frontend and Node.js for the backend. Familiarize yourself with the project structure and the technologies used. This understanding is crucial for making meaningful modifications.
+Start by creating a fork of the [big-AGI repository](https://github.com/enricoros/big-AGI) on GitHub for a personal development space.
+Understand the Architecture: big-AGI uses Next.js, React for the front end, and Node.js (Next.js edge functions) for the back end.
-### Customize the Personas
+### Add authentication
-You can customize the personas by editing the `src/data.ts` file. This file contains the default personas used in the application. You can add new personas, remove existing ones, or modify the existing ones to fit your project's requirements.
+This necessitates a code change (file renaming) before build initiation, detailed in [deploy-authentication.md](deploy-authentication.md).
-- [ ] edit `src/data.ts` to change the default personas
+### Change the Personas
-## Customize the UI
+Edit the `src/data.ts` file to customize personas. This file houses the default personas. You can add, remove, or modify these to meet your project's needs.
-The UI can be customized to fit your project's theme, add new features, or remove existing ones that are not needed.
+- [ ] Modify `src/data.ts` to alter default personas.
-- [ ] edit `src/common/app.theme.ts` to change the theme: colors, spacing, looks of buttons, animations, etc.
-- [ ] edit `src/common/app.config.tsx` to change the name of the application
-- [ ] edit `src/common/app.nav.tsx` to change the navigation bar
+### Change the UI
+
+Adapt the UI to match your project's aesthetic, incorporate new features, or exclude unnecessary ones.
+
+- [ ] Adjust `src/common/app.theme.ts` for theme changes: colors, spacing, button appearance, animations, etc.
+- [ ] Modify `src/common/app.config.tsx` to alter the application's name.
+- [ ] Update `src/common/app.nav.tsx` to revise the navigation bar.
## Other: Add or Modify Features
-- **Integrate New APIs**: You can integrate additional APIs by adding new endpoints in the `pages/api` directory.
-- **Enhance Functionality**: Modify existing features or add new ones by editing the React components and the backend logic.
+- **Integrate New APIs**: Add new endpoints in the `pages/api` directory for additional API integrations.
+- **Enhance Functionality**: Edit React components and backend logic to modify existing features or introduce new ones.
## Testing & Deployment
-Ensure to thoroughly test your application, by means of local development (see the README.md for how to build locally, it's simple).
-Deploy your application using your preferred hosting service. big-AGI can be deployed on Vercel, Docker, or any platform that supports Node.js
-applications, and in particular platforms that support the "Edge Runtime" of NextJS.
+Test your application thoroughly using local development (refer to README.md for local build instructions). Deploy using your preferred hosting service. big-AGI supports deployment on platforms like Vercel, Docker, or any Node.js-compatible service, especially those supporting NextJS's "Edge Runtime."
-- see [deploy-cloudflare.md](deploy-cloudflare.md) for an example of deploying to Cloudflare Workers
-- see [deploy-docker.md](deploy-docker.md) for instructions and examples with Docker
+- Refer to [deploy-cloudflare.md](deploy-cloudflare.md) for Cloudflare Workers deployment.
+- See [deploy-docker.md](deploy-docker.md) for Docker deployment instructions and examples.
-## Share Your Project
+
-Once your variant is live, don't forget to share it with the community, and we will link to your project, for instance:
+## Community Projects - Share Your Project
+
+After deployment, share your project with the community. We will link to your project to help others discover and learn from your work.
| Project | Features | GitHub |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|
| 🚀 CoolAGI: Where AI meets Imagination
 | Code Interpreter, Vision, Mind maps, Web Searches, Advanced Data Analytics, Large Data Handling and more! | [nextgen-user/CoolAGI](https://github.com/nextgen-user/CoolAGI) |
| HL-GPT | Fully remodeled UI | [harlanlewis/nextjs-chatgpt-app](https://github.com/harlanlewis/nextjs-chatgpt-app) |
-If your project is public, please highlight your updates in the README.md and open a pull request to add your project to the list. This will help others discover your project and learn from your experience.
+For public projects, update your README.md with your modifications and submit a pull request to add your project to our list, aiding in its discovery.
+
+
## Best Practices
-- **Stay Updated**: Regularly merge updates from the original big-AGI repository to benefit from bug fixes and new features
-- **Keep It Open Source**: Consider keeping your derivative open source to encourage community contributions
-- **Engage with the Community**: Use platforms like GitHub, Discord, or Reddit to gather feedback, find collaborators, and showcase your project
+- **Stay Updated**: Frequently merge updates from the main big-AGI repository to incorporate bug fixes and new features.
+- **Keep It Open Source**: Consider maintaining your derivative as open source to foster community contributions.
+- **Engage with the Community**: Leverage platforms like GitHub, Discord, or Reddit for feedback, collaboration, and project promotion.
----
-
-Creating a derivative application is not just about adding new features; it's about reimagining what's possible with AI and sharing it with the world.
-We can't wait to see what you build!
\ No newline at end of file
+Developing a derivative application is an opportunity to explore new possibilities with AI and share your innovations with the global community. We look forward to seeing your contributions.
\ No newline at end of file