windmill-labs / windmilldocs Goto Github PK

When creating a for loop in a Flow, rename "Iterator expression" to "Variable name from previous step to iterate over", or find a better name. It's important to transmit the information that it comes from the previous step, or inputs.

• Add Iterator expression doc in the reference
• Create a tooltip in the front with brief explanation and link to the doc

The testimonials are quotes from different users located in cards/boxes with the name of the author. I want each card to be backlinked to the source of testimonial. The card should hover in darker and the name of the author should take a unique color when hovering.

Hello,

On the Triggering Flows page, the link to "Trigger Flows from Webhooks" does not redirect anywhere.

Link to the page : https://www.windmill.dev/docs/getting_started/trigger_flows

The link that is not working : https://www.windmill.dev/docs/getting_started/trigger_flows#trigger-flows-from-webhooks

Might probably be : https://www.windmill.dev/docs/getting_started/trigger_flows#webhooks

Thanks

I'd like to contribute to this documentation, but I noted that there doesn't appear to be a stated licence for the content anywhere in the repository. Please consider releasing the documentation under free culture terms, using for instance the Creative Commons Attribution Share Alike 4.0 International licence. The Git log would suggest that you've accepted external contributions in the past, so you may be unable to unilaterally license this repository; in that case, you would have to obtain permission from their authors or revert the commits.

Problem

The top of the landing page is too crowded and overwhelming. We don't have metrics setup for CTAs and bounce rate to my knowledge (WIP), but I think this is hurting the page performance.

Fix

First screen/section

There are 3 CTAs. That's at least one too many.

• keep only Try Cloud App (main) and schedule a demo (secondary)
• move get started to menu bar (for users that want to read the docs first)
• add get started later in the flow if needed (post signup)

There's two text blocks that are overwhelming and distracting (green)

Keep one of them only. Input needed @rubenfiszel : what's the most asked question? "what is it that you do?" or "how different are you from list"

• remove the least important one (and potentially move it to another view when you scroll down)

** Distracting subtext(purple)**

This subtext is too much, and is adding to the feeling of crowdedness. Either remove all the green text, and keep this without the parenthesis. Or remove it.

• TBD

What can you build with Windmill?

• TBD, I'll propose some tweaks to make it more concise / striking

Whom is it for section

"write like you speak", suggest we keep it conversational

• whom -> who
• rewrite copy to make it more concise (max 3 sentences per target group)

Feature list section

"ALL-IN-ONE PLATFORM TO POWER YOUR ENTIRE BACKOFFICE"

• Everything should fit in one screen
• remove extraneous blocks
• remove extraneous enumeration of features "serverless runtime + autogenerated UI to share your app + flow builder + schedules + secrets + groups + permissions + OAuth integrations + ..."

How it works

"Turn scripts into shareable internal apps or complex workflows triggered by webhooks, a schedule, or watching for new events."

• add title to section
• make text more concise
• consider replacing confusing images with a small GIF
• needs to fit on a single screen

Replace all your sparely used niche tools: We cover every use-case and to any API

This section is not very useful. When users have scrolled here, if they didn't get the value prop, it's already game over.

• remove section

Architecture section

• remove section, move to docs (any strong feelings @rubenfiszel ?)

Audit logs

This feels superfluous, and is inconsistent with the rest of the page

• remove, and add to the feature list section (link to docs for details)

Setup goals for the main and secondary CTA.

Rethink the tutorials section with interactive Arcade-based use simulations.

https://github.com/windmill-labs/windmilldocs/blob/main/docs/advanced/1_self_host/index.md

"npm run install" should be "npm install"

Write a section in the doc about the newly added support for helm chart deployments, with example/reference chart in https://github.com/windmill-labs/windmill-helm-charts