Writing Design Docs for Wide Audiences

•

0 gostou•96 visualizações

What would you do to convince a large audience, who has little context, to use your solution to a problem? One way is to write a design document, which helps scale technical communication and build alignment among stakeholders. The wider the scope of the problem, the more important alignment is. A design document achieves this by addressing three key questions: “what is the goal?”, “how will we achieve it?” and “why are we doing it this way?”. This talk will cover identifying your audience, effectively writing answers to these questions, and involving the right people at the right time.

Software

@micheletitolo
•Details what you plan to build

•Future looking

•Has sections or a template
What Is A Design Doc

@micheletitolo
•Communication

•Collaboration

•Building alignment

•Thoroughness
Purpose Of Design Docs

@micheletitolo
•Socialize designs

•Leverage experiences of others

•Reduce surprises
Bene
fi
ts

@micheletitolo
•Design docs reference PRDs

•Di
ff
erent purposes
PRDs and Design Docs

@micheletitolo
•Projects with non-obvious or new components

•Cross-team or cross-function

•During planning, before implementation

•Aid in breaking down the project
When Do You

Write A Design Doc

@micheletitolo
•Prototype before or while writing the design doc

•Inform design

•Turn unknown unknowns to known unknowns

•Timebox or constrain prototype

•Link to notes
Prototyping

@micheletitolo
•Collaborative editor

•Single place of truth

•Single place of discussion
Where Do You Write

A Design Doc

@micheletitolo
Vertical, Horizontal, Both

@micheletitolo
•Who will this impact?

•Who will integrate?

•Who will ultimately use?

•Do you have other stakeholders?
Research

@micheletitolo
•Reviewers

•Audience

•Background

•Goals and Non-Goals

•Architecture or Design
De
fi
ne The Sections

@micheletitolo
No PRD? Write
Requirements In A Section

@micheletitolo
•History and context

•Constraints or challenges
Writing The Background

@micheletitolo
•Set scope of the doc

•Use cases and non use cases

•Articulate technical requirements
Goals And Non-Goals

@micheletitolo
•Describe what you plan to build

•Choose the right level of detail

•Room for surprises

•Tradeo
ff
s
Architecture

@micheletitolo
Do Write Api Contracts
Don't Write
Implementation Code

@micheletitolo
•Each visual should have 1 purpose

•Always describe the visual

•Copy anything numbered out of picture
Using Visuals

@micheletitolo
•Security

•Compliance

•Cloud Costs

•Monitoring / Alerting / SLOs / SLAs

•Disaster recovery

•Estimates or Milestone breakdown
Other Sections

@micheletitolo
•Start small

•Get buy in on design doc before

•Circulate with reviewers
fi
rst, then broadly

•Design review meeting
Building

A Design Doc Culture

@micheletitolo
•The Elements of Style, William Strunk JR and E.B. White

•Google Developer's Technical Writing Courses
Resources For Improving
Your Writing

@micheletitolo
⚠Warning⚠:

Bikeshedding Ahead

@micheletitolo
•A design doc is not a manifesto

•Liberally use non-goals to set boundaries

•Ground concerns with facts
Dealing With

Controversial Topics

@micheletitolo
"The Monolith Does Not Scale"

@micheletitolo
"In order to serve X requests per
second, the monolith needs to
scale to Y nodes.

This will likely cause issues with
the database, which is limited to Z
concurrent connections."

@micheletitolo
Write With Intention Of
Building Alignment

@micheletitolo
Design Docs Are Not
End User
Documentation

@micheletitolo
Design Docs Do Take
Time To Write

@micheletitolo
"I Don't Have Time For
This"

@micheletitolo
E
ff
ective Design Docs
Constantly Work
Towards Their Goal

@micheletitolo
Writing Design Docs Is a
Skill, Can Improve

• https://unsplash.com/photos/VX87WVuVblk

• https://unsplash.com/photos/SGn8Pl-EYq4

• https://unsplash.com/photos/aMioYew5mNE

• https://unsplash.com/photos/QIUR-K3YgDk

• https://unsplash.com/photos/294j9hG1N3w
Photo Credits

