SlideShare a Scribd company logo
1 of 41
Download to read offline
Contributing To
Drupal
Documentation
MidCamp
Saturday March 21st, 2015
Presented by:
Tim Erickson
(StPaulTim)
Sunday, March 22, 15
Where do you get your info about
Drupal?
• Name
• Where are you from?
• What is your favorite source of information
to answer your Drupal questions?
• What if anything prevents you from
contributing to Drupal Documentation?
Sunday, March 22, 15
About Me:
• Online Facilitator - Online Community
E-Democracy.org
(1997 - 2010)
• Mr.Tai’s Restaurant
(2010 - 2011)
• Drupal Freelancer
(2012 - 2014)
• Triplo, Founding Partner
(May 2014 - Present)
Sunday, March 22, 15
• Tim Erickson
stpaultim
• Barry Madore
bmadore
• David Needham
davidneedham
Build • Train • Mentor • Support • Community
Sunday, March 22, 15
Sunday, March 22, 15
My Drupal Motto
Come for the community
Stay for the code
Sunday, March 22, 15
1. Good documentation is a important and vital part of
the overall Drupal experience.
2. Contributing to Drupal documentation is a selfish
act that serves us all.
3. There are many ways to contribute to Drupal
documentation.
4. You can and should be contributing to Drupal
documentation is some way or another.
Key points:
Sunday, March 22, 15
My First Documentation Edit
Sunday, March 22, 15
Should I edit this?
Sunday, March 22, 15
Don’t worry - there is a history...
Sunday, March 22, 15
Since my first edit:
1. The openlayers module has
undergone changes.
2. Others have added incorrect
information to the page.
3. Someone else has added
detailed variations in the
comments section.
4. The page is still out of date
and needs additional work.
Sunday, March 22, 15
Why Contribute?
• Self-document what you’ve learned for future use
• Increase your own understanding of Drupal
• Build your reputation in the community
• Gain experience in technical writing and editing
• “Give Back” to the Drupal community
Sunday, March 22, 15
Definition
the usually printed written instructions, comments,
and information for using a particular piece or
system of computer software or hardware
Sunday, March 22, 15
Old School Documentation
Limited opportunities for contribution.
Sunday, March 22, 15
Online Documentation
1. “Official” Documentation on Drupal.org
Sunday, March 22, 15
Online Documentation
1. “Official” Documentation on Drupal.org
2. Documentation in code (i.e. Zen Theme)
Sunday, March 22, 15
Sunday, March 22, 15
Online Documentation
1. “Official” Documentation on Drupal.org
2. Documentation in code (i.e. Zen Theme)
3. Issues queue
Sunday, March 22, 15
Ways to “document” in
the issues queue.
• If you find a solution in the issues queue, let others
know that it worked for you.
• If the provided solution does not work for you and
you figure it out yourself or find a solution
elsewhere. Post a comment
• If there are multiple solutions in the issues queue,
edit the issue summary to summarize the
discussion (see next slide).
Sunday, March 22, 15
Sunday, March 22, 15
Online Documentation
1. “Official” Documentation on Drupal.org
2. Documentation in code (i.e. Zen Theme)
3. Issues queue
4. Third party sites like - Drupal Answers
Sunday, March 22, 15
Sunday, March 22, 15
Online Documentation
1. “Official” Documentation on Drupal.org
2. Documentation in code (i.e. Zen Theme)
3. Issues queue
4. Third party sites like - Drupal Answers
5. Drupal planet - or blogs in general
Sunday, March 22, 15
Sunday, March 22, 15
“That's why it's so important that you take that thing
that you just figured out, copy and paste it into a
body field, and click publish.”
Sunday, March 22, 15
“We need more voices, and we need more diverse voices. We need
voices from the southern hemisphere. We need voices that worry
that their English isn't good enough. We need the voices of people
just starting out and feeling slow and stupid. You just learned
where the logout button was? Cool. Tell us about it. You made a
mistake and blew up your site? Bummer. Tell us about it.
Whatever you're working on, I want you to tell us about it because
if you get in the habit of telling us about it, then that habit will pay
dividends over time and everybody will benefit together.”
http://www.bryanbraun.com/2013/09/21/please-
stop-stewing-and-start-blogging-about-drupal
Sunday, March 22, 15
Online Documentation
1. “Official” Documentation on Drupal.org
2. Documentation in code (i.e. Zen Theme)
3. Issues queue
4. Third party sites like - Drupal Answers
5. Drupal planet - or blogs in general
6. Other.....
Sunday, March 22, 15
How to Get Involved:
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
Sunday, March 22, 15
#drupal-docs
#drupalorg
Sunday, March 22, 15
Major Challenges
• Technology (Drupal.org)?
• Lack of attention put on documentation at
sprints and public events?
• Emphasis at sprints on Drupal 8 (as opposed to
encouraging people to start where they are
comfortable).
Sunday, March 22, 15
Additional Resources
• Drupal Best Practice: DocumentYour Way to Understanding
Angie Byron
https://www.lullabot.com/blog/article/drupal-best-practice-document-your-way-understanding
• Please, Stop Stewing, and Start Blogging about Drupal
Bryan Braun
http://www.bryanbraun.com/2013/09/21/please-stop-stewing-and-start-blogging-about-drupal
• Drupal.org Documentation (IntroVideo - 10 min)
Addison Berry
https://drupalize.me/videos/drupalorg-documentation
Sunday, March 22, 15
Sunday, March 22, 15

