Painless Open Source Documentation with Docusaurus

•

1 gostou•1,551 visualizações

The document discusses Docusaurus, an open source documentation website generator. It summarizes that Docusaurus makes documentation easy by allowing users to write docs in Markdown and generate static HTML files. It also supports features like search, localization, versioning and customization through React extensions. The document demonstrates how large open source projects like React Native and Babel use Docusaurus for their documentation. It previews upcoming changes in Docusaurus 2 that will improve extensibility. The goal of Docusaurus is to encourage open source maintainers to prioritize documentation.

Tecnologia

Painless Open Source Documentation
with Docusaurus
Yangshun Tay | Front End Engineer

Docusaurus
Yangshun Tay, Front End
Engineer
Getting to Know You
• How many of you are project maintainers?
• How many of you have a website for your project?
• How many of you built your own website?
• How many of you built your own website but thought it was very time
consuming?

Wait! You are going to talk about
documentation?!?

Docusaurus
Yangshun Tay, Front End
Engineer
What?! Documentation?!

Docusaurus
Yangshun Tay, Front End
Engineer
Documentation Helps Success?
• 17 of the top 20 (85%) most followed GitHub projects have a
website
• 3 more are documentation repos via README.md
• The 17th project (create-react-app) just created a website

Docusaurus
Yangshun Tay, Front End
Engineer
create-react-app (~58,000 stars)

Docusaurus
Yangshun Tay, Front End
Engineer
Documentation helps provide a better
user experience for your project

Docusaurus
Yangshun Tay, Front End
Engineer
Documentation Helps Success?
• Isn't creating a website time consuming?
• Isn't writing documentation hard?
• Isn't it hard to add useful features?
Slash says "No!"

Docusaurus
Yangshun Tay, Front End
Engineer

Docusaurus
Yangshun Tay, Front End
Engineer
Save time and focus on your project's documentation. Simply
write docs and blog posts with Markdown and Docusaurus
will generate a set of static html ﬁles ready to be served.

Docusaurus
Yangshun Tay, Front End
Engineer
Make it easy for your community to ﬁnd what they need in
your documentation. We proudly support Algolia
documentation search.

Docusaurus
Yangshun Tay, Front End
Engineer
Localization comes pre-conﬁgured. Use Crowdin to
translate your docs into over 70 languages.

Docusaurus
Yangshun Tay, Front End
Engineer
Change the look and feel of your project pages by using
React. Docusaurus can be extended while reusing the same
header and footer.

Docusaurus
Yangshun Tay, Front End
Engineer
Support users on all versions of your project.
Document versioning helps you keep documentation in sync
with project releases.

Docusaurus
Yangshun Tay, Front End
Engineer
Docusaurus by the Numbers
• Started on Jun 2017
• Launched on Dec 14 2017
• 1000+ projects using
• 9249 stars

Docusaurus
Yangshun Tay, Front End
Engineer
https://docusaurus.io/blog/2018/04/30/How-I-Converted-Proﬁlo-To-Docusaurus

Docusaurus
Yangshun Tay, Front End
Engineer
https://docusaurus.io/users

Docusaurus
Yangshun Tay, Front End
Engineer
React Native (~70,000 stars)

Docusaurus
Yangshun Tay, Front End
Engineer
Babel (~30,000 stars)

Docusaurus
Yangshun Tay, Front End
Engineer
Prettier (~28,000 stars)

Docusaurus
Yangshun Tay, Front End
Engineer
Jest (~21,000 stars)

Docusaurus
Yangshun Tay, Front End
Engineer
Reason (~6,500 stars)

Docusaurus
Yangshun Tay, Front End
Engineer
Docusaurus is not perfect

Docusaurus
Yangshun Tay, Front End
Engineer
https://docusaurus.io/blog/2018/09/11/Towards-Docusaurus-2

Docusaurus
Yangshun Tay, Front End
Engineer
V1 (Website) V2 (Single Page App)
Rendering Purely server side
Server side (initial load)
Client side (subsequent page transitions)
Versioning Diff-based approach Snapshot-based approach
Styles
Traditional CSS
Lives in vendor land
CSS Modules / Sass
Lives in user land
Layout Fixed Customizable
Themes No Yes! Via CSS variables (?)
Routing Express React Router + SSR
Bundling Custom scripts Webpack

Docusaurus
Yangshun Tay, Front End
Engineer
We just want open source project owners to consider
documentation as ﬁrst-class component to their project

Docusaurus
Yangshun Tay, Front End
Engineer
What did we learn?
• Docusaurus makes it really simple to create a website
• v1 provides common features out of the box
• v2 will have the best qualities of v1 but even more extensible
• Docusaurus is building a community of small and large sites
alike
Docs can be fun!

Docusaurus
Yangshun Tay, Front End
Engineer
Docusaurus Maintainers
Yangshun Tay Joel Marcey Endilie Yacop Sucipto
@JoelMarcey
JoelMarcey
@endiliey@yangshunz
yangshun endiliey

Docusaurus
Yangshun Tay, Front End
Engineer
Project Information
Slash
@docusaurus
facebook/docusaurus
#docusaurus-users
#docusaurus-dev

Docusaurus
Yangshun Tay, Front End
Engineer
Thank you!

Mais conteúdo relacionado

Mais procurados

慈濟大學／FHIR 快速掃描／DSTU3 版本

Lorex L. Yang

Building beautiful apps using google flutter

Ahmed Abu Eldahab

Animations in Flutter

Bartosz Kosarzycki

How native is React Native? | React Native vs Native App Development

Devathon

サーバーサイド Kotlin のテストフレームワーク事情

Shinya Mochida

