Coinbase.com is a powerhouse platform dominating the world of DeFi. I know, old news. I was hired by CB to help update internal docs and Salesforce architectural diagrams for their new engineers. Empowering new employees to onboard themselves is trendy and required for growing empires such as Coinbase. My approach is to make docs and diagrams engaging. Heck, even colorful when appropriate. Here’s a diagram in production. Over the years I have moved from white backgrounds in my diagrams. Easier on the eyes for hard-working devs and product owners.
The Epic Games Store is a world-class powerhouse with 150+ million global users. They hired me to review and rewrite 120+ game developer API docs. Then plunge into the SDK docs. There’s multiple users involved in these API docs: game developers and the users that buy those games from the Epic Game Store. Docs were written in Markdown [docs-as-code]. I used a minimalistic API doc template for all new docs. Slack conversations with devs solved doc blockers. Below are a handful of my Epic Games work.
Company X (German API trading platform) products are designed to enable German users to trade fractional shares of US financial products (S&P 500) in the EU via APIs. They hired me to write new API docs for European Securities and Markets Authority API endpoints. Much of my time was spent writing API docs for EU KYC and German MiFID II identity compliance. Docs were written in Markdown [docs-as-code]. Slack conversations with devs solved doc blockers. We used Linear for API doc management (great free tool).
TowerData.com is one of the largest email API services in the US. They hired me to rebuild their API documentation UI after testing all endpoints. Also update their SDK docs. I built a three-column UI (Ruby | Slate | Markdown) to host the new docs. Editing the CSS codes to match the TowerData brand colors were vital to this project being a home run: docs.towerdata.com. Below are details about the project.
ShipEngine.com is the granddaddy of e-Commerce shipping APIs. Need 10,000 shipping labels now? No problem, easy with ShipEngine. But the project was a bulldoze of all published (dead wrong) API docs. The target users for ShipEngine API docs are new API users, e-Commerce companies, and seasoned devs. Workflow was ideal and a pure [docs-as-code] formula writing in Markdown and Atom connected to a ShipEngine repo. I tested endpoints and received help from devs via Slack. Daily video chats with devs on endpoint use case blockers. Some of my ShipEngine work is below.
WEXinc.com is a global payment processor of virtual credit card transactions used by Expedia.com, HotWire.com & Priceline.com. A few other thousand customers enjoy the one-time-use card numbers. I was hired by WEX Bank to document a new payments product and build a new API docs UI. I built the UI with Ruby, Slate, Markdown. The target users were bank developers in need of onboarding docs for new users.Here is the screenshot of the new UI.
TON.org is a third-generation proof-of-stake blockchain organization. The crew at TON are super nice people and fast movers in the blockchain world. TON is capable of handling millions of transactions per second. Their Toncoin is a game-changer along with their dapps and apps. They hired me to buff up and humanize their FunC help guides. Below are some examples of my work.
Dev docs and screenshots are tough on busy eyes. When the rare time a screenshot is needed, use GIFs. 10 second fast ones fine-tuned for speed are best. For new platform users, a quick GIF gets technical concepts across visually. Some API platforms are using GIFs, but not many. Are you? They’re easy to screencast record and convert to GIFs. Here’s one I did as an example for this portfolio.
Fortellis.io (CDK Global) connects app developers with the automotive industry. They hired me to write their integrated API design standards for a public automotive API platform. Docs were published in both Apigee SmartDocs and Drupal. Below are examples of my work at Fortellis.
Apache.org is the gold standard in big data. I was hired to write their Apache Sparke white paper on Apache Spark. It was a great project combining technical docs with a hint of marketing. The target users were analysts interested in learning about SparkSQL, Spark MLib, and SparkR. Below is the my finished version.