More Related Content

Recently uploaded

Optimizing Operations by Aligning Resources with Strategic Objectives Using O...
Optimizing Operations by Aligning Resources with Strategic Objectives Using O...Optimizing Operations by Aligning Resources with Strategic Objectives Using O...
Optimizing Operations by Aligning Resources with Strategic Objectives Using O...OnePlan Solutions
 
What need to be mastered as AI-Powered Java Developers
What need to be mastered as AI-Powered Java DevelopersWhat need to be mastered as AI-Powered Java Developers
What need to be mastered as AI-Powered Java DevelopersEmilyJiang23
 
Modern binary build systems - PyCon 2024
Modern binary build systems - PyCon 2024Modern binary build systems - PyCon 2024
Modern binary build systems - PyCon 2024Henry Schreiner
 
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAGAI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAGAlluxio, Inc.
 
IT Software Development Resume, Vaibhav jha 2024
IT Software Development Resume, Vaibhav jha 2024IT Software Development Resume, Vaibhav jha 2024
IT Software Development Resume, Vaibhav jha 2024vaibhav130304
 
Microsoft 365 Copilot; An AI tool changing the world of work _PDF.pdf
Microsoft 365 Copilot; An AI tool changing the world of work _PDF.pdfMicrosoft 365 Copilot; An AI tool changing the world of work _PDF.pdf
Microsoft 365 Copilot; An AI tool changing the world of work _PDF.pdfQ-Advise
 
Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...
Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...
Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...Andrea Goulet
 
Crafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM IntegrationCrafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM IntegrationWave PLM
 
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1KnowledgeSeed
 
Workforce Efficiency with Employee Time Tracking Software.pdf
Workforce Efficiency with Employee Time Tracking Software.pdfWorkforce Efficiency with Employee Time Tracking Software.pdf
Workforce Efficiency with Employee Time Tracking Software.pdfDeskTrack
 
StrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdf
StrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdfStrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdf
StrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdfsteffenkarlsson2
 
The Impact of PLM Software on Fashion Production
The Impact of PLM Software on Fashion ProductionThe Impact of PLM Software on Fashion Production
The Impact of PLM Software on Fashion ProductionWave PLM
 
KLARNA - Language Models and Knowledge Graphs: A Systems Approach
KLARNA -  Language Models and Knowledge Graphs: A Systems ApproachKLARNA -  Language Models and Knowledge Graphs: A Systems Approach
KLARNA - Language Models and Knowledge Graphs: A Systems ApproachNeo4j
 
OpenChain @ LF Japan Executive Briefing - May 2024
OpenChain @ LF Japan Executive Briefing - May 2024OpenChain @ LF Japan Executive Briefing - May 2024
OpenChain @ LF Japan Executive Briefing - May 2024Shane Coughlan
 
Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024
Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024
Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024Primacy Infotech
 
A Guideline to Zendesk to Re:amaze Data Migration
A Guideline to Zendesk to Re:amaze Data MigrationA Guideline to Zendesk to Re:amaze Data Migration
A Guideline to Zendesk to Re:amaze Data MigrationHelp Desk Migration
 
Automate your OpenSIPS config tests - OpenSIPS Summit 2024
Automate your OpenSIPS config tests - OpenSIPS Summit 2024Automate your OpenSIPS config tests - OpenSIPS Summit 2024
Automate your OpenSIPS config tests - OpenSIPS Summit 2024Andreas Granig
 
