Skip to content

docs: Refine Framework Quickstart guide with streamlined steps, clearer instructions, and screenshots#596

Merged
ramedina86 merged 2 commits intowriter:devfrom
ajot:dev
Oct 23, 2024
Merged

docs: Refine Framework Quickstart guide with streamlined steps, clearer instructions, and screenshots#596
ramedina86 merged 2 commits intowriter:devfrom
ajot:dev

Conversation

@ajot
Copy link
Contributor

@ajot ajot commented Oct 14, 2024

  • Added overview and conclusion to provide context and next steps
  • Expanded editor instructions with hands-on steps for adding components, adjusting settings, and updating the app name
  • Updated app creation command for clarity, with a breakdown of key project files
  • Simplified port info and security tips for running the editor and app
  • Added screenshots for visual guidance through the editor and app preview
  • Removed module-based app running to keep the guide beginner-friendly

… and screenshots

- Added overview and conclusion to provide context and next steps
- Expanded editor instructions with hands-on steps for adding components, adjusting settings, and updating the app name
- Updated app creation command for clarity, with a breakdown of key project files
- Simplified port info and security tips for running the editor and app
- Added screenshots for visual guidance through the editor and app preview
- Removed module-based app running to keep the guide beginner-friendly
This command opens the Writer Framework editor in your browser, where you’ll see a live preview of your app. The editor interface includes a **component library** on the left, a **canvas** in the center for building layouts, and a **settings panel** on the right for customizing selected components.

<Info>
The editor starts by default on port 3006. If you launch multiple editors in parallel and do not specify a port, Writer Framework will automatically assign the next port until reaching the limit of 4099.
Copy link
Collaborator

Choose a reason for hiding this comment

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

This port range isn't correct, the original statement is

The editor starts by default on port 4005.

cc @FabienArcellier

Copy link
Collaborator

Choose a reason for hiding this comment

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

@ajot can we fix this? Happy to merge afterwards

Copy link
Contributor Author

@ajot ajot Oct 22, 2024

Choose a reason for hiding this comment

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

@ramedina86 Maybe I am missing something, but for me, the editor starts at port 3006 by default, and the app runs at port 3005. Is that incorrect?

cc/ @samjulien

Copy link
Contributor

@samjulien samjulien Oct 22, 2024

Choose a reason for hiding this comment

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

@ajot I believe this changed in the latest RC, you should see it when you test Workflows (right @ramedina86?)

I think this is one example of why we switched the docs to go from main instead of dev.

Copy link
Contributor

@FabienArcellier FabienArcellier Oct 23, 2024

Choose a reason for hiding this comment

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

The port policy has changed to allow the writer cli to find available port by itself : #567.

On release candidate for 0.8, the port for the run start at 3005, the port for editor start at 4005

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated: 5b76635

@ramedina86 ramedina86 changed the title Refine Framework Quickstart guide with streamlined steps, clearer instructions, and screenshots docs: Refine Framework Quickstart guide with streamlined steps, clearer instructions, and screenshots Oct 15, 2024
Updating the port information for editor.
@ramedina86 ramedina86 merged commit 8f2a888 into writer:dev Oct 23, 2024
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.

4 participants