Telescope: Up and Running

Yes, Telescope is ready to start taking its first steps!

After a couple of weeks of hard work, Telescope has finally become a functional piece of software. All the elements, or I should say all the effort made by all the contributors, was finally put together and now it is possible to run telescope and see it do what it was created for.

This is really awesome, seriously. Running Telescope and being able to read posts on it is amazing. Here, take a look:

This has been so far a really awesome experience. The learning process, the collaboration, the enthusiasm from all the people involved... I'm very happy that this project exists, and I'm even happier that I'll be able to keep working on it.

As I said, the last couple of weeks were crucial to be able to get to where Telescope is right now. The components responsible for fetching feeds, process and store them in our database were connected to the front end through our web server, using 2 endpoints that I added. I had a lot of fun adding those 2 endpoints and tests for them. I had to learn about how to implement paging and adding link headers to the server's response, and a little bit of redis, which were both completely new to me, and added valuable knowledge to be used in the future. I also had the chance to get involved with the docker side of the project. 2 awesome contributors worked hard to add redis and SAML2 support to our docker workflow, and I was fortunate enough to have the chance to add some suggestions and comments here and there.

I think I have a better understanding of how redis and SAML2 can be incorporated to a project, and although I've worked with docker before, I feel more confident about using it now. That's also another part of this project that makes it so valuable. I started contributing to Telescope at the very beginning, and just by reviewing other people's work, I had the chance to learn so many new things. As an example, before telescope, my relationship with CI was almost non existent, but just by reading other people's code, their comments, and following all the steps they had to go through to add CI to Telescope, I'm ready to start adding my own contributions in this area. That right there is invaluable experience for my future in this industry.

So there it is, Telescope is really getting there. Yes, bugs will come up, adjustments will have to be made, but it is ready to see it work and do what it's meant to do. Isn't it exciting?

Good hacking and have fun!

Read More

Telescope: Quick Update

Telescope keeps growing, and soon we'll have to start thinking about putting all the pieces together.

Not much has happened lately in terms of new features or important milestones. I started researching how to use docker on Windows to be able to add all the steps to the documentation for contributors who use Windows as their main system (my condolences to you all), and soon I'll be adding 2 new endpoints to the back-end so all the pieces responsible for processing feeds will be connected to our database. I think it'll be an interesting and challenging task, but I'm really looking forward to it.

Oh, something interesting happened. Our CI broke, and the reason was the most unexpected one. It's not that our CI hadn't broken until this week, but it was always us. We've had problems with Windows CRLF, file paths, not mocking tests, but it was always us. But this week, a new version of node came out, and for some reason it broke all our tests. We managed to fix it by making our CI use the LTS version of node, but for someone like me who barely works with web technologies, this was very unexpected.

And that's pretty much it. In a few weeks, we might have all the different pieces working together and maybe it'll be time to start testing telescope as a whole. I can't wait for it!

As usual, good hacking and have fun!

Read More

Telescope: growing faster than expected

Telescope has been alive for 2 weeks, and its development couldn't get more exciting!

I mentioned in a previous post how the project seemed to be a bit chaotic at the beginning, mostly because of the number of people involved in it and the different sets of skills and experience that each contributor has.

Well, that was last week. This week, we have a very enthusiastic group of developers exchanging ideas, offering help, being passionate about their contributions, and all that with a surprising level of organization completely unexpected (at least to me) for a group this big, and we're taking about between 50 and 60 people. As I said before, it's been fascinating to watch it grow, and I couldn't be happier to be part of it.

But there's more. At a personal level, I've been able to contribute to many parts of the project, and in may different ways! Back-end, containers, documentation, testing, CI... all that in just 2 weeks! In some cases, I added features that will enhance the capabilities of the project, in others I just made small changes or suggested someone a different approach for what they were working on. It's been a very enriching experience because not only I had to review and refresh previous knowledge to be able to offer some help, but also I had to do a significant amount of self-teaching so I could take on certain issues and complete some tasks.

So far:

• I added a tool to fetch data from Github, usign GitHub's API
• Implemented tests for that tool, using mock responses
• I tweaked our .eslint a little bit
• I fixed some linting errors
• And I tried to add husky to the project, but another contributor did a way better job, so it was better for the project to prioritize his pull request over mine

Also, I reviewed other people's contributions, I collaborated with other developers to add docker to the project and write documentation about how to use it, I gave some advice about how to add tests using mock responses... and this is only the beginning! In the next 2 weeks, I'll be able to do some more work, and the best part is that even if I'm not directly involved in some part of the project, I'll be able to review or at least take a look at what others did to solve some problem and learn a lot from it. What else could I ask for?

The only downside of all this is that I got a bit too distracted and I didn't contribute to another projects, as I was hoping to. My plan was to work on a PenguinV's issue, but since I didn't, I'll try to get it done this week, and hopefully take on another PenguinV's issue next week.

As usual, good hacking and have fun!

Read More

Telescope: A tool for tracking blogs

Have you ever heard of PlanetCDOT?

Well, PlanetCDOT "is a collection of current blog posts by students, professors, and researchers at the Seneca Centre for Development of Open Technologies and related organizations around the world", and it has been around for a long time. The technology behind PlanetCDOT is Planet, "a feed aggregator application designed to collect posts from the weblogs of members of an internet community and display them on a single page", and according to the planet index page, it hasn't been updated in 13 years.

The good thing about software that hasn't been updated in more than a decade is that there's plenty if not all of the room for improvement, and now there's a project going on to create a new aggregator for PlanetCDOT.

This project is Telescope, and It's hard to describe what it is right now since what we have is a varied group of developers, with different set of skills, trying to put together a fairly complex piece of software. It started as a disjointed mess, but it's been fascinating to watch how the people involved in it started to file issues, submitting pull requests, reviewing other people's work, discussing approaches, all in a very organic and natural way,

I'm one of the lucky ones working on this project, and so far it's one of the most interesting collaborative experiences I've ever had. I must confess that I spend hours just watching the project grow, keeping track of how others review code, suggest solutions, help each other... and with watching I mean literally staring at the issue and pull request trackers to see the new additions. As I said, it's truly fascinating.