Mais conteúdo relacionado

Semelhante a Writing Design Docs for Wide Audiences

Scott mc cormick float mobile learning_prototyping strategy_mlearncon 2012

Scott McCormick

The Role of IT Architect in Startup Company

SARCCOM

The role of an IT architect in startups

Manoj Awasthi

Jeff Katz on Prototyping

Jeff Katz

Designing in the open

Catherine Robson

Tech and Product Management by Foursquare's PM

Product School

WordCamp Asheville - How to find and hire a WordPress designer and developer

Digital Strategy Works LLC

Ici & itd

IAMLETTY

Ici & itd

gjj97

Ici & itd

GillianChong

Jakub Laskowski - Prototyping: a successful IT project recipe

ecommerce poland expo

Case studies are great sales tools. But how many times have you gotten ready to submit a pitch, and realized you were missing case studies for the projects you want to highlight? You assumed somebody on the team would write one after the projected deployed, but everyone got reassigned to other projects, and it slipped through the cracks, again. And now you are sad. But it doesn’t have to be this way. Learn why we draft our project case studies before writing the first line of code, and how the team uses the case study draft as a quality assurance step to help ensure a successful project outcome.

How to take the stress out of writing case studies

DesignHammer

Drupal project management

Aryashree Pritikrishna

Rapidproductdesigninthewildagileiceland 141106135407-conversion-gate02

Naciones Unidas

A version of my Rapid Product Design in the Wild talk at Agile Iceland 2014. http://www.agileisland.is How do you know you're developing the right product? This talk will help you think creatively about how to do customer development using Agile and Lean User Experience methods. I share what we learnt about using rapid, iterative prototyping techniques to develop a minimum viable product at a software conference. In August 2012 we attended Kscope, a conference for Oracle developers. Instead of doing the usual product demonstrations, we turned our stand into a live lab and took Agile development processes out of the office and in front of our customers. Our stand included an area for customer research, a Kanban board and information radiators in the form of a whiteboard, blank wall and a large digital screen. Over 3 days we ran 9 sprints and conducted 25 customer interviews, using a paper prototype to get feedback. We collected invaluable information about our customers' development environments, how they work with their teams, their processes, tasks and pain points. By the end of the conference my colleague had developed an interactive HTML/CSS prototype which potential customers could evaluate. The team went through several rapid build-measure-learn cycles to improve our product concept and validate the market need. Opening up our development process at a trade show provided visitors to the stand with an opportunity to experience Agile and Lean methods first-hand.

Rapid Product Design in the Wild - Agile Iceland

Michele Ide-Smith

Concept to Completion: an Entrepreneurs Guide to Creating a Software Product

Lee Jones

The Profession Of IT Architecture

Christopher Grant

How to take the stress out of writing case studies

DesignHammer

Rapid Product Design in the Wild - ProductTank

Michele Ide-Smith

How to Build Software If You Can't Write Code

Russell Wallace

Semelhante a Writing Design Docs for Wide Audiences (20)

Scott mc cormick float mobile learning_prototyping strategy_mlearncon 2012

The Role of IT Architect in Startup Company

The role of an IT architect in startups

Jeff Katz on Prototyping

Designing in the open

Tech and Product Management by Foursquare's PM

WordCamp Asheville - How to find and hire a WordPress designer and developer

Ici & itd

Jakub Laskowski - Prototyping: a successful IT project recipe

How to take the stress out of writing case studies

Drupal project management

Rapidproductdesigninthewildagileiceland 141106135407-conversion-gate02

Rapid Product Design in the Wild - Agile Iceland

Concept to Completion: an Entrepreneurs Guide to Creating a Software Product

The Profession Of IT Architecture

How to take the stress out of writing case studies

Rapid Product Design in the Wild - ProductTank

How to Build Software If You Can't Write Code

Mais de Michele Titolo

More engineering organizations than ever are dealing with big data. The long times required to process big datasets slow down development cycles and delay analysis. Apache Beam pipelines distribute processing across many workers, reducing the time it takes to transform large datasets. Creating an effective Beam pipeline requires following best practices and using the specialized data structures Beam introduces. In this talk, I’ll share strategies and lessons learned from scaling Apache Beam pipelines to handle ever-increasing workloads.

