Skip to content
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

Refactor website to use Hugo and Docsy; Add a blog #202

Merged
merged 13 commits into from
Jun 27, 2024

Conversation

ricardozanini
Copy link
Member

@ricardozanini ricardozanini commented Jun 7, 2024

Many thanks for submitting your Pull Request ❤️!

What this PR does / why we need it:

Special notes for reviewers:
Still, work todo:

Additional information (if needed):

@ricardozanini ricardozanini requested a review from cdavernas June 7, 2024 18:29
Signed-off-by: Ricardo Zanini <[email protected]>
Signed-off-by: Ricardo Zanini <[email protected]>
@cdavernas
Copy link
Member

LGTM! Many thanks man ❤️

Signed-off-by: Ricardo Zanini <[email protected]>
Signed-off-by: Ricardo Zanini <[email protected]>
Signed-off-by: Ricardo Zanini <[email protected]>
Signed-off-by: Ricardo Zanini <[email protected]>
Signed-off-by: Ricardo Zanini <[email protected]>
@ricardozanini ricardozanini marked this pull request as ready for review June 14, 2024 20:52
@ricardozanini ricardozanini requested a review from tsurdilo as a code owner June 14, 2024 20:52
Copy link
Member

@cdavernas cdavernas left a comment

Choose a reason for hiding this comment

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

Aside from the ordering comment, I think we should re-add the sponsors section, both in the website and the spec.

Even though Neuroglia is for now the only sponsor of the project (and as part of the latter I'm therefore biased), it did sponsor the project, and should therefore clearly appear as such, which also might incentivise others to move in.

We should also add a "buy us a coffe" kind of button, on both website and spec. Donators should also be visibly and explicitly thanked for their donations, and be tracked somewhere in the repo. The money we obtain should be invested for marketing and communication purpose, in other to grow our user base and widen adoption for the further stage of SW in the CNCF.

content/en/_index.md Show resolved Hide resolved
content/en/_index.md Show resolved Hide resolved
@ricardozanini
Copy link
Member Author

@cdavernas can you take another review?

Copy link
Member

@cdavernas cdavernas left a comment

Choose a reason for hiding this comment

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

Looks great to me, many thanks!
Do you think you could display the other key features on the index, and provide small code snippets, like now?

@ricardozanini
Copy link
Member Author

ricardozanini commented Jun 17, 2024

Looks great to me, many thanks! Do you think you could display the other key features on the index, and provide small code snippets, like now?

I would need help with HTML + js to be able to use this: https://www.docsy.dev/docs/adding-content/shortcodes/#tabbed-panes

It appears, but breaks the page. I think it's not meant to be used on the landing page. So maybe @JBBianchi could help in a future PR? I will take a lot of time to do it, which I don't have atm.

What other key features you mean?

@JBBianchi
Copy link
Member

Looks great to me, many thanks! Do you think you could display the other key features on the index, and provide small code snippets, like now?

I would need help with HTML + js to be able to use this: https://www.docsy.dev/docs/adding-content/shortcodes/#tabbed-panes

It appears, but breaks the page. I think it's not meant to be used on the landing page. So maybe @JBBianchi could help in a future PR? I will take a lot of time to do it, which I don't have atm.

What other key features you mean?

Sure, we can have a look together.

@cdavernas
Copy link
Member

What other key features you mean?

image

We have a lot more of those in the Readme:

  • Easy to Use: Designed for universal understanding, Serverless Workflow DSL enables users to quickly grasp workflow concepts and create complex workflows effortlessly.
  • Event Driven: Seamlessly integrate events into workflows with support for various formats, including CloudEvents, allowing for event-driven workflow architectures.
  • Service Oriented: The Serverless Workflow DSL empowers developers to seamlessly integrate with service-oriented architectures, allowing them to define workflows that interact with various services over standard application protocols like HTTP, GRPC, OpenAPI, AxsyncAPI, and more.
  • FaaS Centric: Seamlessly invoke functions hosted on various platforms within workflows, promoting a function-as-a-service (FaaS) paradigm and enabling microservices architectures.
  • Timely: Define timeouts for workflows and tasks to manage execution duration effectively.
  • Fault Tolerant: Easily define error handling strategies to manage and recover from errors that may occur during workflow execution, ensuring robustness and reliability.
  • Schedulable: Schedule workflows using CRON expressions or trigger them based on events, providing control over workflow execution timing.
  • Interoperable: Integrates seamlessly with different services and resources.
  • Robust: Offers features such as conditional branching, event handling, and looping constructs.
  • Scalable: Promotes code reusability, maintainability, and scalability across different environments.

And possibly even others worth mentioning...

@ricardozanini
Copy link
Member Author

@cdavernas sure we can add them all, but don't you think it will get cluttered? Maybe 3 more to have an additional line?

@cdavernas
Copy link
Member

@ricardozanini Yeah, you are right. Maybe 3 more indeed

@ricardozanini
Copy link
Member Author

@cdavernas I'll let you pick the other 3. 😛

@cdavernas
Copy link
Member

Let's pick the 6 first, no? They feel like the most compelling to me.

@ricardozanini
Copy link
Member Author

@cdavernas if you're happy with the content now, feel free to merge :)

@ricardozanini
Copy link
Member Author

@JBBianchi @cdavernas btw I created an issue to track the code section: #203

Signed-off-by: Ricardo Zanini <[email protected]>
@ricardozanini
Copy link
Member Author

@cdavernas one last thing: I've added the schema to the schemas section with both YAML and JSON versions. 👍

Signed-off-by: Ricardo Zanini <[email protected]>
@ricardozanini ricardozanini merged commit 8f2ed07 into serverlessworkflow:main Jun 27, 2024
5 checks passed
@ricardozanini ricardozanini deleted the issue-199 branch June 27, 2024 12:07
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.

Create Blog Refactor Website Website does not have the correct trademark disclaimer
3 participants