agile x api x documentation @ ngo [[mopcon2015]]

Agile x API x Documentation @ NGO

by

•

•

•

x

•

•

•

• Scrum

•

•

•

•

•

•

•

•

• Scrum

•

•

•

•

•

• A-team, ~40 engineers

• open source projects

•

• fork

• code

• 4 engineers

•

• Python ( !)

• startup

• APIer (5 frameworks)

• Web

• &

•

•

•

• 1~3

• Scrum

•

•

•

•

•

•

• GAE (webapp2 + flask)

• Backbone.js + jquery + handlebar.js

• codebase

• Python: 8

• JS: Python …

* 7

Code

•

•

• follow

•

•

source

•

•

•

•

•

• by @

ack “#TODO”

… 12

TODO

ack “# TODO”

… 517

Blame

…

• ajax html js

• bug

• css …

–

•

•

• ( )

• branch

• local => gae

• pull-request

• code review

• Deploy (set default)

• Feature ( )

• ( )

• …

• End2End tests ( )

• selenium (py.test + splinter)

• code review

• GA / Ipython notebook / pandas

•

•

•

• Scrum (4~)

•

•

•

•

•

Scrum

Scrum• pagamo Jason

• PO/SM/

• priority meeting => backlog

• planning meeting => task

• daily meeting =>

• demo meeting =>

• retrospective meeting =>

– Jira

sprint

• SM

• sync

•

•

•

•

• + scrum

•

• demo bug?

• code review

• GA / Ipython notebook / pandas

• scrum

• ab test (gae-bingo)

•

•

•

• Scrum

• (7~)

•

•

•

•

• scrum

• …

• 8 + *2 + …

•

• … ( )

• 4~5 sprint

• planning -> … -> demo

• code

• task

•

• feature

• pair

• feature

• prototype task

• AC How to test

•

•

notification/ …

• CI server (jenkins)

• end2end tests

•

• XD

• code review

• GA / Ipython notebook / pandas

• scrum

• ab test (gae-bingo)

• pair

• prototype

•

• CI server

•

•

•

• Scrum

•

• (9~)

•

•

•

BUG

•

•

• feature bug

• feature bug

• bug feature

• bug

•

• bug

•

• SM Orz

• code review

• GA / Ipython notebook / pandas

• scrum

• ab test (gae-bingo)

• pair

• prototype

•

• CI server

•

•

•

•

• Scrum

•

•

• (10~)

•

•

• scrum

•

• API

unit tests

API e2e tests

API DOC

• Based on MOPCON

• flask-autodoc request/response

•

• apipie-rails

• code review

• GA / Ipython notebook / pandas

• scrum

• ab test (gae-bingo)

• pair

• prototype

•

• CI server

•

• unit tests

• api e2e tests

• api doc

•

•

•

• Scrum

•

•

•

•

•

• API (MOPCON2013 slide)

• flask-autodoc (demo)

•

•

•

• Scrum

•

•

•

•

•

–

NGO

# TODO• unit tests / API e2e tests / API doc

• Be more agile (?)

• mobilized

•

• +

– * 2 + QA …

• * N

• * 1

• ... * N XD

Python • 11/8 .py Deep learning workshop

• 11 .py x MOSUT

• PyConTW2016 6.3 ~ 6.5 ( )

•

•

QA