Beam Me Up: Voyaging into Big Data

Michele Titolo

Service oriented systems have become hugely popular, and the golden age of the monolith has past. Sometimes these services can be fantastic, and other times not so much. Learning how to evaluate APIs and identify problem areas before jumping head first into development can save teams frustration, time, and money. This session will walk through evaluating an API, best practices, and red flags, all from the standpoint of a developer consuming them. No matter your experience level, you'll leave with the skills to effectively tackle your next API. This version given at 200ok May 2019

APIs: The Good, The Bad, The Ugly

Michele Titolo

Big, Impossible Projects are exciting, transformative, and begin with an overwhelming number of unanswered questions. Developing against a moving target is never easy — you might find yourself going against best practices such as designing solutions without knowing all the parameters, or encountering dependencies you didn’t even think were possible. Big, Impossible projects can start out looking small and simple, but like an iceberg, they have much more to them once you get up close. In this talk for both new and seasoned leaders you will learn to navigate the icebergs and bring your next Big, Impossible Project to a successful conclusion.

Tackling the Big, Impossible Project

Michele Titolo

You don't deploy a single microservice. The journey to microservice architecture involves more than how code is written or applications are packaged. It's about creating an interconnected ecosystem that keeps things running. Infrastructure and tools have only grown in importance as microservices have emerged as a dominant architecture pattern. Deploying, scaling, and monitoring are more important for microservices than they ever were before. Attendees will leave this session knowing the basic infrastructure and tooling needs for microservices to be successful.

No Microservice is an Island

Michele Titolo

When I first started talking to people about wanting to work on backend services, the most common reaction was saying that it’s so different from iOS development. I never thought of it that way. Making iOS apps involves a lot of specialized knowledge applied to seemingly specialized problems. However, when those problems are distilled down to their fundamental form, they look similar to problems encountered in other software disciplines. Together we will discover those problems and learn how to apply them to different situations.

From iOS to Distributed Systems

Michele Titolo

Xcode is incredibly useful for debugging iOS apps, especially with the updates released in the last few years. Sometimes that isn’t enough. Sometimes you want to find the exact error that caused an exception throw, or only activate a breakpoint with a certain method previously in the call stack. These cases, which are hard to debug with Xcode’s standard toolset, are easy to debug with LLDB. This talk will walk through the foundations of debugging in LLDB for Objective-C and Swift, as well as introduce some more advanced features for those really tough bugs.

More than po: Debugging in LLDB

Michele Titolo

First came APIs, then came mobile. Many companies were excited to be able to re-use existing technology to build mobile applications. The quality bar for apps has risen dramatically, and those generic APIs only go so far. Since most apps depend on APIs for data, then shouldn’t those APIs be optimized for mobile experiences? Can a poorly designed API detract from user experience? The answer to both of those questions is yes. This talk will cover why mobile APIs matter, and how existing paradigms and practices can optimize APIs for great mobile experiences.

APIs for the Mobile World

Michele Titolo

Swift Generics in Theory and Practice

Michele Titolo

Swift’s design promotes language features like generics and first-class protocols as key architectural components in application development. However, many of the logical patterns that arise, including ones imported from Objective-C, don’t work as we expect them to. In many cases, Swift’s type system resists certain straightforward patterns, such as constraining a property to both a class and a protocol. This talk will highlight several of these challenges, discuss the underlying cause, and evaluate workarounds.

Protocols promised-land-2

Michele Titolo

iOS 9 introduced multitasking, which allows apps to be used side by side on certain devices. Along with this came a number of new APIs for handling transitions between different screen configurations. However, integrating these new APIs in an exiting codebase can be trick, and often requires rethinking the way a component is structured. This talk will introduce multitasking, cover the new APIs available to handle different scenarios, and walk through some gotchas when adding support for multitasking into existing applications.

Multitasking

Michele Titolo