10 Essential Software Testing Tools You Need to Know About.pdf
10 Essential Software Testing Tools You Need to Know About.pdf10 Essential Software Testing Tools You Need to Know About.pdf
10 Essential Software Testing Tools You Need to Know About.pdfkalichargn70th171
 

Recently uploaded (20)

Optimizing Operations by Aligning Resources with Strategic Objectives Using O...
Optimizing Operations by Aligning Resources with Strategic Objectives Using O...Optimizing Operations by Aligning Resources with Strategic Objectives Using O...
Optimizing Operations by Aligning Resources with Strategic Objectives Using O...
 
What need to be mastered as AI-Powered Java Developers
What need to be mastered as AI-Powered Java DevelopersWhat need to be mastered as AI-Powered Java Developers
What need to be mastered as AI-Powered Java Developers
 
Modern binary build systems - PyCon 2024
Modern binary build systems - PyCon 2024Modern binary build systems - PyCon 2024
Modern binary build systems - PyCon 2024
 
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAGAI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
AI/ML Infra Meetup | Reducing Prefill for LLM Serving in RAG
 
IT Software Development Resume, Vaibhav jha 2024
IT Software Development Resume, Vaibhav jha 2024IT Software Development Resume, Vaibhav jha 2024
IT Software Development Resume, Vaibhav jha 2024
 
Microsoft 365 Copilot; An AI tool changing the world of work _PDF.pdf
Microsoft 365 Copilot; An AI tool changing the world of work _PDF.pdfMicrosoft 365 Copilot; An AI tool changing the world of work _PDF.pdf
Microsoft 365 Copilot; An AI tool changing the world of work _PDF.pdf
 
Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...
Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...
Entropy, Software Quality, and Innovation (presented at Princeton Plasma Phys...
 
Crafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM IntegrationCrafting the Perfect Measurement Sheet with PLM Integration
Crafting the Perfect Measurement Sheet with PLM Integration
 
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
A Python-based approach to data loading in TM1 - Using Airflow as an ETL for TM1
 
Workforce Efficiency with Employee Time Tracking Software.pdf
Workforce Efficiency with Employee Time Tracking Software.pdfWorkforce Efficiency with Employee Time Tracking Software.pdf
Workforce Efficiency with Employee Time Tracking Software.pdf
 
5 Reasons Driving Warehouse Management Systems Demand
5 Reasons Driving Warehouse Management Systems Demand5 Reasons Driving Warehouse Management Systems Demand
5 Reasons Driving Warehouse Management Systems Demand
 
StrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdf
StrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdfStrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdf
StrimziCon 2024 - Transition to Apache Kafka on Kubernetes with Strimzi.pdf
 
The Impact of PLM Software on Fashion Production
The Impact of PLM Software on Fashion ProductionThe Impact of PLM Software on Fashion Production
The Impact of PLM Software on Fashion Production
 
KLARNA - Language Models and Knowledge Graphs: A Systems Approach
KLARNA -  Language Models and Knowledge Graphs: A Systems ApproachKLARNA -  Language Models and Knowledge Graphs: A Systems Approach
KLARNA - Language Models and Knowledge Graphs: A Systems Approach
 
OpenChain @ LF Japan Executive Briefing - May 2024
OpenChain @ LF Japan Executive Briefing - May 2024OpenChain @ LF Japan Executive Briefing - May 2024
OpenChain @ LF Japan Executive Briefing - May 2024
 
Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024
Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024
Odoo vs Shopify: Why Odoo is Best for Ecommerce Website Builder in 2024
 
A Guideline to Zendesk to Re:amaze Data Migration
A Guideline to Zendesk to Re:amaze Data MigrationA Guideline to Zendesk to Re:amaze Data Migration
A Guideline to Zendesk to Re:amaze Data Migration
 
Automate your OpenSIPS config tests - OpenSIPS Summit 2024
Automate your OpenSIPS config tests - OpenSIPS Summit 2024Automate your OpenSIPS config tests - OpenSIPS Summit 2024
Automate your OpenSIPS config tests - OpenSIPS Summit 2024
 
AI Hackathon.pptx
AI                        Hackathon.pptxAI                        Hackathon.pptx
AI Hackathon.pptx
 
10 Essential Software Testing Tools You Need to Know About.pdf
10 Essential Software Testing Tools You Need to Know About.pdf10 Essential Software Testing Tools You Need to Know About.pdf
10 Essential Software Testing Tools You Need to Know About.pdf
 

Featured

Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)contently
 
How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024Albert Qian
 