This DevOps Tutorial on what is Git & what is GitHub ( Git Blog series: https://goo.gl/XS1Vux ) will let you know all about Version Control System & Version Control Tools like Git. You will learn all the Git commands to create repositories on your local machine & GitHub, commit changes, push & pull files. Also you will get your hands on with some advanced operations in Git like branching, merging, rebasing etc. Below are the topics covered in this tutorial: 1. Version Control Introduction 2. Why version Control? 3. Version Control Tools 4. Git & GitHub 5. Case Study: Dominion enterprises 6. What is Git? 7. Features of Git 8. What is a Repository? 9. Git Operations and Commands

What is Git | What is GitHub | Git Tutorial | GitHub Tutorial | Devops Tutori...

Edureka!

Introduction to Flutter.pptx

DiffouoFopaEsdras

Every day Netflix streams 125 million hours of video to 80 million subscribers in 130 countries. Delivering new features daily at a global scale requires an engineering-oriented culture that moves fast and innovates faster. The developer tools team at Netflix faces unique technical and cultural challenges deploying tools designed for a wide audience to teams with very specific needs. In this talk we’ll explore: The forces that drive a centralized team in a decentralized organization. The diverse needs of our very technical user base. The pace of innovation and the ever-constant need for change. The complexities of support and automation that facilitates the process. Products covered: Bitbucket

DevTools at Netflix: Culture, Speed & Innovation

Atlassian

Mobile Application Penetration Testing Giordano Giammaria

Giammaria Giordano

SmartChat WhatsApp-clone using AWS Amplify AppSync

Thanh Nguyen

KeycloakでFAPIに対応した高セキュリティなAPIを公開する

Hitachi, Ltd. OSS Solution Center.

GitLabをバックアップしてみた

VirtualTech Japan Inc./Begi.net Inc.

Flutter state management from zero to hero

Ahmed Abu Eldahab

インフラ野郎Azureチーム Night

Toru Makabe

In this workshop, you will learn how to build a SwiftUI application with Firebase. We will cover the following topics: - Data modeling for Firestore - Efficiently mapping Firestore data using Swift’s Codable protocol - Fetching data from Firestore using snapshot listeners - Connecting SwiftUI’s state management system to Firestore to implement real-time sync - Securing your user’s data using Firebase Security Rules - Signing in your users using Firebase Authentication We will be using the latest versions of Firebase and SwiftUI, making use of Combine and async/await to demonstrate how to call asynchronous APIs using modern Swift technologies. Please bring your laptop, making sure to install the latest stable version of Xcode before the workshop.

Firebase & SwiftUI Workshop

Peter Friese

コンテナ＆サーバーレス：トレンドの考察と少し先の未来の展望

Yoichi Kawasaki

PHPUnit 4.0で追加されたwillReturn*()の紹介

Takaaki Hirano

Continuous Delivery with Jenkins

Jadson Santos

Code Security with GitHub Advanced Security

Luis Fraile

WESEEK Tech Conferenceは、株式会社WESEEKが主催するエンジニア向けの勉強会です。月に2回ほど、WESEEKに所属するエンジニアが様々なテーマで発表を行う予定です。第12回のタイトルは「既存RailsアプリをSSO化して、本番環境で活用した話」既存の Rails アプリを OpenID Connect に対応させ、弊社と取引があるインターネットマルチフィード様のポータルサイトに導入するまでの経緯を紹介します。また、OpenID Connect 基盤を活用した複数のバックエンドやサイトで認証、認可を統一した事例もあわせてお話しします。発表は二部構成となっております。業務のコアを担う既存の Rails アプリの認証基盤を OSS である Hydra を用いて OpenID Connect に対応させた話 OpenID Connect 認証基盤を元に、Istio、Envoy、OPA (Open Policy Agent) などを用いて認証、認可を統一した話

既存RailsアプリをSSO化して、本番環境で活用した話【WESEEK Tech Conf #12】

WESEEKWESEEK

Mais procurados (20)

慈濟大學／FHIR 快速掃描／DSTU3 版本

Building beautiful apps using google flutter

Animations in Flutter

How native is React Native? | React Native vs Native App Development

サーバーサイド Kotlin のテストフレームワーク事情

What is Git | What is GitHub | Git Tutorial | GitHub Tutorial | Devops Tutori...

Introduction to Flutter.pptx

DevTools at Netflix: Culture, Speed & Innovation

Mobile Application Penetration Testing Giordano Giammaria

SmartChat WhatsApp-clone using AWS Amplify AppSync

KeycloakでFAPIに対応した高セキュリティなAPIを公開する

GitLabをバックアップしてみた

Flutter state management from zero to hero

インフラ野郎Azureチーム Night

Firebase & SwiftUI Workshop

コンテナ＆サーバーレス：トレンドの考察と少し先の未来の展望

PHPUnit 4.0で追加されたwillReturn*()の紹介

Continuous Delivery with Jenkins

Code Security with GitHub Advanced Security

既存RailsアプリをSSO化して、本番環境で活用した話【WESEEK Tech Conf #12】

Semelhante a Painless Open Source Documentation with Docusaurus

Learn more about how we are evolving our open source. In our evolution we’ll discuss how we are approaching project lifecycles, metrics we are tracking that give us insight into the health of our key projects, and how we are working to make this clear to the communities involved with our projects. Also, we will discuss one of most recent key open source releases – Spinnaker (http://spinnaker.io/). Spinnaker is an open source, multi-cloud continuous delivery platform for releasing software changes with high velocity and confidence. Spinnaker powers thousands of deployments per day across the Netflix service.

Netflix Open Source Meetup Season 4 Episode 1

aspyker

OWASP Developer Guide Reboot

Andrew van der Stock

Code the docs-yu liu

StreamNative

A design system can vastly improve your team's productivity, but most of all, it leads to better products! The challenge lies in creating a mature system and leading its adoption across the company successfully. Let's talk about how we learned to meet the needs of different designers and developers on different products, on different tech stacks, on different platforms. Attendees will go home with tips they can use to improve design systems of any stage.

Design Systems at Scale

Sarah Federman

CloudStack Hyderabad Meetup: How the Apache community works

CloudStack - Open Source Cloud Computing Project

StackEngine Problem Space Demo

Boyd Hemphill

Hot Topics: The DuraSpace Community Webinar Series, “Introducing DSpace 7: Next Generation UI” Curated by Claire Knowles, Library Digital Development Manager, The University of Edinburgh. “How to contribute to DSpace –be a part of the team!” March 15, 2017 presented by: Claire Knowles - The University of Edinburgh, Maureen Walsh – The Ohio State University, Bram Luyten – Atmire, Hardy Pottinger – UCLA Library & Kim Shepherd - DSpace Developer and Committer

3.15.17 DSpace: How to Contribute Webinar Slides

DuraSpace

How Open Source / Open Technology Could Help On Your Project

Wan Leung Wong

From devoops to devops

Kris Buytaert

AppSec Pipelines and Event based Security

Matt Tesauro

DockerCon EU 2015: Day 1 General Session

Docker, Inc.

Untangling - fall2017 - week 9

Derek Jacoby

Everyone wants (someone else) to do it: writing documentation for open source...

Jody Garnett

Software Architecture and Predictive Models in R

Harlan Harris

In this deck from the hpc-ch forum on Cloud and Containers, Sergio Maffioletti from the University of Zurich presents: Towards Reproducible Data Analysis Using Cloud and Container Technologies. "Reproducing published experiments or extending existing data analysis pipelines is a challenge that is becoming increasingly prevalent in the wider research community. In this talk, an overview of the challenges faced by both research infrastructure providers and Science IT units are presented, along with best practices to improve the reproducibility of data analysis using cloud and container technologies." Watch the video: https://wp.me/p3RLHQ-kjB Learn more: https://www.hpc-ch.org/hpc-ch-forum-on-cloud-and-containers-highlights/ Sign up for our insideHPC Newsletter: http://insidehpc.com/newsletter

Towards Reproducible Data Analysis Using Cloud and Container Technologies

inside-BigData.com

Angular From The Trenches - 10 Lessons

Duncan Hunter

Why Developers Dig DevOps

BMC_DSM

My Futuristic Vision of the Future of Cassandra's Future - NGCC 2015

gdusbabek

Value streammapping cascadiait2014-mceniry

Chris McEniry

The Power of Azure DevOps

Jeff Bramwell

Semelhante a Painless Open Source Documentation with Docusaurus (20)

Netflix Open Source Meetup Season 4 Episode 1

OWASP Developer Guide Reboot

Code the docs-yu liu

Design Systems at Scale

CloudStack Hyderabad Meetup: How the Apache community works

StackEngine Problem Space Demo

3.15.17 DSpace: How to Contribute Webinar Slides

How Open Source / Open Technology Could Help On Your Project

From devoops to devops

AppSec Pipelines and Event based Security

DockerCon EU 2015: Day 1 General Session

Untangling - fall2017 - week 9

Everyone wants (someone else) to do it: writing documentation for open source...

Software Architecture and Predictive Models in R

Towards Reproducible Data Analysis Using Cloud and Container Technologies

Angular From The Trenches - 10 Lessons

Why Developers Dig DevOps

My Futuristic Vision of the Future of Cassandra's Future - NGCC 2015

Value streammapping cascadiait2014-mceniry

The Power of Azure DevOps

Mais de All Things Open

Presented at the ATO RTP Meetup Presented by Jeremy Proffit, Director of DevSecOps & SRE for Customer Care and Communications, Ally Title: Building Reliability - The Realities of Observability Abstract: Join me as we discuss true observability, learn what works and what doesn't. We'll not only discuss dashboards, monitoring and alerting, but how these can be built by automation or included in your IAC modules. We'll talk about how to properly alert staff based on priority to keep your staff and yourself sane. And even discuss architecture and how it impacts reliably and why serverless isn't always the best at being reliable.

Building Reliability - The Realities of Observability

All Things Open

Presented at the ATO RTP Meetup Presented by Peter Zaitsev, Founder of Percona Title: Modern Database Best Practices Abstract: There are now more Database choices available for developers than ever before - there are general purpose databases and specialized databases, single node and distributed databases, Open Source, Proprietary databases and databases available exclusively in the cloud. In this presentation we will cover the best practices of choosing database(s) for your applications, best practices as it comes to application development as well as managing those databases to achieve best possible performance, security, availability at the lowest cost.

Modern Database Best Practices

All Things Open

All Things Open 2023 Presented at All Things Open 2023 Presented by Deb Bryant - Open Source Initiative, Patrick Masson - Apereo Foundation, Stephen Jacobs - Rochester Institute of Technology, Ruth Suehle - SAS, & Greg Wallace - FreeBSD Foundation Title: Open Source and Public Policy Abstract: New regulations in the software industry and adjacent areas such as AI, open science, open data, and open education are on the rise around the world. Cyber Security, societal impact of AI, data and privacy are paramount issues for legislators globally. At the same time, the COVID-19 pandemic drove collaborative development to unprecedented levels and took Open Source software, open research, open content and data from mainstream to main stage, creating tension between public benefit and citizen safety and security as legislators struggle to find a balance between open collaboration and protecting citizens. Historically, the open source software community and foundations supporting its work have not engaged in policy discussions. Moving forward, thoughtful development of these important public policies whilst not harming our complex ecosystems requires an understanding of how our ecosystem operates. Ensuring stakeholders without historic benefit of representation in those discussions becomes paramount to that end. Please join our open discussion with open policy stakeholders working constructively on current open policy topics. Our panelists will provide a view into how oss foundations and other open domain allies are now rising to this new challenge as well as seizing the opportunity to influence positive changes to the public’s benefit. Topics: Public Policy, Open Science, Open Education, current legislation in the US and EU, US interest in OSS sustainability, intro to the Open Policy Alliance Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Open Source and Public Policy

All Things Open

Presented at All Things Open 2023 Presented by Ashpak Shaikh & Lucy Shen - Intuit Title: Weaving Microservices into a Unified GraphQL Schema with graph-quilt Abstract: The magic of GraphQL is that it provides data access through a single endpoint—clean and easy. But as the number of GraphQL microservices your tech stack depends on starts to grow, that single-endpoint purpose becomes a new multi-endpoint problem. Ideally, we would have an orchestrator that could aggregate schemas from multiple microservices into a unified GraphQL schema and route the requests to the appropriate microservice. Enter graph-quilt, an open source Java library that provides recursive schema stitching and Apollo Federation style schema composition. In this talk, we’ll walk through our GraphQL journey and show you how to use graph-quilt to simplify your data orchestration needs. We will also share our open sourced reference implementation of a highly performant graph-quilt gateway currently being used in production here at Intuit, where we’ve had incredible success in scaling the gateway with 50+ microservices and 150+ clients. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Weaving Microservices into a Unified GraphQL Schema with graph-quilt - Ashpak...

All Things Open

Presented at All Things Open 2023 Presented by Phil Nash - Sonar Title: The State of Passwordless Auth on the Web Abstract: Can we get rid of passwords yet? They make for a poor user experience and users are notoriously bad with them. The advent of WebAuthn has brought a passwordless world closer, but where do we really stand? In this talk we'll explore the current user experience of WebAuthn and the requirements a user has to fulfil to authenticate without a password. We'll also explore the fallbacks and safeguards we can use to make the password experience better and more secure. By the end of the session you'll have a vision of how authentication could look in the future and a blueprint for how to build the best auth experience today. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

The State of Passwordless Auth on the Web - Phil Nash

All Things Open

Presented at All Things Open 2023 Presented by Phil Nash - Sonar Title: Total ReDoS: The dangers of regex in JavaScript Abstract: Regular expressions are complicated and can be hard to learn. On top of that, they can also be a security risk; writing the wrong pattern can open your application up to denial of service attacks. One token out of place and you invite in the dreaded ReDoS. But how can a regular expression cause this? In this talk we’ll track down the patterns that can cause this trouble, explain why they are an issue and propose ways to fix them now and avoid them in the future. Together we’ll demystify these powerful search patterns and keep your application safe from expressions that behave in a way that is anything but regular. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Total ReDoS: The dangers of regex in JavaScript

All Things Open

Presented at All Things Open 2023 Presented by Karl Mozurkewich - Storj Title: What Does Real World Mass Adoption of Decentralized Tech Look Like? Abstract: We delve into the transformative potential of decentralized technology. Beginning with a brief overview of the rise of centralization with the advent of the internet and the counter-shift marked by blockchain we explore the intrinsic characteristics of decentralized and distributed systems, such as trustless operations, peer-to-peer networks, and enterprise application scalability. Various sectors, including finance, supply chains, media and entertainment, data science and cloud infrastructure are on the brink of disruption. The societal implications are vast, with the potential for greater individual empowerment, a greener planet and more viable resource utilization, but concerns about data security persist. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

What Does Real World Mass Adoption of Decentralized Tech Look Like?

All Things Open

Presented at All Things Open 2023 Presented by Anastasia Lalamentik - Kaleido Title: How to Write & Deploy a Smart Contract Abstract: In this talk, Anastasia Lalamentik, Full Stack Engineer at Kaleido, will walk through how Ethereum smart contracts work and go over related concepts like gas fees, the Ethereum Virtual Machine (EVM), the block explorer, and the Solidity programming language. This is vital to anyone who wants to build a blockchain app and is a great introduction to blockchain technology for newcomers to the space. By the end of the talk, attendees will better understand how to: - Write a simple smart contract - Deploy their smart contract to an Ethereum test network through the latest tools like Hardhat and the MetaMask wallet - Test interactions with their deployed smart contract and ensure that everything is working properly Additionally, participants will get to interact with Anastasia's deployed smart contract at the end of the talk. Anastasia’s past talks have attracted and have been attended by a diverse group of participants with a range of experience in the space. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

How to Write & Deploy a Smart Contract

All Things Open

Presented at All Things Open 2023 Presented by Paul Brebner - Instaclustr (by Spot by NetApp) Title: Spinning Your Drones with Cadence Workflows, Apache Kafka and TensorFlow Abstract: In this talk we’ll build a Drone delivery application, and then use it to do some Machine Learning “on the fly”. In the 1st part of the talk, we'll build a real-time Drone Delivery demonstration application using a combination of two open-source technologies: Uber’s Cadence (for stateful, scheduled, long-running workflows), and Apache Kafka (for fast streaming data). With up to 2,000 (simulated) drones and deliveries in progress at once this application generates a vast flow of spatio-temporal data. In the 2nd part of the talk, we'll use this platform to explore Machine Learning (ML) over streaming and drifting Kafka data with TensorFlow to try and predict which shops will be busy in advance. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Spinning Your Drones with Cadence Workflows, Apache Kafka and TensorFlow

All Things Open

Presented at the All Things Open 2023 Inclusion and Diversity in Open Source Event Presented by Efraim Marquez-Arreaza - Red Hat Title: DEI Challenges and Success Abstract: In today's world, many companies and organizations have Diversity, Equity and Inclusion (DEI) communities. Red Hat Unidos is a DEI community focused on advocating for the Hispanic/Latine community. In this talk, we would like to share our challenges and success during the past 4-years and plans for the future. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

DEI Challenges and Success

All Things Open

Presented at All Things Open 2023 Presented by Lydia Cupery - HubSpot Title: Scaling Web Applications with Background Jobs: Takeaways from Generating a Huge PDF Abstract: Do you need to perform time-consuming or CPU-intensive processes in your web application but are concerned about performance? That’s where background jobs come in. By offloading resource-intensive tasks to separate worker processes, you can improve the scalability of your web application. In this talk, I'll share my experience of using background jobs to scale our web application. I'll discuss the challenges my team faced that led us to adopt background jobs. Then, I'll share practical tips on how to design background jobs for CPU-intensive or time-consuming processes, such as generating huge PDFs and batch emailing. I'll wrap up by going over the performance and cost tradeoffs of background jobs. I'll use Typescript, Express, and Heroku as examples in this talk, but the concepts and best practices that I'll share are applicable to other languages and tools. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Scaling Web Applications with Background

All Things Open

Presented at All Things Open 2023 Presented by Robert Aboukhalil - CZI Title: Supercharging tutorials with WebAssembly Abstract: sandbox.bio is a free platform that features interactive command-line tutorials for bioinformatics. This talk is a deep-dive into how sandbox.bio was built, with a focus on how WebAssembly enabled bringing command-line tools like awk and grep to the web. Although these tools were originally written in C/C++, they all run directly in the browser, thanks to WebAssembly! And since the computations run on each user's computer, this makes the application highly scalable and cost-effective. Along the way, I'll discuss how WebAssembly works and how to get started using it in your own applications. The talk will also cover more advanced WebAssembly features such as threads and SIMD, and will end with a discussion of WebAssembly's benefits and pitfalls (it's a powerful technology, but it's not always the right tool!). Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Supercharging tutorials with WebAssembly

All Things Open

Presented at All Things Open 2023 Presented by K.S. Bhaskar - YottaDB LLC Title: Using SQL to Find Needles in Haystacks Abstract: Database journal files capture every update to a database. A database of a few hundred GB can generate GBs worth of journal files every minute at busy times. Troubleshooting and forensices, especially of rare and intermittent problems, such as which process made what update and when, is an exercise of finding needles in haystacks. A similar problem exists with syslogs. A solution is to load the journal files and syslogs into a database, and use SQL to query the database. Bhaskar will present and demonstrate this with a 100% FOSS stack. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Using SQL to Find Needles in Haystacks

All Things Open

Presented at All Things Open 2023 Presented by Wes Widner - Automox Title: Configuration Security as a Game of Pursuit Intercept Abstract: In this session we will take a look at the emerging field of cloud security posture management and how we can approach the problem space using a class of board games known as pursuit/intercept. Using the game Scotland Yard as a visual illustration we'll explore the cognitive and technical limitations that all CSPM systems face and what you should look for when evaluating the strengths and weakness of CSPM vendors and approaches. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Configuration Security as a Game of Pursuit Intercept

All Things Open

Presented at All Things Open 2023 Presented by Carol Huang & Mike Fix - Stripe Title: Scaling an Open Source Sponsorship Program Abstract: We already know this: the open-source ecosystem needs further monetary investment from the companies that benefit most from it. Likewise, companies say they want to participate in these initiatives, but find it hard to dedicate resources to open source funding when there isn’t a clear ROI. This talk discusses how the Open Source Program Office at Stripe built a scalable, sustainable open source sponsorship model that aligns internal company incentives with those of open source maintainers and the community at large. We go over the unique “platformization” of our OSPO that allowed us to create multiple funding models, such as BYOB (Bring Your Own Budget), and share lessons learned from this experience as well as other OSPOs. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Scaling an Open Source Sponsorship Program

All Things Open

Presented at All Things Open 2023 Presented by Arundeep Nagaraj - Amazon Web Services (AWS) Title: Build Developer Experience Teams for Open Source Abstract: Open Source has become the default strategy for many IT organizations and Enterprises. However, the constant challenge with Open Source leaders of these organizations has been - How is my product's developer experience? Is this the right metric to track? How can I scale my team to support our products better? How can I add automation to scale redundant workflows? If my product involves working with developers, how can I scale to the complexity of the requests and reduce Engineering bandwidth? The challenges within support of open source products continues to magnify depending on the end user persona whether they are consumers or contributors to your product. Consumers utilize your product, SDK's and API's and are blocked with using it or run into issues, whereas contributors are advanced users of your software that understands the codebase to provide a meaningful contribution back to the product. The answer to the above is to look at Open Source support as a first-class citizen of your corporate support strategy. To employ the right level of developer focused support as opposed to traditional infrastructure based support is key to scale to the amount of developers using your product. Supporting customers in the open involves more than pure support - building customer / developer experiences (DX) in the open (across platforms and communities) that pivots over the ability of your product's users or developers to be focused on the end-to-end value add. This helps with your active developer growth and retention of users. Key Takeaways: - IT leaders of Open Source will learn to employ strategies to build a DX team that engages on multiple platforms - Work on identifying accurate metrics for product and organization - Innovate on platforms such as Discord to build a bot and a dashboard - Ability to leverage customer feedback and iterate over the customer success flywheel - Distinguish between DX and Developer Advocacy (DA) Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Build Developer Experience Teams for Open Source

All Things Open

Presented at All Things Open 2023 Presented by Danny McCormick - Google Title: Deploying Models at Scale with Apache Beam Abstract: Apache Beam is an open source tool for building distributed scalable data pipelines. This talk will explore how Beam can be used to perform common machine learning tasks, with a heavy focus on running inference at scale. The talk will include a demo component showing how Beam can be used to deploy and update models efficiently on both CPUs and GPUs for inference workloads. An attendee can expect to leave this talk with a high level understanding of Beam, the challenges of deploying models at scale, and the ability to use Beam to easily parallelize their inference workloads. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Deploying Models at Scale with Apache Beam

All Things Open

Presented at All Things Open 2023 Presented by Peter Czanik - One Identity Title: Sudo – Giving access while staying in control Abstract: Sudo is used by millions to control and log administrator access to systems, but using the default configuration only, there are plenty of blind spots. Using the latest features in sudo let you watch some previously blind spots and control access to them. Here are four major new features, which arrived since the 1.9.0 release, allowing you see your blind spots: - configuring a working directory or chroot within sudo often makes full shell access redundant - JSON-formatted logs give you more details on events and are easier to act on - relays in sudo_logsrvd make session recording collection more secure and reliable - you can log and control sub-commands executed by the command run through sudo Let us take a closer look at each of these. Previously, there were quite a few situations where you had to give users full shell access through sudo. Typical examples include when you need to run a command from a given directory, or running commands in a chroot environment. You can now configure the working directory or the chroot directory and give access only to the command the user really needs. Logging is a central role of sudo, to see who did what on the system. Using JSON-formatted log messages gives you even more information about events. What is even more: structured logs are easier to act on. Setting up alerting for suspicious events is much easier when you have a single parser to configure for any kind of sudo logs. You can collect sudo logs not only by local syslog, but also by using sudo_logsrvd, the same application used to collect session recordings. Speaking of session recordings: instead of using a single central server, you can now have multiple levels of sudo_logsrvd relays between the client and the final destination. This allows session collection even if the central server is unavailable, providing you with additional security. It also makes your network configuration simpler. Finally, you can log sub-commands executed from the command started through sudo. You can see commands started from a shell. No more unnoticed shell access from text editors. Best of all: you can also intercept sub-commands. These are just a few of the most prominent features helping you to watch and control previous blind spots on your systems. See these and other possibilities in action in some live demos during our presentation. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Sudo – Giving access while staying in control

All Things Open

Presented at All Things Open 2023 Presented by Christine Abernathy - F5, Inc. Title: Fortifying the Future: Tackling Security Challenges in AI/ML Applications Abstract: As Artificial Intelligence (AI) and Machine Learning (ML) applications continue to surge, it is crucial to be aware of and address the security risks associated with these technologies. In this talk, Christine will explore AI/ML failure modes, threats, and mitigation strategies. She will guide you through the fundamentals of ML models then introduce you to key security challenges such as adversarial attacks, data poisoning, model inversion, model stealing, and membership inference attacks, using real-world examples to demonstrate their potential impact. Christine will also discuss privacy and ethical considerations in ML, touching upon techniques like federated learning and shedding light on the current regulatory landscape surrounding security risks. If you are developing AI/ML applications or incorporating AI/ML components into your technology stack, check out this talk. You will walk away with a deeper understanding of the current AI/ML security landscape and a toolkit to help you address these risks, enabling you to build safer, more secure, and privacy-aware applications. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Fortifying the Future: Tackling Security Challenges in AI/ML Applications

All Things Open

Presented at All Things Open 2023 Presented by Carlos Santana - AWS Title: Securing Cloud Resources Deployed with Control Planes on Kubernetes using Governance and Policy as Code Abstract: Are you concerned about the security of your cloud resources deployed on Kubernetes? Are you struggling to ensure compliance with regulatory requirements while managing your cloud infrastructure? If yes, then this talk is for you! We will discuss how to secure cloud resources deployed with Crossplane on Kubernetes using Governance and Policy as Code. We will explore how to leverage Governance and Policy as Code tools like Rego, Kyverno, and OPA to ensure security and compliance. By the end of this talk, you will have a better understanding of the challenges associated with securing cloud resources deployed with Crossplane or ACK on Kubernetes, the importance of Governance and Policy as Code in ensuring security and compliance, and why it is critical to use open source and open standards in these technologies. Find more info about All Things Open: On the web: https://www.allthingsopen.org/ Twitter: https://twitter.com/AllThingsOpen LinkedIn: https://www.linkedin.com/company/all-things-open/ Instagram: https://www.instagram.com/allthingsopen/ Facebook: https://www.facebook.com/AllThingsOpen Mastodon: https://mastodon.social/@allthingsopen Threads: https://www.threads.net/@allthingsopen 2023 conference: https://2023.allthingsopen.org/

Securing Cloud Resources Deployed with Control Planes on Kubernetes using Gov...

All Things Open

Mais de All Things Open (20)

Building Reliability - The Realities of Observability

Modern Database Best Practices

Open Source and Public Policy

Weaving Microservices into a Unified GraphQL Schema with graph-quilt - Ashpak...

The State of Passwordless Auth on the Web - Phil Nash

Total ReDoS: The dangers of regex in JavaScript

What Does Real World Mass Adoption of Decentralized Tech Look Like?

How to Write & Deploy a Smart Contract

Spinning Your Drones with Cadence Workflows, Apache Kafka and TensorFlow

DEI Challenges and Success

Scaling Web Applications with Background

Supercharging tutorials with WebAssembly

Using SQL to Find Needles in Haystacks

Configuration Security as a Game of Pursuit Intercept

Scaling an Open Source Sponsorship Program

Build Developer Experience Teams for Open Source

Deploying Models at Scale with Apache Beam

Sudo – Giving access while staying in control

Fortifying the Future: Tackling Security Challenges in AI/ML Applications

Securing Cloud Resources Deployed with Control Planes on Kubernetes using Gov...

Último

Sidekick Solutions uses Bonterra Impact Management (fka Social Solutions Apricot) and automation solutions to integrate data for business workflows. We believe integration and automation are essential to user experience and the promise of efficient work through technology. Automation is the critical ingredient to realizing that full vision. We develop integration products and services for Bonterra Case Management software to support the deployment of automations for a variety of use cases. This video focuses on the deployment of external web forms using Jotform for Bonterra Impact Management. This solution can be customized to your organization’s needs and deployed to support the common use cases below: - Intake and consent - Assessments - Surveys - Applications - Program registration Interested in deploying web form automations for Bonterra Impact Management? Contact us at sales@sidekicksolutionsllc.com to discuss next steps.

Web Form Automation for Bonterra Impact Management (fka Social Solutions Apri...

Jeffrey Haguewood

Elevate Developer Efficiency & build GenAI Application with Amazon Q

Bhuvaneswari Subramani

Exploring Multimodal Embeddings with Milvus

Zilliz

[BuildWithAI] Introduction to Gemini.pdf

Sandro Moreira

Six Myths about Ontologies: The Basics of Formal Ontology

johnbeverley2021

Discover the innovative features and strategic vision that keep WSO2 an industry leader. Explore the exciting 2024 roadmap of WSO2 API management, showcasing innovations, unified APIM/APK control plane, natural language API interaction, and cloud native agility. Discover how open source solutions, microservices architecture, and cloud native technologies unlock seamless API management in today's dynamic landscapes. Leave with a clear blueprint to revolutionize your API journey and achieve industry success!

WSO2's API Vision: Unifying Control, Empowering Developers

WSO2

AWS Community Day CPH - Three problems of Terraform

Andrey Devyatkin

Angeliki Cooney has spent over twenty years at the forefront of the life sciences industry, working out of Wynantskill, NY. She is highly regarded for her dedication to advancing the development and accessibility of innovative treatments for chronic diseases, rare disorders, and cancer. Her professional journey has centered on strategic consulting for biopharmaceutical companies, facilitating digital transformation, enhancing omnichannel engagement, and refining strategic commercial practices. Angeliki's innovative contributions include pioneering several software-as-a-service (SaaS) products for the life sciences sector, earning her three patents. As the Senior Vice President of Life Sciences at Avenga, Angeliki orchestrated the firm's strategic entry into the U.S. market. Avenga, a renowned digital engineering and consulting firm, partners with significant entities in the pharmaceutical and biotechnology fields. Her leadership was instrumental in expanding Avenga's client base and establishing its presence in the competitive U.S. market.

Biography Of Angeliki Cooney | Senior Vice President Life Sciences | Albany, ...

Angeliki Cooney

The value of a flexible API Management solution for Open Banking Steve Melan, Manager for IT Innovation and Architecture - State's and Saving's Bank of Luxembourg Apidays New York 2024: The API Economy in the AI Era (April 30 & May 1, 2024) ------ Check out our conferences at https://www.apidays.global/ Do you want to sponsor or talk at one of our conferences? https://apidays.typeform.com/to/ILJeAaV8 Learn more on APIscene, the global media made by the community for the community: https://www.apiscene.io Explore the API ecosystem with the API Landscape: https://apilandscape.apiscene.io/

Apidays New York 2024 - The value of a flexible API Management solution for O...

apidays

ICT role in 21st century education and its challenges

rafiqahmad00786416

💉💊+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHABI}}+971581248768 +971581248768 Mtp-Kit (500MG) Prices » Dubai [(+971581248768**)] Abortion Pills For Sale In Dubai, UAE, Mifepristone and Misoprostol Tablets Available In Dubai, UAE CONTACT DR.Maya Whatsapp +971581248768 We Have Abortion Pills / Cytotec Tablets /Mifegest Kit Available in Dubai, Sharjah, Abudhabi, Ajman, Alain, Fujairah, Ras Al Khaimah, Umm Al Quwain, UAE, Buy cytotec in Dubai +971581248768''''Abortion Pills near me DUBAI | ABU DHABI|UAE. Price of Misoprostol, Cytotec” +971581248768' Dr.DEEM ''BUY ABORTION PILLS MIFEGEST KIT, MISOPROTONE, CYTOTEC PILLS IN DUBAI, ABU DHABI,UAE'' Contact me now via What's App…… abortion Pills Cytotec also available Oman Qatar Doha Saudi Arabia Bahrain Above all, Cytotec Abortion Pills are Available In Dubai / UAE, you will be very happy to do abortion in Dubai we are providing cytotec 200mg abortion pill in Dubai, UAE. Medication abortion offers an alternative to Surgical Abortion for women in the early weeks of pregnancy. We only offer abortion pills from 1 week-6 Months. We then advise you to use surgery if its beyond 6 months. Our Abu Dhabi, Ajman, Al Ain, Dubai, Fujairah, Ras Al Khaimah (RAK), Sharjah, Umm Al Quwain (UAQ) United Arab Emirates Abortion Clinic provides the safest and most advanced techniques for providing non-surgical, medical and surgical abortion methods for early through late second trimester, including the Abortion By Pill Procedure (RU 486, Mifeprex, Mifepristone, early options French Abortion Pill), Tamoxifen, Methotrexate and Cytotec (Misoprostol). The Abu Dhabi, United Arab Emirates Abortion Clinic performs Same Day Abortion Procedure using medications that are taken on the first day of the office visit and will cause the abortion to occur generally within 4 to 6 hours (as early as 30 minutes) for patients who are 3 to 12 weeks pregnant. When Mifepristone and Misoprostol are used, 50% of patients complete in 4 to 6 hours; 75% to 80% in 12 hours; and 90% in 24 hours. We use a regimen that allows for completion without the need for surgery 99% of the time. All advanced second trimester and late term pregnancies at our Tampa clinic (17 to 24 weeks or greater) can be completed within 24 hours or less 99% of the time without the need surgery. The procedure is completed with minimal to no complications. Our Women's Health Center located in Abu Dhabi, United Arab Emirates, uses the latest medications for medical abortions (RU-486, Mifeprex, Mifegyne, Mifepristone, early options French abortion pill), Methotrexate and Cytotec (Misoprostol). The safety standards of our Abu Dhabi, United Arab Emirates Abortion Doctors remain unparalleled. They consistently maintain the lowest complication rates throughout the nation. Our Physicians and staff are always available to answer questions and care for women in one of the most difficult times in their lives. The decision to have an abortion at the Abortion Cl

+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...

?#DUbAI#??##{{(☎️+971_581248768%)**%*]'#abortion pills for sale in dubai@

Passkeys: Developing APIs to enable passwordless authentication Cody Salas, Sr Developer Advocate | Solutions Architect - Yubico Apidays New York 2024: The API Economy in the AI Era (April 30 & May 1, 2024) ------ Check out our conferences at https://www.apidays.global/ Do you want to sponsor or talk at one of our conferences? https://apidays.typeform.com/to/ILJeAaV8 Learn more on APIscene, the global media made by the community for the community: https://www.apiscene.io Explore the API ecosystem with the API Landscape: https://apilandscape.apiscene.io/

Apidays New York 2024 - Passkeys: Developing APIs to enable passwordless auth...

apidays

CNIC Information System with Pakdata Cf In Pakistan

danishmna97

FWD Group - Insurer Innovation Award 2024

The Digital Insurer

Following the popularity of "Cloud Revolution: Exploring the New Wave of Serverless Spatial Data," we're thrilled to announce this much-anticipated encore webinar. In this sequel, we'll dive deeper into the Cloud-Native realm by uncovering practical applications and FME support for these new formats, including COGs, COPC, FlatGeoBuf, GeoParquet, STAC, and ZARR. Building on the foundation laid by industry leaders Michelle Roby of Radiant Earth and Chris Holmes of Planet in the first webinar, this second part offers an in-depth look at the real-world application and behind-the-scenes dynamics of these cutting-edge formats. We will spotlight specific use-cases and workflows, showcasing their efficiency and relevance in practical scenarios. Discover the vast possibilities each format holds, highlighted through detailed discussions and demonstrations. Our expert speakers will dissect the key aspects and provide critical takeaways for effective use, ensuring attendees leave with a thorough understanding of how to apply these formats in their own projects. Elevate your understanding of how FME supports these cutting-edge technologies, enhancing your ability to manage, share, and analyze spatial data. Whether you're building on knowledge from our initial session or are new to the serverless spatial data landscape, this webinar is your gateway to mastering cloud-native formats in your workflows.

Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME

Safe Software

The Good, the Bad and the Governed - Why is governance a dirty word? David O'Neill, Chief Operating Officer - APIContext Apidays New York 2024: The API Economy in the AI Era (April 30 & May 1, 2024) ------ Check out our conferences at https://www.apidays.global/ Do you want to sponsor or talk at one of our conferences? https://apidays.typeform.com/to/ILJeAaV8 Learn more on APIscene, the global media made by the community for the community: https://www.apiscene.io Explore the API ecosystem with the API Landscape: https://apilandscape.apiscene.io/

Apidays New York 2024 - The Good, the Bad and the Governed by David O'Neill, ...

apidays

How to Troubleshoot Apps for the Modern Connected Worker

ThousandEyes

EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER

MadyBayot

Strategies for Landing an Oracle DBA Job as a Fresher

Remote DBA Services

The microservices honeymoon is over. When starting a new project or revamping a legacy monolith, teams started looking for alternatives to microservices. The Modular Monolith, or 'Modulith', is an architecture that reaps the benefits of (vertical) functional decoupling without the high costs associated with separate deployments. This talk will delve into the advantages and challenges of this progressive architecture, beginning with exploring the concept of a 'module', its internal structure, public API, and inter-module communication patterns. Supported by spring-modulith, the talk provides practical guidance on addressing the main challenges of a Modultith Architecture: finding and guarding module boundaries, data decoupling, and integration module-testing. You should not miss this talk if you are a software architect or tech lead seeking practical, scalable solutions. About the author With two decades of experience, Victor is a Java Champion working as a trainer for top companies in Europe. Five thousands developers in 120 companies attended his workshops, so he gets to debate every week the challenges that various projects struggle with. In return, Victor summarizes key points from these workshops in conference talks and online meetups for the European Software Crafters, the world’s largest developer community around architecture, refactoring, and testing. Discover how Victor can help you on victorrentea.ro : company training catalog, consultancy and YouTube playlists.

Modular Monolith - a Practical Alternative to Microservices @ Devoxx UK 2024

Victor Rentea

Painless Open Source Documentation with Docusaurus

1. Painless Open Source Documentation with Docusaurus Yangshun Tay | Front End Engineer

2. Docusaurus Yangshun Tay, Front End Engineer Getting to Know You • How many of you are project maintainers? • How many of you have a website for your project? • How many of you built your own website? • How many of you built your own website but thought it was very time consuming?

3. Wait! You are going to talk about documentation?!?

4. Docusaurus Yangshun Tay, Front End Engineer What?! Documentation?!

5. Interstitial (Standard)

6. Docusaurus Yangshun Tay, Front End Engineer Documentation Helps Success? • 17 of the top 20 (85%) most followed GitHub projects have a website • 3 more are documentation repos via README.md • The 17th project (create-react-app) just created a website

7. Docusaurus Yangshun Tay, Front End Engineer create-react-app (~58,000 stars)

8. Docusaurus Yangshun Tay, Front End Engineer Documentation helps provide a better user experience for your project

9. Docusaurus Yangshun Tay, Front End Engineer Documentation Helps Success? • Isn't creating a website time consuming? • Isn't writing documentation hard? • Isn't it hard to add useful features? Slash says "No!"

10.

11. Docusaurus

12. Docusaurus Yangshun Tay, Front End Engineer

13. Docusaurus Yangshun Tay, Front End Engineer Save time and focus on your project's documentation. Simply write docs and blog posts with Markdown and Docusaurus will generate a set of static html ﬁles ready to be served.

14. Docusaurus Yangshun Tay, Front End Engineer Make it easy for your community to ﬁnd what they need in your documentation. We proudly support Algolia documentation search.

15. Docusaurus Yangshun Tay, Front End Engineer Localization comes pre-conﬁgured. Use Crowdin to translate your docs into over 70 languages.

16. Docusaurus Yangshun Tay, Front End Engineer Change the look and feel of your project pages by using React. Docusaurus can be extended while reusing the same header and footer.

17. Docusaurus Yangshun Tay, Front End Engineer Support users on all versions of your project. Document versioning helps you keep documentation in sync with project releases.

18. Docusaurus Yangshun Tay, Front End Engineer Docusaurus by the Numbers • Started on Jun 2017 • Launched on Dec 14 2017 • 1000+ projects using • 9249 stars

19. Demo

20. Docusaurus Yangshun Tay, Front End Engineer https://docusaurus.io/blog/2018/04/30/How-I-Converted-Proﬁlo-To-Docusaurus

21. Large Community

22. Docusaurus Yangshun Tay, Front End Engineer https://docusaurus.io/users

23. Docusaurus Yangshun Tay, Front End Engineer React Native (~70,000 stars)

24. Docusaurus Yangshun Tay, Front End Engineer Babel (~30,000 stars)

25. Docusaurus Yangshun Tay, Front End Engineer Prettier (~28,000 stars)

26. Docusaurus Yangshun Tay, Front End Engineer Jest (~21,000 stars)

27. Docusaurus Yangshun Tay, Front End Engineer Reason (~6,500 stars)

28. Critical Feedback

29. Docusaurus Yangshun Tay, Front End Engineer Docusaurus is not perfect

30. Docusaurus Yangshun Tay, Front End Engineer

31. We are listening!

32. Docusaurus 2

33. Docusaurus Yangshun Tay, Front End Engineer https://docusaurus.io/blog/2018/09/11/Towards-Docusaurus-2

34. Demo Again!

35. v1 vs v2

36. Docusaurus Yangshun Tay, Front End Engineer V1 (Website) V2 (Single Page App) Rendering Purely server side Server side (initial load) Client side (subsequent page transitions) Versioning Diff-based approach Snapshot-based approach Styles Traditional CSS Lives in vendor land CSS Modules / Sass Lives in user land Layout Fixed Customizable Themes No Yes! Via CSS variables (?) Routing Express React Router + SSR Bundling Custom scripts Webpack

37. Alternatives

38. Docusaurus Yangshun Tay, Front End Engineer

39. Docusaurus Yangshun Tay, Front End Engineer We just want open source project owners to consider documentation as ﬁrst-class component to their project

40. Takeaways

41. Docusaurus Yangshun Tay, Front End Engineer What did we learn? • Docusaurus makes it really simple to create a website • v1 provides common features out of the box • v2 will have the best qualities of v1 but even more extensible • Docusaurus is building a community of small and large sites alike Docs can be fun!

42. Docusaurus Yangshun Tay, Front End Engineer Docusaurus Maintainers Yangshun Tay Joel Marcey Endilie Yacop Sucipto @JoelMarcey JoelMarcey @endiliey@yangshunz yangshun endiliey

43. Docusaurus Yangshun Tay, Front End Engineer Project Information Slash @docusaurus facebook/docusaurus #docusaurus-users #docusaurus-dev

44. Docusaurus Yangshun Tay, Front End Engineer Thank you!

45. Q & A

Painless Open Source Documentation with Docusaurus

Recomendados

Recomendados

Mais conteúdo relacionado

Mais procurados

Mais procurados (20)

Semelhante a Painless Open Source Documentation with Docusaurus

Semelhante a Painless Open Source Documentation with Docusaurus (20)

Mais de All Things Open

Mais de All Things Open (20)

Último

Último (20)

Painless Open Source Documentation with Docusaurus