Small is the new big, and for good reason. The benefits of microservices and service-oriented architecture have been extolled for a number of years, yet many forge ahead without thinking of the impact the users of the services. Consuming on micro services can be enjoyable as long as the developer experience has been crafted as finely as the service itself. But just like with any other product, there isn’t a single kind of consumer. Together we will walk through some typical kinds of consumers, what their needs are, and how we can create a great developer experience using brains and tools like Docker.

Making friendly-microservices

Michele Titolo

Xcode is incredibly useful for debugging iOS apps, especially with the updates released in 6.0. But sometimes that isn't enough. Sometimes you want to find the exact error that caused the objc_exception_throw, or only activate a breakpoint with a certain method in the call stack. These cases, which are hard to debug with Xcode's standard toolset, are easy with LLDB. This talk will walk through the basics of debugging in LLDB, and solutions to common problems.

More Than po: Debugging in LLDB @ CocoaConf SJ 2015

Michele Titolo

Every developer has been there--late at night, deadline looming, piling hacks on top of hacks to get a little closer to being finished, there are no tests, edge cases are totally forgotten. Many of us think these situations lead to the worst code we could possibly write. Under such conditions, it is difficult to write robust, well architected code--true--but this is not the only situation that leads to that end. Software development is a complex, creative process that can easily get out of hand. This is because one large factor is often forgotten about--the human factor. Avoiding writing the worst code ultimately comes down to how the people writing, spec'ing, testing, validating, and tracking the code interact.

The Worst Code

Michele Titolo

Xcode is incredibly useful for debugging iOS apps, especially with the updates released in 6.0. But sometimes that isn’t enough. Sometimes you want to find the exact error that caused the objc_exception_throw, or only activate a breakpoint with a certain method in the call stack. These cases, which are hard to debug with Xcode’s toolset, are easy with LLDB. This talk will walk through the basics of debugging in LLDB, and solutions to common problems.

More than `po`: Debugging in lldb

Michele Titolo

Gone are the days where making an app just involved writing code. Now, even as a developer, we need to be aware of many other aspects of shipping. They can be human things, like "how do I stop someone from overwriting my changes to the project.pbxproj, storyboard, or xib?" Or technical challenges, like "how do I manage dependencies?” and “why do I always have to do a 3-way merge?” Or even peripheral things like “what happens to our servers if we get featured?” and “what happens to the app when the servers go down?” This session will cover common scaling problems, and solutions to overcome them.

Can't Handle My Scale v2

Michele Titolo

Scaling an app means many things. They can be human things, like "how do I stop someone from overwriting my changes to the project.pbxproj, storyboard, or xib?" Or development things, like "how do I manage dependencies?” and “why do I always have to do a 3-way merge?” Or even peripheral things like “what happens to our servers if we get featured?” and “what happens to the app when the servers go down?” This session will cover common scaling problems, and solutions to overcome them.

Can't Handle My Scale

Michele Titolo

Cocoa Design Patterns in Swift

Michele Titolo

Mastering the Project File (AltConf)

Michele Titolo

APIs: The Ugly

Michele Titolo

Inheriting code is something we all have to deal with, and knowing what you're getting yourself into is a big part of that initial deep dive. Just like anything else, this is a skill that needs to be practiced and perfected over time. This session will walk through some strategies to use when looking at code you didn't write, finding problem spots, as well as share some personal experiences I've had when working with other people's code. You'll leave feeling confident about digging into your next codebase, and have some new tools in your pocket for dealing with the unexpected.

That's Not My Code!

Michele Titolo

Mais de Michele Titolo (20)

Beam Me Up: Voyaging into Big Data

APIs: The Good, The Bad, The Ugly

Tackling the Big, Impossible Project

No Microservice is an Island

From iOS to Distributed Systems

More than po: Debugging in LLDB

APIs for the Mobile World

Swift Generics in Theory and Practice

Protocols promised-land-2

Multitasking

Making friendly-microservices

More Than po: Debugging in LLDB @ CocoaConf SJ 2015

The Worst Code

More than `po`: Debugging in lldb

Can't Handle My Scale v2

Can't Handle My Scale

Cocoa Design Patterns in Swift

Mastering the Project File (AltConf)