Social Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie InsightsSocial Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie InsightsKurio // The Social Media Age(ncy)
 
Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024Search Engine Journal
 
5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summary5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summarySpeakerHub
 
ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd Clark Boyd
 
Getting into the tech field. what next
Getting into the tech field. what next Getting into the tech field. what next
Getting into the tech field. what next Tessa Mero
 
Google's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search IntentGoogle's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search IntentLily Ray
 
Time Management & Productivity - Best Practices
Time Management & Productivity -  Best PracticesTime Management & Productivity -  Best Practices
Time Management & Productivity - Best PracticesVit Horky
 
The six step guide to practical project management
The six step guide to practical project managementThe six step guide to practical project management
The six step guide to practical project managementMindGenius
 
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...RachelPearson36
 
Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...
Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...
Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...Applitools
 
12 Ways to Increase Your Influence at Work
12 Ways to Increase Your Influence at Work12 Ways to Increase Your Influence at Work
12 Ways to Increase Your Influence at WorkGetSmarter
 
Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...
Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...
Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...DevGAMM Conference
 
Barbie - Brand Strategy Presentation
Barbie - Brand Strategy PresentationBarbie - Brand Strategy Presentation
Barbie - Brand Strategy PresentationErica Santiago
 
Good Stuff Happens in 1:1 Meetings: Why you need them and how to do them well
Good Stuff Happens in 1:1 Meetings: Why you need them and how to do them wellGood Stuff Happens in 1:1 Meetings: Why you need them and how to do them well
Good Stuff Happens in 1:1 Meetings: Why you need them and how to do them wellSaba Software
 

Featured (20)

Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)
 
How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024
 
Social Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie InsightsSocial Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie Insights
 
Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024
 
5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summary5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summary
 
ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd
 
Getting into the tech field. what next
Getting into the tech field. what next Getting into the tech field. what next
Getting into the tech field. what next
 
Google's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search IntentGoogle's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search Intent
 
How to have difficult conversations
How to have difficult conversations How to have difficult conversations
How to have difficult conversations
 
Introduction to Data Science
Introduction to Data ScienceIntroduction to Data Science
Introduction to Data Science
 
Time Management & Productivity - Best Practices
Time Management & Productivity -  Best PracticesTime Management & Productivity -  Best Practices
Time Management & Productivity - Best Practices
 
The six step guide to practical project management
The six step guide to practical project managementThe six step guide to practical project management
The six step guide to practical project management
 
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
 
Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...
Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...
Unlocking the Power of ChatGPT and AI in Testing - A Real-World Look, present...
 
12 Ways to Increase Your Influence at Work
12 Ways to Increase Your Influence at Work12 Ways to Increase Your Influence at Work
12 Ways to Increase Your Influence at Work
 
ChatGPT webinar slides
ChatGPT webinar slidesChatGPT webinar slides
ChatGPT webinar slides
 
