Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Die Dokumentation Braucht Dich

Avatar for Christian Flothmann Christian Flothmann
October 15, 2015
Programming
0
130

Die Dokumentation Braucht Dich

SymfonyLive Berlin, 15.10.2015
Avatar for Christian Flothmann

Christian Flothmann

October 15, 2015
Tweet

More Decks by Christian Flothmann

See All by Christian Flothmann
Anatomie des Request Handlings
Avatar for Christian Flothmann xabbuh
0
130
Was ist neu in Symfony?
Avatar for Christian Flothmann xabbuh
0
57
Symfony43.pdf
Avatar for Christian Flothmann xabbuh
0
130
Symfony4 Deep Dive
Avatar for Christian Flothmann xabbuh
3
770
Business-Workflows in Symfony-Anwendungen modellieren
Avatar for Christian Flothmann xabbuh
0
190
Get ready for Symfony 4
Avatar for Christian Flothmann xabbuh
7
1.5k
FOSRest 2.0, SymfonyLive Cologne
Avatar for Christian Flothmann xabbuh
2
310
FOSRestBundle, Symfony User Group Cologne
Avatar for Christian Flothmann xabbuh
0
620

Other Decks in Programming

See All in Programming
ASP.NETアプリケーションのモダナイズ インフラ編
Avatar for tomokusaba tomokusaba
1
210
2度もゼロから書き直して、やっとブラウザでぬるぬる動くAIに辿り着いた話
Avatar for Tomohiro Inoue tomoino
0
160
A comprehensive view of refactoring
Avatar for Marabesi marabesi
0
120
Cline指示通りに動かない？ AI小説エージェントで学ぶ指示書の書き方と自動アップデートの仕組み
Avatar for 葦沢かもめ kamomeashizawa
1
450
人には人それぞれのサービス層がある
Avatar for shimabox shimabox
3
670
Cursor Meetup Tokyo ゲノミクスとCursor： 進化と制約のあいだ
Avatar for Masaru Koido koido
2
980
Elixir で IoT 開発、 Nerves なら簡単にできる！？
Avatar for pojiro pojiro
1
120
インターフェース設計のコツとツボ
Avatar for おぎ togishima
2
700
コードに語らせよう――自己ドキュメント化が内包する楽しさについて / Let the Code Speak
Avatar for nrs nrslib
6
1.4k
カクヨムAndroidアプリのリブート
Avatar for Nabe numeroanddev
0
410
Perplexity Slack Botを作ってAI活用を進めた話 / AI Engineering Summit プレイベント
Avatar for yukyan n3xem
0
640
GoのWebAssembly活用パターン紹介
Avatar for syumai syumai
3
10k

Featured

See All Featured
How to Ace a Technical Interview
Avatar for Jacob Kaplan-Moss jacobian
276
23k
How to train your dragon (web standard)
Avatar for Monica Dinculescu notwaldorf
92
6.1k
Designing Experiences People Love
Avatar for Jonathan Moore moore
142
24k
The MySQL Ecosystem @ GitHub 2015
Avatar for Sam Lambert samlambert
251
13k
Product Roadmaps are Hard
Avatar for C. Todd Lombardo iamctodd
PRO
53
11k
The Art of Delivering Value - GDevCon NA Keynote
Avatar for David Neal reverentgeek
14
1.5k
CSS Pre-Processors: Stylus, Less & Sass
Avatar for Bermon Painter bermonpainter
357
30k
Practical Orchestrator
Avatar for Shlomi Noach shlominoach
188
11k
Six Lessons from altMBA
Avatar for Skipper Chong Warson skipperchong
28
3.8k
Automating Front-end Workflow
Avatar for Addy Osmani addyosmani
1370
200k
Understanding Cognitive Biases in Performance Measurement
Avatar for Philip Tellis bluesmoon
29
1.8k
StorybookのUI Testing Handbookを読んだ
Avatar for Shingo Yamazaki zakiyama
30
5.8k

Transcript

  1. Die Dokumentation Braucht Dich Christian Flothmann SymfonyLive Berlin, 15. Oktober

    2015

  2. Christian Flothmann Software-Entwickler bei xabbuh Symfony Core Team Symfony Documentation

    Team

  3. Was macht eine gute Dokumentation aus?

  4. Einstiegshilfe verst¨ andlich Nachschlagewerk strukturiert fehlerfrei vollst¨ andig

  5. Erf¨ ullt die Symfony-Dokumentation diese Erwartungen?

  6. Einstiegshilfe verst¨ andlich Nachschlagewerk strukturiert fehlerfrei vollst¨ andig

  7. Kann ich wirklich helfen?

  8. dokumentieren ist langweilig dokumentieren ist schwierig mein Englisch ist nicht

    gut genug

  9. ¨ Anderungen m¨ ussen nicht aufw¨ andig sein

  10. jede Verbesserung ist wichtig

  11. technische Dokumentation = keine Prosa

  12. Wie kann ich helfen?

  13. symfony/symfony-docs Koordination durch das Documentation Team

  14. Was kann ich machen?

  15. Bugreports erstellen Feedback abgeben Pull Requests er¨ offnen PRs reviewen

  16. Wie finde ich ein Issue?

  17. Label helfen beim Filtern

  18. Wie erstelle ich einen Pull Request?

  19. None
  20. None
  21. None
  22. None
  23. None
  24. None
  25. None
  26. None
  27. None
  28. None

  29. Wie geht es weiter?

  30. SymfonyLive: sprecht mich an Hack Day am Samstag IRC: #symfony-docs

    kontaktiert uns auf Twitter und GitHub

  31. @javiereguiluz @weaverryan @wouterjnl @xabbuh