APIs: The Ugly

That's Not My Code!

Último

MarTech Trend 2024 Book : Marketing Technology Trends (2024 Edition) How Data...

Jittipong Loespradit

We specialize in Psychic Readings, Psychic Love Spells, Binding Love Spells, Obsession Spells, Voodoo Spells, Lottery Spells, Marriage Spells, Black Magic Spells, Palm Readings & much more. Are you depressed? We perform this come-to-me love spell that works instantly with the aim of bringing back the victim to the person performing the magic. Have you lost your lover? We perform this come-to-me love spell that works instantly with the aim of bringing back the victim to the person performing the magic. Have you lost your lover? Do u need to solve any relationship problem? Contact the powerful spells caster chief kule with love spells that work overnight and love spells that really work. Have you found yourself infatuated with a special someone you think could be the one? Are you looking for a spell to provide them with a nudge in the right direction? Or maybe the spell you cast didn’t achieve the results you were hoping for? Whether you’re new or versed in the ways of spell casting, we’re here to help. Today we’re going to provide you with a detailed guide on the types of love spells to cast. Not only that but there’s something for those who wish to find outside advice from more advanced spell casters. We’re also going to provide you with the top sites available to help you with your dilemma. Let’s begin our journey by educating ourselves on love magic and what a real love caster looks like. Love Magic and Love Casters Love magic made its first appearance back in Ancient Egypt and has been an active practice since. This type of magic is a branch of traditional magic and can be practiced in various ways. Typically the more common use of love magic is through the work of spells, but other methods look like Charms Rituals-LOVE Potions-Dolls and even Amulets If you are interested in becoming a love caster, be prepared for what’s to come. A genuine love caster knows that the art of love casting is no easy feat and shouldn’t be done casually. You should know that not only does it require you to be gifted spiritually, but you must be ready to serve others. Someone who is considered a real love caster has experience in all manner of spells, no matter the difficulty. Training yourself in attraction, commitment, and marriage spells is an excellent place to start. But this by no means will make you a professional. Practice your craft and expand your knowledge; understand that you will possess the ability to help others in time truly. Types of Love Spells What better way to start broadening your experiences with love spells than by learning more about them? These spells work like just about any other spell. Simply apply your intention, use a medium (sigils, mantras, candles, or charm bags), and top it off with establishing the belief that you will receive what you want. So what kind of spells are available and which ones suit your needs the best? Let’s take a look at the many options you have at your disposal.

%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...

masabamasaba

Looking for an efficient way to manage your finances? Look no further than our money management app. With easy-to-use features, you can track your expenses, create budgets, and monitor your savings goals all in one place. Our app provides real-time updates on your spending habits and helps you make smarter financial decisions. Take control of your finances today with our user-friendly money management app.

Right Money Management App For Your Financial Goals

Jhone kinadey

%in Bahrain+277-882-255-28 abortion pills for sale in Bahrain

masabamasaba

Craft an AI & Machine Learning Pitch with our Editable Professional PowerPoint Template. Ignite your AI & Machine Learning pitch with our cutting-edge PowerPoint template tailored for the industry. Perfect for AI conferences, investor presentations, sales pitches to tech-focused companies, training sessions, and educational programs. - 20+ editable slides: Get a variety of options to choose from for your presentation. - Time-saving solution: Download, replace text/images with a few clicks. - User-friendly customization: Easy to use and personalize. - Modern and attractive design: Captivating visuals, sleek layout. - Tailored to your requirements: Fully alterable for customization. - Well-organized slides: Complete control over content. - Thematic specificity: Reflects healthcare industry with relevant graphics. - Showcase your business idea: Communicate value proposition effectively.

AI & Machine Learning Presentation Template

Presentation.STUDIO

%+27788225528 love spells in new york Psychic Readings, Attraction spells,Bri...

masabamasaba

%in ivory park+277-882-255-28 abortion pills for sale in ivory park

masabamasaba

%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...

masabamasaba

Crypto Cloud Review - How To Earn Up To $500 Per DAY Of Bitcoin 100% On AutoP...

SelfMade bd

