ARK was accepted among nearly 200 projects that applied for Google Season of Docs program. We are very proud to be among 1 of 50 open source organizations chosen to participate in the inaugural year of this program. Looking at the list of accepted organizations , we are the only blockchain related platform that made it in.
This initiative will allow aspiring technical writers to hone their skills in the art of technical writing, as well as helping to evaluate and improve our documentation. You will be able to to work tightly with the ARK Team and our large technical community. ARK has always felt a huge amount of pride with our Open Source approach and we feel that participating in Open Source programs such as GSoD is not only important for ARK, but also for the wider Open Source community.
ARK and GSoD program
ARK would like to provide a technical writer the opportunity to work on an open-source blockchain project that utilizes cutting edge technology combined with a very vibrant and active community. With various ARK Core milestones recently completed and a plethora of new technology to uncover, there is no shortage of technical documentation, for both evaluation and writing, related to our slate of products and services.
We are looking for a new technical writer, that is flexible, understands technology in terms of scope, development, has the ability to write developer tutorials supported with examples, and can also help with basic user application guides. GSoD program gives us the ability to open our doors even more and potentially find a new member (technical writer/developer evangelist) of our distributed team.
How do we work?
Our documentation is available at . Everything can be found there and also on our Blog. Documentation is a central point for Exchanges, Developers, Node Operators and blockchain enthusiast in general, allowing them to find information and build solutions on top of our blockchain platform. Documentation is based on VuePress, meaning that our docs are written in
markdown language, making it easy to jump on and start collaborating from everywhere.
Documentation is open-source and its source code can be found here: https://github.com/ArkEcosystem/docs/
Just follow the
Readme.md instructions and you will have your documentation project setup in a matter of minutes.
We also prepared initial guidelines on How to Start Writing Documentation for ARK .
Depending on the ability of the technical writer, we would like to provide the following projects (but are not limited to only them):
Project 1 — Getting Started With Core Blockchain Development guide
Getting started with new technology is always a challenge and a learning curve. The first wall you hit as a developer is usually establishing a working environment. As a technical writer you can check, evaluate and improve our current getting started guide, or provide one of your own. Always have a bigger picture in mind, like the positioning of the guidelines in our overall documentation structure, adding of new content, linking existing stuff and of course be creative.
Project 3 — ARK As #1 IoT Blockchain Platform
ARK, being a light and very flexible blockchain platform, targets IoT development as one of the most important parts of its technology stack. We provide tools and services to develop light applications running on various boards, and by using our blockchain platform as a backend. This gives you the ability to focus on your application, while we handle the rest. We already provide a scope of IoT hardware support and the related tutorials needed to play/understand them. Your task here would be to replay and improve them, and later on add new IoT examples based on your own ideas.
Project 4 — A Step-By-Step Guide On Using Webhooks to listen to blockchain events
From the release of ARK Core 2.0, we included webhooks as a means for developers to subscribe to blockchain events and use this approach in their applications. As a writer, your starting point would be evaluating the current documentation part on this topic and expanding on it with a complete step-by-step guide outlining the webhooks setup and usage process supported with a simple example of your choosing.
Project 5 — A Step-By-Step Guide On Building Plugins/dApps
Project 6 — A Step-By-Step Guide On Building Custom Transactions
In a future ARK Core release we are introducing AIP 29, codename GTI (“Generalized Transaction Interface”). GTI enables developers to introduce custom transaction types with ease. New base classes for transactions are going to be introduced. This will allow us to develop new transaction types by using skeleton designs. Making new transaction types will become easier, standardized and will give developers instant options to implement new transaction types supported with all blockchain logic (cryptography, security, validation and verification). Your task would be to familiarize yourself with the specifications and concept and develop a new custom transaction type. You will be guided and directed by our team and the final result would be a detailed step-by-step guide on how to develop custom transaction types with our blockchain platform.
These are just some of the cutting edge projects we are working on. For each of these projects, we are focused on making our documentation more user friendly and more approachable to the wider technical and developer community.
We are looking forward to working with all technical writers and technically gifted people. We promise to support and assist you getting acquainted with our technology. Together, we will work in synergy to complete the tasks agreed by both parties.
At the end of GsOD program, if your heart still beats faster when you work with our technology, then consider applying for an open position of a technical writer/developer evangelist.