Skip to content

Commit 996a129

Browse files
committed
docs: reorganize content structure and improve customization guides
- Move customization-related documents to a dedicated section - Rename 'taking ownership of packages' to 'hosting packages for customization' - Update guide references and improve clarity in customization instructions - Restructure document hierarchy to better reflect content categories
1 parent feea4e9 commit 996a129

File tree

5 files changed

+8
-8
lines changed

5 files changed

+8
-8
lines changed
File renamed without changes.

src/content/docs/architecture/taking-ownership-of-packages.mdx renamed to src/content/docs/customization/hosting-packages-for-customization.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: Taking Ownership of Packages
3-
description: A step-by-step guide to cloning, hosting, and managing the shared packages for customization.
2+
title: 'Hosting Packages for Customization'
3+
description: A step-by-step guide to creating your own version of the shared packages to enable modification.
44
---
55
import { Steps, Aside } from '@astrojs/starlight/components';
66

7-
To unlock the full power of the Flutter News App Toolkit and make it truly your own, you must take ownership of the shared packages. The applications (Mobile Client, Web Dashboard) are designed to be customized, but the deepest and most impactful changes—like altering data models or redesigning the UI theme—happen within the shared packages.
7+
To enable customization of the Flutter News App Toolkit, you must host your own version of the shared packages. The applications (Mobile Client, Web Dashboard) are designed to be customized, but the deepest and most impactful changes—like altering data models or redesigning the UI theme—happen within the shared packages.
88

9-
This guide will walk you through the essential, one-time process of moving a shared package from the original public repository into your own private repository.
9+
This guide will walk you through the essential process of creating a private copy of a shared package from the original public repository.
1010

1111
<Aside type="caution" title="Critical Step">
1212
This is the most important guide for customizing the toolkit. You must follow this process for **any shared package** you intend to modify.
1313
</Aside>
1414

15-
### Why You Must Host the Packages Yourself
15+
### Why You Must Host a Private Copy
1616

17-
- **To Enable Customization:** You cannot push changes to the original public repositories. To modify a package, you need your own version that you control.
17+
- **To Enable Modification:** You cannot push changes to the original public repositories. To modify a package, you need your own version that you control.
1818
- **For Privacy and Control:** Hosting the packages in your own private repositories ensures that your proprietary changes, business logic, and customizations remain confidential.
1919
- **To Manage Updates:** It gives you full control over when and how you pull in future updates from the original toolkit.
2020

@@ -69,6 +69,6 @@ Let's walk through the process using the `core` package as an example. You will
6969

7070
</Steps>
7171

72-
**Congratulations!** You have now successfully taken ownership of the `core` package. It is now hosted in your private repository, and you are free to make any modifications you need.
72+
You have now successfully created a private copy of the `core` package. It is now hosted in your private repository, ready for any modifications you need to make.
7373

74-
The next step is to tell your applications (Mobile Client, Web Dashboard) to use *your* version of the package instead of the original one. The next guide, [**Guide: Customizing the UI Theme**](/docs/architecture/03-guide-customizing-the-ui/), will walk you through this process in a practical, hands-on example.
74+
The next step is to tell your applications (Mobile Client, Web Dashboard) to use *your* version of the package instead of the original one. The next guide, [**Guide: Customizing the UI Theme**](/docs/customization/guide-customizing-the-ui/), will walk you through this process in a practical, hands-on example.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)