At the recent Microsoft Ignite 2023 conference, Microsoft unveiled a groundbreaking strategy that will redefine enterprise work management. The plan involves integrating Microsoft’s key planning tools, Microsoft To Do, Microsoft Planner, and Microsoft Project for the web into a unified experience called “Microsoft Planner.” What does this new strategy from Microsoft mean for current users? Join us and learn how best to take advantage of this announcement while gaining a clear path on how to elevate the current state of Microsoft Planner from a basic task manager to a comprehensive tool for Enterprise Work Management using OnePlan. Learn how OnePlan’s integration with Microsoft Planner allows for strategic alignment with business goals through advanced features like strategic planning, portfolio management, resource management, financial management, and more!

Introducing Microsoft’s new Enterprise Work Management (EWM) Solution

OnePlan Solutions

WSO2CON2024 - It's time to go Platformless

WSO2

Conference: Engage2024 in Antwerp Type: Workshop Speakers: Florian Vogler, Henning Kunz, Christoph Adler Title: Navigating the Future with The Hitchhiker's Guide to Notes and Domino 14 Abstract: Embark on an exhilarating journey with industry trailblazers Florian Vogler, Henning Kunz, and Christoph Adler in this not-to-be-missed workshop at the forefront of the tech universe. Get ready for a thrilling kick-off as we navigate the current state of the HCL universe, setting the stage for an exploration of the groundbreaking Notes and Domino 14. Discover the latest enhancements and revolutionary features that will redefine your experience. In this interactive session, unlock a treasure trove of tips and tricks to elevate your utilization of version 14, both with and without the game-changing panagenda MarvelClient. Brace yourself for also diving into Nomad, Nomad Web, and VoltMX, expanding your horizons in the expansive HCL landscape. Be a part of this exclusive opportunity to stay ahead in the ever-evolving world of HCL technologies. Your journey to mastering Notes and Domino 14 begins here. And remember, in the spirit of intergalactic exploration, don't forget to bring your towel!

W01_panagenda_Navigating-the-Future-with-The-Hitchhikers-Guide-to-Notes-and-D...

panagenda

WSO2Con2024 - Enabling Transactional System's Exponential Growth With Simplicity

WSO2

ADR, or Architecture Decision Record, is a valuable tool in software development for several reasons. It provides a centralized location for documenting and tracking architectural decisions, aiding both current and future team members. ADRs enhance communication among team members by documenting the rationale behind architectural decisions, especially beneficial during onboarding of new team members or when revisiting decisions. They serve as a knowledge base, enabling teams to learn from past decisions and refine their decision-making process. Additionally, ADRs contribute to transparency by helping stakeholders understand the reasons behind specific architectural choices. As with any other tool or process, introducing them into an organization can face several obstacles, and overcoming these challenges is crucial for successful implementation. In this talk I go through some common problems and our way of solving them.

Architecture decision records - How not to get lost in the past

Papp Krisztián

tonesoftg

lanshi9

%in kaalfontein+277-882-255-28 abortion pills for sale in kaalfontein

masabamasaba

%in kempton park+277-882-255-28 abortion pills for sale in kempton park

masabamasaba