More than Just Lines on a Map: Best Practices for U.S Bike Routes
More than Just Lines on a Map: Best Practices for U.S Bike RoutesMore than Just Lines on a Map: Best Practices for U.S Bike Routes
More than Just Lines on a Map: Best Practices for U.S Bike Routes
 
Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...
Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...
Ride the Storm: Navigating Through Unstable Periods / Katerina Rudko (Belka G...
 
Barbie - Brand Strategy Presentation
Barbie - Brand Strategy PresentationBarbie - Brand Strategy Presentation
Barbie - Brand Strategy Presentation
 
Good Stuff Happens in 1:1 Meetings: Why you need them and how to do them well
Good Stuff Happens in 1:1 Meetings: Why you need them and how to do them wellGood Stuff Happens in 1:1 Meetings: Why you need them and how to do them well
Good Stuff Happens in 1:1 Meetings: Why you need them and how to do them well
 

Contributing to Drupal Docu

  • 1. Contributing To Drupal Documentation MidCamp Saturday March 21st, 2015 Presented by: Tim Erickson (StPaulTim) Sunday, March 22, 15
  • 2. Where do you get your info about Drupal? • Name • Where are you from? • What is your favorite source of information to answer your Drupal questions? • What if anything prevents you from contributing to Drupal Documentation? Sunday, March 22, 15
  • 3. About Me: • Online Facilitator - Online Community E-Democracy.org (1997 - 2010) • Mr.Tai’s Restaurant (2010 - 2011) • Drupal Freelancer (2012 - 2014) • Triplo, Founding Partner (May 2014 - Present) Sunday, March 22, 15
  • 4. • Tim Erickson stpaultim • Barry Madore bmadore • David Needham davidneedham Build • Train • Mentor • Support • Community Sunday, March 22, 15
  • 6. My Drupal Motto Come for the community Stay for the code Sunday, March 22, 15
  • 7. 1. Good documentation is a important and vital part of the overall Drupal experience. 2. Contributing to Drupal documentation is a selfish act that serves us all. 3. There are many ways to contribute to Drupal documentation. 4. You can and should be contributing to Drupal documentation is some way or another. Key points: Sunday, March 22, 15
  • 8. My First Documentation Edit Sunday, March 22, 15
  • 9. Should I edit this? Sunday, March 22, 15
  • 10. Don’t worry - there is a history... Sunday, March 22, 15
  • 11. Since my first edit: 1. The openlayers module has undergone changes. 2. Others have added incorrect information to the page. 3. Someone else has added detailed variations in the comments section. 4. The page is still out of date and needs additional work. Sunday, March 22, 15
  • 12. Why Contribute? • Self-document what you’ve learned for future use • Increase your own understanding of Drupal • Build your reputation in the community • Gain experience in technical writing and editing • “Give Back” to the Drupal community Sunday, March 22, 15
  • 13. Definition the usually printed written instructions, comments, and information for using a particular piece or system of computer software or hardware Sunday, March 22, 15
  • 14. Old School Documentation Limited opportunities for contribution. Sunday, March 22, 15
  • 15. Online Documentation 1. “Official” Documentation on Drupal.org Sunday, March 22, 15
  • 16. Online Documentation 1. “Official” Documentation on Drupal.org 2. Documentation in code (i.e. Zen Theme) Sunday, March 22, 15
  • 18. Online Documentation 1. “Official” Documentation on Drupal.org 2. Documentation in code (i.e. Zen Theme) 3. Issues queue Sunday, March 22, 15
  • 19. Ways to “document” in the issues queue. • If you find a solution in the issues queue, let others know that it worked for you. • If the provided solution does not work for you and you figure it out yourself or find a solution elsewhere. Post a comment • If there are multiple solutions in the issues queue, edit the issue summary to summarize the discussion (see next slide). Sunday, March 22, 15
  • 21. Online Documentation 1. “Official” Documentation on Drupal.org 2. Documentation in code (i.e. Zen Theme) 3. Issues queue 4. Third party sites like - Drupal Answers Sunday, March 22, 15
  • 23. Online Documentation 1. “Official” Documentation on Drupal.org 2. Documentation in code (i.e. Zen Theme) 3. Issues queue 4. Third party sites like - Drupal Answers 5. Drupal planet - or blogs in general Sunday, March 22, 15
  • 25. “That's why it's so important that you take that thing that you just figured out, copy and paste it into a body field, and click publish.” Sunday, March 22, 15
  • 26. “We need more voices, and we need more diverse voices. We need voices from the southern hemisphere. We need voices that worry that their English isn't good enough. We need the voices of people just starting out and feeling slow and stupid. You just learned where the logout button was? Cool. Tell us about it. You made a mistake and blew up your site? Bummer. Tell us about it. Whatever you're working on, I want you to tell us about it because if you get in the habit of telling us about it, then that habit will pay dividends over time and everybody will benefit together.” http://www.bryanbraun.com/2013/09/21/please- stop-stewing-and-start-blogging-about-drupal Sunday, March 22, 15
  • 27. Online Documentation 1. “Official” Documentation on Drupal.org 2. Documentation in code (i.e. Zen Theme) 3. Issues queue 4. Third party sites like - Drupal Answers 5. Drupal planet - or blogs in general 6. Other..... Sunday, March 22, 15
  • 28. How to Get Involved: Sunday, March 22, 15
  • 39. Major Challenges • Technology (Drupal.org)? • Lack of attention put on documentation at sprints and public events? • Emphasis at sprints on Drupal 8 (as opposed to encouraging people to start where they are comfortable). Sunday, March 22, 15
  • 40. Additional Resources • Drupal Best Practice: DocumentYour Way to Understanding Angie Byron https://www.lullabot.com/blog/article/drupal-best-practice-document-your-way-understanding • Please, Stop Stewing, and Start Blogging about Drupal Bryan Braun http://www.bryanbraun.com/2013/09/21/please-stop-stewing-and-start-blogging-about-drupal • Drupal.org Documentation (IntroVideo - 10 min) Addison Berry https://drupalize.me/videos/drupalorg-documentation Sunday, March 22, 15