Home | Blog | ARK Among Top 50 Projects in Google Season of Docs Program
Kristjan Košič
Reading time: 5 min
Date: 8th May 2019

ARK Among Top 50 Projects in Google Season of Docs Program

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.

Related material:

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.

Related material:

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.

Related material:

Project 5 — A Step-By-Step Guide On Building Plugins/dApps

A plugin is a very powerful concept inside our Core blockchain platform. It is used by our development team as well as our partner projects. Plugins give you the ability to develop your own applications, and deploy them on the blockchain. Plugins are a typescript/javascript application and are only limited by your imagination (starting your own http server, develop a shop, an ecommerce plugin, a new website). Your task would be to evaluate current core-plugin documentation and use it to write a custom plugin (like sending an alert, a notification, …). You would use the developed example and lessons learned during the process to develop a detailed step-by-step guide for plugin development, supported by accompanying example.

Related material:

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.

Related material:

Final Thoughts

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.


Stay up to date
By submitting this form you agree to receive email updates. Find out how we process your data here.
Visit our download page to learn more about our latest releases
2021 © ARK.io | All rights reserved An ARK.io Product