+971565801893 Mtp-Kit (500MG) Prices » Dubai [(+971565801893**)] Abortion Pills For Sale In Dubai, UAE, Mifepristone and Misoprostol Tablets Available In Dubai, UAE CONTACT DR.Leen Whatsapp +971565801893 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 +971565801893''''Abortion Pills near me DUBAI | ABU DHABI|UAE. Price of Misoprostol, Cytotec” +971565801893' 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 Clinic in Abu Dhabi, United Arab Emirates.+971565801893

+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...

Health

VTU technical seminar 8Th Sem on Scikit-learn

AmarnathKambale

%in Stilfontein+277-882-255-28 abortion pills for sale in Stilfontein

masabamasaba

Writing Design Docs for Wide Audiences

1. Writing Design Docs For Wide Audiences Michele Titolo Software Engineer, Square

2. Introduction To Design Docs

3. @micheletitolo •Details what you plan to build •Future looking •Has sections or a template What Is A Design Doc

4. @micheletitolo •Communication •Collaboration •Building alignment •Thoroughness Purpose Of Design Docs

5. @micheletitolo •Socialize designs •Leverage experiences of others •Reduce surprises Bene fi ts

6. @micheletitolo •Design docs reference PRDs •Di ff erent purposes PRDs and Design Docs

7. @micheletitolo •Projects with non-obvious or new components •Cross-team or cross-function •During planning, before implementation •Aid in breaking down the project When Do You Write A Design Doc

8. @micheletitolo •Prototype before or while writing the design doc •Inform design •Turn unknown unknowns to known unknowns •Timebox or constrain prototype •Link to notes Prototyping

9. @micheletitolo •Collaborative editor •Single place of truth •Single place of discussion Where Do You Write A Design Doc

10. How To Write A Design Doc

11. @micheletitolo Figure Out Your Audience

12. @micheletitolo Vertical

13. @micheletitolo Vertical, Horizontal

14. @micheletitolo Vertical, Horizontal, Both

15. @micheletitolo •Who will this impact? •Who will integrate? •Who will ultimately use? •Do you have other stakeholders? Research

16. @micheletitolo Sections

17. @micheletitolo •Reviewers •Audience •Background •Goals and Non-Goals •Architecture or Design De fi ne The Sections

18. @micheletitolo No PRD? Write Requirements In A Section

19. @micheletitolo •History and context •Constraints or challenges Writing The Background

20. @micheletitolo •Set scope of the doc •Use cases and non use cases •Articulate technical requirements Goals And Non-Goals

21. @micheletitolo •Describe what you plan to build •Choose the right level of detail •Room for surprises •Tradeo ff s Architecture

22. @micheletitolo Do Write Api Contracts Don't Write Implementation Code

23. @micheletitolo •Each visual should have 1 purpose •Always describe the visual •Copy anything numbered out of picture Using Visuals

24. @micheletitolo •Security •Compliance •Cloud Costs •Monitoring / Alerting / SLOs / SLAs •Disaster recovery •Estimates or Milestone breakdown Other Sections

25. @micheletitolo •Start small •Get buy in on design doc before •Circulate with reviewers fi rst, then broadly •Design review meeting Building A Design Doc Culture

26. @micheletitolo Adoption Takes Time

27. Writing Effectively

28. @micheletitolo •The Elements of Style, William Strunk JR and E.B. White •Google Developer's Technical Writing Courses Resources For Improving Your Writing

29. @micheletitolo ⚠Warning⚠: Bikeshedding Ahead

30. @micheletitolo •A design doc is not a manifesto •Liberally use non-goals to set boundaries •Ground concerns with facts Dealing With Controversial Topics

31. @micheletitolo "The Monolith Does Not Scale"

32. @micheletitolo "In order to serve X requests per second, the monolith needs to scale to Y nodes. This will likely cause issues with the database, which is limited to Z concurrent connections."

33. @micheletitolo Write With Intention Of Building Alignment

34. Gotchas

35. @micheletitolo Design Docs Are Not End User Documentation

36. @micheletitolo Design Docs Do Take Time To Write

37. @micheletitolo "I Don't Have Time For This"

38. Conclusion

39. @micheletitolo E ff ective Design Docs Constantly Work Towards Their Goal

40. @micheletitolo Writing Design Docs Is a Skill, Can Improve

41. @micheletitolo Increase Your Impact 💪

42. @micheletitolo Thank You

43. • https://unsplash.com/photos/VX87WVuVblk • https://unsplash.com/photos/SGn8Pl-EYq4 • https://unsplash.com/photos/aMioYew5mNE • https://unsplash.com/photos/QIUR-K3YgDk • https://unsplash.com/photos/294j9hG1N3w Photo Credits

Writing Design Docs for Wide Audiences

Recomendados

Recomendados

Mais conteúdo relacionado

Semelhante a Writing Design Docs for Wide Audiences

Semelhante a Writing Design Docs for Wide Audiences (20)

Mais de Michele Titolo

Mais de Michele Titolo (20)

Último

Último (20)

Writing Design Docs for Wide Audiences