Skip to content

Home

Jump to bottom
YLcoding edited this page Jun 12, 2020 · 13 revisions

Welcome to CartoGraphX!

Codacy Badge Maintainability Test coverage E2E Tests Unit Tests Release

What is CartoGraphX?

CartoGraphX is a combination of a VS Code extension and a web application that provides software development teams with a way to visualize their coding projects! Our software utilizes the files in a project in order to create a map that helps developers understand the relationships between the files they are working in much like the one displayed below:

CartoGraphX keeps track of where team members are working and updates automatically to reflect changes made to files in VS Code

Give CartoGraphX a try!

Development: To get started, all you need to do is clone this repository and then run "npm install" to install and update the packages required to run the site. To open the site, you must open index.html.

Running the web app: Follow the steps in the development section above to run the web app and see your changes reflected. You can then log in using the account you've created in the VS Code Extension. You will then be able to view maps you've created by using the team map ID code specified in the extension.

Features:

CartoGraphX users are able to sign into the sign in using an email address and password created through the exentension.

When signed in, a user can delete their account, sign out, or display one of their project maps using an existing team map ID.

Want to help? Prepare yourself to be a part of the team!

How do you feel after using CartoGraphX? Maybe you like it a lot! You might also think there is still a lot of room for improvement. If you see the potential of our project idea and willing to help to improve the product, we are more than welcome!

In order to prepare yourself before writing your first line of code for CartoGraphX, or even look into the code, it's important that we are all onboard on the design decisions and visions we had on CartoGraphX.

Here is a list of project artifacts that will help you understand these visions!

Write your first line of CartoGraphX code!

After getting a firm understanding of our product visions, it's time to write your first line of CartoGraphX code! yay! However, contributing to an open-source project codebase will never be easy, especially if you have no experience in VS Code Extension development. It's important to understand what is in each file and how they work to gather to make up the features we have so far.

But no worries, we got you covered! We have carefully thought about how to bring a new developer onboard. Following is a helpful process you want to follow:

  1. Check out the Codebase Tour to understand the structure of our codebase!
  2. Use Developer Onboarding to understand how to set up the dev environment before writing the code.
  3. When you writing the code, make sure to follow the Style Guidelines and comment your code using Comment Guidelines!
  4. Read ourAPI Document if you need to make any API call to the firebase backend.
  5. Fork the CartoGraph repo using our Git Guidelines and make your changes there!
  6. TEST is very important! Write your test for your code ALWAYS using these two guidelines (Write Unit Tests and Write E2E Tests).
  7. When you tested your code and ready to merge your code to master, please follow the Create a Pull Request guidelines for your pull request!
  8. Review your code and review other people's code will help everyone! Using our Code Review Guideline to do code review for the pull request!

Improve our build process

We have Github Actions CI/CD pipelines that are running 24/7 to protect the integrity of codebase and make sure all the features of our app are always working. Just like the codebase, the pipeline also could use some help for improvement.

To understand how our build pipelines work, please read following document:

Feedback and Suggestion

Join our Slack channel to reach out to us for any feedback and suggestion!

Welcome to CartoGraphX!

CartoGraphX is a combination of a VS Code extension and a web application that provides software development teams with a way to visualize their coding projects! Our software utilizes the files in a project in order to create a map that helps developers understand the relationships between the files they are working in much like the one displayed below:

Insert image of map view

CartoGraphX keeps track of where team members are working and updates automatically to reflect changes made to files in VS Code

Who is CartoGraphX for?

We created CartoGraphX for software development teams. Our application is intended to help foster and grow a team environment through the use of code visualization.

Why do you need CartoGraphX?

How long do you spend trying to understand the files in a project before you actually begin working?

A visualized map of the source code rather than a high level description design document might make your life easier…

How long do you spend trying to understand code you didn’t write?

Knowing exactly who worked on which file and when would be nice wouldn’t it? We did that for you.

How often are you actually collaborating with your team in a remote setting?

Our platform allows you to take full advantage of your teammates, increasing general productivity.

What Inspired CartoGraphX?

Like any solution, CartoGraphX is a response to a problem, or rather a series of problems. The developers here at CartoGraphX got inspiration both from issues that have been affecting software development teams for a long time as well as other problems that have recently come to light with our current global situation. The problems that CartoGraphX hopes to mitigate are:

  1. Developers often don’t understand the full scope of the projects they work on. Instead, they focus just on the area of the project where they write code and don’t pay much attention to the rest of the project. This is problematic because developers today are essentially trying to solve a problem with partial information. Our map provides software teams with an easier way of understanding the full scope of a project.

  2. Remote work has led to a lack of accountability where developers are left to manage their own time without much supervision. Additionally, with people now having to work from home, there are many more distractions that lead to a fall in productivity. In order to address these issues, our platform keeps track of where coders are working in real time. It places software developers on an “idle island” if code is left untouched for enough time when they should be working. This helps software developers to remain on task as seeing what their peers are doing will help them to maintain accountability. At the same time, this also helps team managers to monitor their developer’s behavior as well as help them to assess team progress throughout the development cycle.

  3. Software developers often have a hard time resolving bugs because they deal with code they didn’t write and therefore don’t completely understand. Our map keeps track of who worked in each file. This means that if a coder runs into an issue in a file or area of the program they don’t fully understand, they can easily see who worked on these files last and can contact them to get help!

  4. Remote working has decreased team interaction further because people are no longer forced to see each other everyday. This is problematic because it affects team morale and reduces team communication in general. CartoGraphX aims to help keep teams connected by providing a platform where teams can work simultaneously.

npm module

Clone this wiki locally