At the early stages of the project I thought I wanted to take care of .env files, using dotenv, but someone was faster than me and already solved that problem. My current intention (hopefully I'll be able to take care of this before someone else does) is to create a module that will fetch information related to a specific github repository/pull request/issue using GitHub's API. I have some experience with it, and since someone suggested that it could be a good addition to the project I thought it was a good fit for me.

I'm aware my description of Telescope is very vague, but I'd like to wait until a few more pieces get merged to the project, adding more functionality, and then I'll give more information about the features we'd like Telescope to have, and how the contributors are coming up with creative and interesting solutions.

Being part of Telescope is great, but I'd also like to work with other projects, and since my collaboration to PenguinV was welcomed, I think I'm going to try to take on another issue of theirs. This one is going to be tough!

As usual, good hacking and have fun!

Read More

Hacktoberfest: Documentation

We're in the last week of Hacktoberfest!

So far, participating in Hacktoberfest has been great. I've been able to contribute to very different projects and work towards the goals I had set for myself.

My work on Dashboard allowed me to improve my web skills (not as much as I'd have liked, but still) and collaborate in a project that has been around for some time. It's not a big project, but it's a very interesting one because of all the different components that it has and how useful it is for the people involved in it.

PenguinV was my chance to collaborate in a project that I really like, and also a great opportunity to face a real, scary challenge. Having to contribute using OpenCL, something I wasn't familiar with at all before, was one of those things than can easily make you think that you shouldn't be in this field.

For my last contribution, I wanted to work on PenguinV again, but since we're at the end of the month and the PenguinV community hasn't responded (yet) when I told them that I wanted to work on some issues, I decided to look around to see if I could find some other interesting projects.

And I found ImCompressor. ImCompressor is an image processor that works with lossy and lossless compression. What I found interesting about this project is the fact that it's a very young one. A small group of developers started it a month ago. All my other contributions during Hacktoberfest were related to bigger projects that have been around for a while, so I thought it could be interesting to contribute to a young project and maybe become a core part of it. 

When I found the project, they were getting ready to release version 0.8, so since there wasn't much that I could offer (remember, it's a very young project), I mentioned to the team that my first language is Spanish and that I could add a Spanish translation. They welcomed the idea, and I thought it was a good way to introduce myself, getting familiar with the project, and keep an eye on new issues popping up so I could work on them and become a main contributor.

Oh, before I forget, when I started the translation I realized the ImCompressor team uses Poedit, a cross-platform, open source, translation editor. Another interesting project, I also want to keep an eye on it and maybe see if I can contribute to it in the future.

I like ImCompressor. I've had issues with lossless JPEGS in the past, and I think this project could help many people. I hope it won't turn out to be one of those many projects that dies a few months after being born.

Well, and that's all for this month. As I said in another post, I really want Hacktoberfest to become a yearly tradition, but not the only excuse to keep collaborating with open source projects.

As usual, good hacking and have fun!

Read More

Hacktoberfest: WIP

Hacktoberfest, week 3.

Only a few days left, and I just submitted my third PR.

I was considering giving home-assistant another go, as I mentioned in my previous post, but there are so many issues out there that I thought that maybe it wasn't worth it.

For my first issue, I enhanced the capabilities of CDOT's Dashboard, and I decided to take on the next related issue for that part of the project: update the front-end.

I updated the front-end with a new panel that shows pull requests that are pending for review. Hopefully this new panel will help the team keep track of pull requests and it'll speed up the workflow.

One of my goals for this Hacktoberfest was to improve my web development skills, and this issue was going to be my opportunity to do that. Unfortunately, it didn't turn out the way I was expecting. I spent very little time writing React and most of the time doing CSS. Yes, it gave me the the chance to learn some new CSS tricks, but it also helped me remember why I've been putting off improving my web development skills and why I've always thought that CSS is a creation of the devil.

Dashboard with the new panel

My pull request has been accepted and merged, so I'm expecting to see the new panel up and running any time soon (to be honest, that's very exciting!).

So far, Hacktoberfest has been a really enjoyable and amazing learning experience, and I'm almost sad that it's going to be over in a week. I really want it to become a yearly tradition, if time permits.

As usual, good hacking and have fun!

Read More

Hacktoberfest: enhancement

We're in week 2 of Hacktoberfest, and things are going well so far.

After submitting my pull request for Dashboard, I was planning to start working on home-assistant, as I mentioned in my previous post, but it seems that the only way to get their development environment to work is using docker. I've used docker before, in fact, I've had epic battles with docker over iptables, so I decided that I was going to try something else.

That something else is penguinV, "a simple and fast C++ image processing library focus on heterogeneous systems. The library is designed with an idea to have simple common API for CPUs and GPUs simplifying developer's work on context switching between devices".

I was very excited about working on this project because it was the perfect opportunity for me the get familiar enough with its code so I can start contributing to it in a regular basis soon. I chose this issue because it seemed both challenging and doable. I wanted to work on something "real", not related to documentation or fixing syntax, but at the same time, something not too overwhelming so I wouldn't be able to finish it.

The issue was about implementing something that would compare 2 images. Sounds easy, right? Well, yes and no. I've done image processing before, things like loading images from disk without using libraries, implementing  alpha blending, rotation and inversion... but for this issue I had to work with OpenCL, and that was the challenging part. OpenCL uses parallel computing and run-time compilation, and yes, for someone who's not a very experienced programmer and has never used OpenCL before, it is as scary as it sounds.

I was very lucky that the penguinV community is very active, and as soon as a I had questions they put me in the right direction to be able to complete the task. I submitted my pull request and I made some minor changes requested by the reviewer.

This was an amazing experience. I would really like to keep contributing to penguinV and I'll probably use it in my current projects.

So, home-assistant next week? We'll see.

Read More