WSO2Pedia: A knowledge base for the WSO2 technology stack

Chanaka Fernando
WSO2 Best Practices
3 min readMar 1, 2021

--

A GitHub repository that collects WSO2 resources on the internet

Motivation

Having a lot of resources about a specific topic on the internet is great. At the same time, it is challenging and becomes a bottleneck when we need to find something quickly. Sometimes having the required information in one place where we can easily find the relevant details helps to get things done easier.

A good 20 years ago, Microsoft Encarta was one of the most popular digital encyclopedias used by many of us as students and I loved every bit of it. It was the Wikipedia of that age. It helped us to find what we need in our studies in real quick time without much hassle.

Source: https://www.wikiwand.com/en/Encarta

I started using GitHub for storing most of my writings, diagrams, and development work (source code) some time ago and fell in love with GitHub ever since. With that experience, I felt that if I can use GitHub to collect the relevant information about a particular topic, that can help many others.

WSO2 is an open-source technology provider with many open resources available on the internet to use the products. WSO2 has a great culture where people write a lot of articles about their experiences. Given below are a list of areas they write about

  • Product features
  • Tutorials (how-to guides)
  • Best practices
  • Solution Architecture
  • Code examples

Not only WSO2 team members but also the partners and open source community users write a lot of content around the technology stack and how to use it in the real world. Sometimes, these resources are more comprehensive than the official documentation due to the fact that these resources discuss a particular topic at a very deep technical level which we cannot expect from general documentation.

Approach

Along with the successful experience I had with GitHub, the memory of Encarta, and the amount of information scattered across the internet about the WSO2 technology stack, I thought of creating a GitHub organization to collate all different resources into one single place. Even though I’m not sure about the success of this project, I thought of giving it a go so that at least I can get the benefit out of this when I need to find some frequently used resources about WSO2. You can find the link to the GitHub organization below.

I have created different repositories within the organization to capture different types of resources. At the moment, the following repositories are created to get started.

Caution: Some of the links in these repositories may not work with the latest products. But most should work. If something is not working as explained in these resource links, you can get help from WSO2 via the official support channel or Slack channel.

Contributions

This is just the first step in creating the “WSO2Pedia”: A knowledge base for the WSO2 technology stack. If you have some resources that you think need to be included here,

  • fork the repo (e.g. code examples)
  • make a clone,
  • add your changes and
  • send us a PR

We will review the changes and make sure they go into the repository in the correct manner.

That’s all for now.

--

--

Chanaka Fernando
WSO2 Best Practices

Writes about Microservices, APIs, and Integration. Author of “Designing Microservices Platforms with NATS” and "Solution Architecture Patterns for Enterprise"