Tech Project Bootstrap Stack
Since a few years ago, we foresaw a vast number of new technologies allowing more agile product development. Those technologies are enabled by a list of nicely-designed tools.
In this document, we are going to introduce a few management-related tools.
Source Code Management + Agile Issue Tracking
Source code management and issue tracking must be connected closely otherwise we would not able to figure out the missing link between tasks and outcomes. A few options are here:
- Bitbucket / Github + Jira
- Pros: This is the most sophisticated combination and it’s tightly connected with the community. It’s easy to use yet provides new possibility than traditional issue tracking. And it’s not necessary to waste time on maintanance.
- Cons: Github is occationally blocked in China. Secondly, it’s expensive, costs approximately 400 USD / mo for 50 seats team.
- Pros: Used by Facebook and other startups, provides one-stop open-source solution towards all development management related issues, has all features integrated with great capability. Self-hosted.
- Cons: Agile board feature is still in beta and needs improvement. Phabricator’s old-school technology makes it a bit hard to set up (but still one-stop).
- Github + Zenhub
- Pros: Fancy, trendy, easy to use. A cost-saving alternative than Jira.
- Cons: Neither Github nor Zenhub has office in China. Chances to get blocked.
- Gitlab CE + LeanLabs Kanban
- Pros: A user-friendly self-hosted plan, Gitlab CE is much more firendly than Phabricator and LeanLabs Kanban is more mature than Phabricator’s integrated solution.
- Cons: Need to connect every service / open-source solution manually, man-power consuming maintanance.
Note that all those tools have code audit process integrated.
Documentation is another necessary service to build up at the very beginning.
- Confluence, tightly integrated with Jira, purchased separately.
- Phabricator, is one of the component of Phabircator, self-hosted.
- Sphinx + readthedocs, is one of the most popular documentation tool available, using reStructuredText, the self-hosted open-source solution privides nicely rendered documentation based on a signle git repository.
- Github and Gitlab also provides wiki but they are all repository based.
- Javadoc, de facto standard.
RESTful API Documentation
- API Blueprint
Development Guide (part of documentation)
Those are nice to have to make the tech team sustainable.
- Getting Started: How to set up the environment, including nesearry tools, databases & other security tokens.
eslintwould ensure your code are well formatted before submission.
- Workflow: What kind of procedure are we going to assign / claim tasks and how to announce its fixed. Also if the team is using
git-flowor other workflow controls.
- Architecture: :)
- Jenkins is no doubt the winner.