Telescope 3.0

[humphd]

Next term we embark on another round of OSD700/DPS911. The new crew is going to be inheriting a fairly large and mature code base, with quite a few things that still need to get done. There are also things I'd like to add.

Lots of issues are filed already, but I'd like to discuss some ideas for the 3.0 release, and beyond. I'm interested to hear from current and former team members about what they'd like to see us do in the new year.

Technical Debt

Here's my "top 10" of TODO items we need to get done:

1. Finish our Microservices migration. We need to be able to delete src/backend and run everything from microservices. Among other things, this will require us to get the Parser service working.
2. Finish the Users service, in particular, figure out our database story for staging and production.
3. Iterate on, and improve the Sign-Up UI. We finished this late in the 2.0 cycle, and I think it still needs some love. I want to see us us it for signing up new users in Sept.
4. Expand the Search service and UI. We have a good base, but there's so much more we can do.
5. Continue to expand and improve the new Dashboard, which is already making it better to work with our deployments
6. Improve our Docker containers to make them smaller, easier to debug, faster to build
7. Build, Tag, and Push our Docker images to a container registry on every build/tag so it's fast to run the app in GitPod, locally, in staging/prod
8. Finish the outstanding bits of the Auth service (e.g., key signing)
9. Finally figure out why Redis sometimes gets corrupted and fix it so it never happens again
10. Make the entire app easier for new people to setup, debug, and develop. There's too much secret knowledge and too many manual steps right now.

New Directions

Here's my list of cool things we should consider doing:

1. React Native apps for iOS and Android, shipped to the Apple App Store and Google Play Store. A lot of students want to work on React, and a lot want to work on Mobile. I think we should experiment with both at once.
2. Cloud migration preparation. I want to eventually move the entire system to the cloud. Doing the work to containerize all of our microservices has been part 1 of this, but we need to think about what the next steps would be. For example, should we be migrating toward Kubernetes? Or, should we be evolving our backend to fit into a set of managed cloud services? How much will it cost us to do this? How should we fund this project? Students want to get more cloud experience, and this is a perfect way for us to let that happen.
3. Deeper integration of GitHub data into our search. We started a bit of this in the UI this term, with new widgets to expose GitHub data for posts. However, I want to go a lot deeper. Every year students hunt for good bugs to fix in open source projects, and we have literally thousands of posts about what was good and what wasn't sitting in our db. We need ways to index and surface this to new students. Which repos have we worked on the most? Which repos tend to merge our PRs? Which ones don't? I'd like Telescope to become a way to discover more opportunities for contribution in the future.
4. Adopting a maintainer's mindset, and starting to think about how we can support the hundreds of upstream projects and tools we depend upon. I'd like to see us contributing code to the projects we use, as a way to support them. One part of this, and connected to 3. could be us surfacing "good first issue" or "bug" or "help wanted" issues from all the upstream repos we depend upon, and keeping track of the impact we have over time (e.g., PRs sent to upstream repos). We need to become maintainers of the ecosystems we are using.
5. Move some of our Microservices to Serverless technologies. This is connected to 2. since the technologies we use here would depend on which cloud we wanted to use. But, we could use something like faasd as a starting point, with containerized functions deployed to k8s or k3s.

What about you?

I'm interested to hear from our amazing community. What do you think we should be doing next? What are your priorities for Telescope in 2022? Please add your thoughts below.

[Andrewnt219]

I don't have OSD700 in Winter, but I'd love to join this ride.

5. Continue to expand and improve the new Dashboard, which is already making it better to work with our deployments

Definitely work in this area.

3. Deeper integration of GitHub data into our search. We started a bit of this in the UI this term, with new widgets to expose GitHub data for posts. However, I want to go a lot deeper. Every year students hunt for good bugs to fix in open source projects, and we have literally thousands of posts about what was good and what wasn't sitting in our db. We need ways to index and surface this to new students. Which repos have we worked on the most? Which repos tend to merge our PRs? Which ones don't? I'd like Telescope to become a way to discover more opportunities for contribution in the future.

This is exactly what I want to do after taking OSD600, so I'll research this as well.

[sirinoks]

Gonna be in DPS911. So far I'm interested in:

3. Iterate on, and improve the Sign-Up UI. We finished this late in the 2.0 cycle, and I think it still needs some love. I want to see us us it for signing up new users in Sept.

9. Finally figure out why Redis sometimes gets corrupted and fix it so it never happens again

10. Make the entire app easier for new people to setup, debug, and develop. There's too much secret knowledge and too many manual steps right now.

3. Deeper integration of GitHub data into our search. We started a bit of this in the UI this term, with new widgets to expose GitHub data for posts. However, I want to go a lot deeper. Every year students hunt for good bugs to fix in open source projects, and we have literally thousands of posts about what was good and what wasn't sitting in our db. We need ways to index and surface this to new students. Which repos have we worked on the most? Which repos tend to merge our PRs? Which ones don't? I'd like Telescope to become a way to discover more opportunities for contribution in the future.

Besides that, maybe:

5. Continue to expand and improve the new Dashboard, which is already making it better to work with our deployments

4. Adopting a maintainer's mindset, and starting to think about how we can support the hundreds of upstream projects and tools we depend upon. I'd like to see us contributing code to the projects we use, as a way to support them. One part of this, and connected to 3. could be us surfacing "good first issue" or "bug" or "help wanted" issues from all the upstream repos we depend upon, and keeping track of the impact we have over time (e.g., PRs sent to upstream repos). We need to become maintainers of the ecosystems we are using.

---

I'm generally interested in small UX changes that will make using the app less of a pain. Since I learned some design stuff before, I might have something to offer in this area.

I'm also all for adding cool things. Assembling, sorting things into clear categories, "cleaning up" one might say.

I have no clue on what to do with docker, servers/clouds, mobile. Personally hate react, so that's a clear no. I'm open to choose a niche which I would specialize in as a general idea. I just want to play to my strenghts and be useful to the project. Perhaps docker doesn't sound that bad if I get to know it? Also, if at any point anything is developed in Go - count me in.

[HyperTHD]

I might not be as active this time compared to last year with my co-op but it's nice to see that there's a few areas that I can contribute in, whether I'm actually coding in or providing mentor support to whoever takes on the issues I'm about to mention:

Search: I worked alot with the search related content and did lots of reviews on the 2 advanced search PRs still up. UI ain't my thing but anything logic related to the search will be fine with me.

Auth: I didn't get to explore key signing as much as I wanted to with the work on the microservices, so this is definitely something to keep watch over. How this will get integrated with the staging and production servers is a whole other story.

Serverless technology and Cloud integration: I have some experience with Azure, although it looks like AWS might be the move. I'm keen to get some more knowledge on this area, such that I might eventually pursue a career in this area. It's very fascinating.

Redis corruption: The one thing that confused me the most working on 2.0 last year. I have a comment on the original post here for anyone that wants to pursue this solution. Ideally, whoever ends up working on the parser service can tackle this since it's sorta related with each other as well as anyone who worked with Redis.

User Service: @chrispinkney been bugging me last year with reviews on this bad boi and he put a lot of work into this, so I have a general idea of how it works including how it's connected with the auth service. If we transition to Supabase, I can help out here wherever is needed.

3.0 doesn't have many big stuff aside from the parser service, user service, auth, cloud based work, and the react native cross-platform work. I actually have worked with making mobile apps using ionic so that along with my love for React should mean that I'd be interested in working there too.

That being said, the only issue that truly matters is getting that TELESCOPE PODCAST UP.

[sirinoks]

The podcast thing is really cool

[DukeManh]

Here's my idea for V3.

Our site does not take full advantage of server-side-rendering. Go to Telescope with Javasript disabled , only the banner shows because posts fetching is done on the client. This is not very SEO friendly, and slow.

React 18 has the new React server component to render components on the server, but, Nextjs's support for it is still Alpha. Plus, to use RSC, we should not have getInitialProps in _document.tsx, we need it for MUI.

We could use getStaticProps and getServerProps to pre-fetch data. However, the way Telescope displays blogs makes it hard to use those: The home page first fetches a post list, each post contains only an id and URL, then each Post component gets a full post object from the URL. If we pre-render this page, the data would be too large (30 posts with full post body). which will slow down rendering.

Moving forward, we should improve how Telescope displays blogs:

• Make the /posts?page=<n> endpoint returns { id, URL, title, published, updated} of a post.
• The Home page will render only a list of blog cards (without post body), sort of like dev.to's timeline.
• Clicking on any post directs us to post/[id] route. The single post page can take advantage of NextJS's incremental regeneration.

If we do this, Telescope will be more supper SEO friendly, without Javascript, the home page shows cached first 30 posts, single post view is pre-rendered. It's also fast.

Not sure if we should do this for Telescope, some people might prefer seeing everything on the first page and don't have to click on a post to read more.

[humphd]

I wanted to add some notes about data mining posts for GitHub data.

One of the big things I hear students talking about is that they have a hard time finding open source projects to work on. To me, this is hard to understand, given that there are literally millions of options. What I think they mean is that they want to find a project that they could work on (i.e., one where they already have the right skills). The truth is, at this stage of one's tech career, you don't have all the skills you need: you're going to have to include some research and learning on any project (even ones you start yourself!). While we can't magically overcome lack of self-confidence, we can provide some data and options. We know that former students have done this successfully (at least I know this). Every one of our students is capable of this, because all those that have gone before were capable of it too.

It would be good to provide some proof of this. Buried in the old posts are hundreds, if not thousands, of pull request links. Once we have a PR URL, we can use it to get all kinds of data from the GitHub API. Here's a sample response:

Sample PR response from GitHub API

[
  {
    "url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347",
    "id": 1,
    "node_id": "MDExOlB1bGxSZXF1ZXN0MQ==",
    "html_url": "https://github.com/octocat/Hello-World/pull/1347",
    "diff_url": "https://github.com/octocat/Hello-World/pull/1347.diff",
    "patch_url": "https://github.com/octocat/Hello-World/pull/1347.patch",
    "issue_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
    "commits_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits",
    "review_comments_url": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments",
    "review_comment_url": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}",
    "comments_url": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments",
    "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e",
    "number": 1347,
    "state": "open",
    "locked": true,
    "title": "Amazing new feature",
    "user": {
      "login": "octocat",
      "id": 1,
      "node_id": "MDQ6VXNlcjE=",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "body": "Please pull these awesome changes in!",
    "labels": [
      {
        "id": 208045946,
        "node_id": "MDU6TGFiZWwyMDgwNDU5NDY=",
        "url": "https://api.github.com/repos/octocat/Hello-World/labels/bug",
        "name": "bug",
        "description": "Something isn't working",
        "color": "f29513",
        "default": true
      }
    ],
    "milestone": {
      "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1",
      "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0",
      "labels_url": "https://api.github.com/repos/octocat/Hello-World/milestones/1/labels",
      "id": 1002604,
      "node_id": "MDk6TWlsZXN0b25lMTAwMjYwNA==",
      "number": 1,
      "state": "open",
      "title": "v1.0",
      "description": "Tracking milestone for version 1.0",
      "creator": {
        "login": "octocat",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "open_issues": 4,
      "closed_issues": 8,
      "created_at": "2011-04-10T20:09:31Z",
      "updated_at": "2014-03-03T18:58:10Z",
      "closed_at": "2013-02-12T13:22:01Z",
      "due_on": "2012-10-09T23:39:01Z"
    },
    "active_lock_reason": "too heated",
    "created_at": "2011-01-26T19:01:12Z",
    "updated_at": "2011-01-26T19:01:12Z",
    "closed_at": "2011-01-26T19:01:12Z",
    "merged_at": "2011-01-26T19:01:12Z",
    "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6",
    "assignee": {
      "login": "octocat",
      "id": 1,
      "node_id": "MDQ6VXNlcjE=",
      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
      "gravatar_id": "",
      "url": "https://api.github.com/users/octocat",
      "html_url": "https://github.com/octocat",
      "followers_url": "https://api.github.com/users/octocat/followers",
      "following_url": "https://api.github.com/users/octocat/following{/other_user}",
      "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
      "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
      "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
      "organizations_url": "https://api.github.com/users/octocat/orgs",
      "repos_url": "https://api.github.com/users/octocat/repos",
      "events_url": "https://api.github.com/users/octocat/events{/privacy}",
      "received_events_url": "https://api.github.com/users/octocat/received_events",
      "type": "User",
      "site_admin": false
    },
    "assignees": [
      {
        "login": "octocat",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      {
        "login": "hubot",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/hubot_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/hubot",
        "html_url": "https://github.com/hubot",
        "followers_url": "https://api.github.com/users/hubot/followers",
        "following_url": "https://api.github.com/users/hubot/following{/other_user}",
        "gists_url": "https://api.github.com/users/hubot/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/hubot/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/hubot/subscriptions",
        "organizations_url": "https://api.github.com/users/hubot/orgs",
        "repos_url": "https://api.github.com/users/hubot/repos",
        "events_url": "https://api.github.com/users/hubot/events{/privacy}",
        "received_events_url": "https://api.github.com/users/hubot/received_events",
        "type": "User",
        "site_admin": true
      }
    ],
    "requested_reviewers": [
      {
        "login": "other_user",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/other_user_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/other_user",
        "html_url": "https://github.com/other_user",
        "followers_url": "https://api.github.com/users/other_user/followers",
        "following_url": "https://api.github.com/users/other_user/following{/other_user}",
        "gists_url": "https://api.github.com/users/other_user/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/other_user/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/other_user/subscriptions",
        "organizations_url": "https://api.github.com/users/other_user/orgs",
        "repos_url": "https://api.github.com/users/other_user/repos",
        "events_url": "https://api.github.com/users/other_user/events{/privacy}",
        "received_events_url": "https://api.github.com/users/other_user/received_events",
        "type": "User",
        "site_admin": false
      }
    ],
    "requested_teams": [
      {
        "id": 1,
        "node_id": "MDQ6VGVhbTE=",
        "url": "https://api.github.com/teams/1",
        "html_url": "https://github.com/orgs/github/teams/justice-league",
        "name": "Justice League",
        "slug": "justice-league",
        "description": "A great team.",
        "privacy": "closed",
        "permission": "admin",
        "members_url": "https://api.github.com/teams/1/members{/member}",
        "repositories_url": "https://api.github.com/teams/1/repos",
        "parent": null
      }
    ],
    "head": {
      "label": "octocat:new-topic",
      "ref": "new-topic",
      "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
      "user": {
        "login": "octocat",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 1296269,
        "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
        "name": "Hello-World",
        "full_name": "octocat/Hello-World",
        "owner": {
          "login": "octocat",
          "id": 1,
          "node_id": "MDQ6VXNlcjE=",
          "avatar_url": "https://github.com/images/error/octocat_happy.gif",
          "gravatar_id": "",
          "url": "https://api.github.com/users/octocat",
          "html_url": "https://github.com/octocat",
          "followers_url": "https://api.github.com/users/octocat/followers",
          "following_url": "https://api.github.com/users/octocat/following{/other_user}",
          "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
          "organizations_url": "https://api.github.com/users/octocat/orgs",
          "repos_url": "https://api.github.com/users/octocat/repos",
          "events_url": "https://api.github.com/users/octocat/events{/privacy}",
          "received_events_url": "https://api.github.com/users/octocat/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/octocat/Hello-World",
        "description": "This your first repo!",
        "fork": false,
        "url": "https://api.github.com/repos/octocat/Hello-World",
        "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
        "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
        "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
        "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
        "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
        "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
        "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
        "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
        "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
        "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
        "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
        "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
        "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
        "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
        "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
        "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
        "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
        "git_url": "git:github.com/octocat/Hello-World.git",
        "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
        "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
        "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
        "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
        "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
        "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
        "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
        "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
        "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
        "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
        "ssh_url": "[email protected]:octocat/Hello-World.git",
        "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
        "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
        "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
        "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
        "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
        "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
        "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
        "clone_url": "https://github.com/octocat/Hello-World.git",
        "mirror_url": "git:git.example.com/octocat/Hello-World",
        "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks",
        "svn_url": "https://svn.github.com/octocat/Hello-World",
        "homepage": "https://github.com",
        "language": null,
        "forks_count": 9,
        "stargazers_count": 80,
        "watchers_count": 80,
        "size": 108,
        "default_branch": "master",
        "open_issues_count": 0,
        "is_template": true,
        "topics": [
          "octocat",
          "atom",
          "electron",
          "api"
        ],
        "has_issues": true,
        "has_projects": true,
        "has_wiki": true,
        "has_pages": false,
        "has_downloads": true,
        "archived": false,
        "disabled": false,
        "visibility": "public",
        "pushed_at": "2011-01-26T19:06:43Z",
        "created_at": "2011-01-26T19:01:12Z",
        "updated_at": "2011-01-26T19:14:43Z",
        "permissions": {
          "admin": false,
          "push": false,
          "pull": true
        },
        "allow_rebase_merge": true,
        "template_repository": null,
        "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O",
        "allow_squash_merge": true,
        "allow_auto_merge": false,
        "delete_branch_on_merge": true,
        "allow_merge_commit": true,
        "subscribers_count": 42,
        "network_count": 0,
        "license": {
          "key": "mit",
          "name": "MIT License",
          "url": "https://api.github.com/licenses/mit",
          "spdx_id": "MIT",
          "node_id": "MDc6TGljZW5zZW1pdA==",
          "html_url": "https://github.com/licenses/mit"
        },
        "forks": 1,
        "open_issues": 1,
        "watchers": 1
      }
    },
    "base": {
      "label": "octocat:master",
      "ref": "master",
      "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
      "user": {
        "login": "octocat",
        "id": 1,
        "node_id": "MDQ6VXNlcjE=",
        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
        "gravatar_id": "",
        "url": "https://api.github.com/users/octocat",
        "html_url": "https://github.com/octocat",
        "followers_url": "https://api.github.com/users/octocat/followers",
        "following_url": "https://api.github.com/users/octocat/following{/other_user}",
        "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
        "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
        "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
        "organizations_url": "https://api.github.com/users/octocat/orgs",
        "repos_url": "https://api.github.com/users/octocat/repos",
        "events_url": "https://api.github.com/users/octocat/events{/privacy}",
        "received_events_url": "https://api.github.com/users/octocat/received_events",
        "type": "User",
        "site_admin": false
      },
      "repo": {
        "id": 1296269,
        "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5",
        "name": "Hello-World",
        "full_name": "octocat/Hello-World",
        "owner": {
          "login": "octocat",
          "id": 1,
          "node_id": "MDQ6VXNlcjE=",
          "avatar_url": "https://github.com/images/error/octocat_happy.gif",
          "gravatar_id": "",
          "url": "https://api.github.com/users/octocat",
          "html_url": "https://github.com/octocat",
          "followers_url": "https://api.github.com/users/octocat/followers",
          "following_url": "https://api.github.com/users/octocat/following{/other_user}",
          "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
          "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
          "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
          "organizations_url": "https://api.github.com/users/octocat/orgs",
          "repos_url": "https://api.github.com/users/octocat/repos",
          "events_url": "https://api.github.com/users/octocat/events{/privacy}",
          "received_events_url": "https://api.github.com/users/octocat/received_events",
          "type": "User",
          "site_admin": false
        },
        "private": false,
        "html_url": "https://github.com/octocat/Hello-World",
        "description": "This your first repo!",
        "fork": false,
        "url": "https://api.github.com/repos/octocat/Hello-World",
        "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}",
        "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}",
        "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}",
        "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}",
        "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}",
        "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}",
        "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}",
        "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}",
        "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}",
        "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors",
        "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments",
        "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads",
        "events_url": "https://api.github.com/repos/octocat/Hello-World/events",
        "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks",
        "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}",
        "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}",
        "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}",
        "git_url": "git:github.com/octocat/Hello-World.git",
        "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}",
        "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}",
        "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}",
        "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}",
        "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}",
        "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages",
        "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges",
        "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}",
        "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}",
        "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}",
        "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}",
        "ssh_url": "[email protected]:octocat/Hello-World.git",
        "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers",
        "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}",
        "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers",
        "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription",
        "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags",
        "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams",
        "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}",
        "clone_url": "https://github.com/octocat/Hello-World.git",
        "mirror_url": "git:git.example.com/octocat/Hello-World",
        "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks",
        "svn_url": "https://svn.github.com/octocat/Hello-World",
        "homepage": "https://github.com",
        "language": null,
        "forks_count": 9,
        "stargazers_count": 80,
        "watchers_count": 80,
        "size": 108,
        "default_branch": "master",
        "open_issues_count": 0,
        "is_template": true,
        "topics": [
          "octocat",
          "atom",
          "electron",
          "api"
        ],
        "has_issues": true,
        "has_projects": true,
        "has_wiki": true,
        "has_pages": false,
        "has_downloads": true,
        "archived": false,
        "disabled": false,
        "visibility": "public",
        "pushed_at": "2011-01-26T19:06:43Z",
        "created_at": "2011-01-26T19:01:12Z",
        "updated_at": "2011-01-26T19:14:43Z",
        "permissions": {
          "admin": false,
          "push": false,
          "pull": true
        },
        "allow_rebase_merge": true,
        "template_repository": null,
        "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O",
        "allow_squash_merge": true,
        "allow_auto_merge": false,
        "delete_branch_on_merge": true,
        "allow_merge_commit": true,
        "subscribers_count": 42,
        "network_count": 0,
        "license": {
          "key": "mit",
          "name": "MIT License",
          "url": "https://api.github.com/licenses/mit",
          "spdx_id": "MIT",
          "node_id": "MDc6TGljZW5zZW1pdA==",
          "html_url": "https://github.com/licenses/mit"
        },
        "forks": 1,
        "open_issues": 1,
        "watchers": 1
      }
    },
    "_links": {
      "self": {
        "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347"
      },
      "html": {
        "href": "https://github.com/octocat/Hello-World/pull/1347"
      },
      "issue": {
        "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347"
      },
      "comments": {
        "href": "https://api.github.com/repos/octocat/Hello-World/issues/1347/comments"
      },
      "review_comments": {
        "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments"
      },
      "review_comment": {
        "href": "https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number}"
      },
      "commits": {
        "href": "https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits"
      },
      "statuses": {
        "href": "https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e"
      }
    },
    "author_association": "OWNER",
    "auto_merge": null,
    "draft": false
  }
]

There is a ton of data here. We could extract a lot of interesting details:

• was it merged? If not, was it closed or is it still open?
• how long did the process take?
• how many reviewers looked at it? (i.e., how large is the community)
• how many comments did it receive? (i.e., did anyone care)
• how big was the change? (i.e., lines of code, files, complexity score of code)
• which repo does it belong to?
• what language(s) does it use?
• does this repo have more open issues? does it have any "good first issue" or "bug" issues we could work on?
• how many people work on this repo?
• is it still active (when was the last commit)?

There's a lot more we can get from the GitHub API, and it would be interesting to slowly add all that. Once we have that data, we can aggregate it to find out:

• which repos have we contributed to successfully?
• which ones have been bad (avoid in the future)?
• which communities are most active in responding to pull requests, doing reviews, and mentoring?
• which of the projects where we've worked before have good issues we could still work on?

This data could be shown in a cool list that is constantly updating, and it would help our students see that a) this is possible; b) there are ways to get involved based on the past.

[cindyorangis]

I was part of the team that shipped Telescope 1.0 (Gatsby era) and I would love love love to see

1. React Native apps for iOS and Android, shipped to the Apple App Store and Google Play Store. A lot of students want to work on React, and a lot want to work on Mobile. I think we should experiment with both at once.

I imagine this as another frontend that would work alongside our Nextjs frontend and both would be interacting with the same backend services. So it would make sense to take care of the backend technical debt before moving forward with this.

Years later and I haven't gotten around to asking about the shape of our Redis and Users service. In particular, are we dealing with SQL or NoSQL tables? I don't know the details because I have this weird phobia of the backend that I'm trying to overcome. We have a Users service that's currently hooked up to Firebase and I believe it's a NoSQL database.

2. Cloud migration preparation. I want to eventually move the entire system to the cloud. Doing the work to containerize all of our microservices has been part 1 of this, but we need to think about what the next steps would be. For example, should we be migrating toward Kubernetes? Or, should we be evolving our backend to fit into a set of managed cloud services? How much will it cost us to do this? How should we fund this project? Students want to get more cloud experience, and this is a perfect way for us to let that happen.

I work with AWS technology and I also hold the AWS Certified Developer - Associate certificate so I can help with this. At the minimum, I will have time to consult the team on best practices in the cloud and what AWS technology/services are available for our use case. I haven't worked immensely on Telescope since we shipped Telescope 1.0 and many things have changed since then so the more information I have on hand about the current state of Telescope and where we want to take it, the better I can make recommendations on our path to the cloud.

[humphd]

I would love your advice designing for an eventual AWS deployment. Ray was saying similar things about being able to advise.

[TueeNguyen]

I sure missed out the discussion. I'll be joining DPS911 and I am more keen on:

1. Finish our Microservices migration. We need to be able to delete src/backend and run everything from microservices. Among other things, this will require us to get the Parser service working.

Since I worked on an issue that related to Parser service and the backend, I'd love to dive deeper into this topic.

6. Improve our Docker containers to make them smaller, easier to debug, faster to build
7. Build, Tag, and Push our Docker images to a container registry on every build/tag so it's fast to run the app in GitPod, locally, in staging/prod

I wouldn't want to miss out on the chance of learning Docker. I've been using it without much understanding

Besides, if possible I'd love to explore more capabilities of React serving different use cases including React Native for mobile. My goal for this term is to try to thoroughly review at least a few PRs, I wasn't an active reviewer in the last term.

There's one thing I'd like to add is an overview of telescope. To be more specific, I think we should have a walkthrough doc or video that explains what are the pieces of code in telescope, how do they come together or even better some kind of software architecture diagram

[LuigiZaccagnini]

I am taking OSD700. Things I am interested to learn/practice are:

5. Iterate on, and improve the Sign-Up UI. We finished this late in the 2.0 cycle, and I think it still needs some love. I want to see us us it for signing up new users in Sept.

I have worked with React Native a few years ago and would like to revisit it here:

1. React Native apps for iOS and Android, shipped to the Apple App Store and Google Play Store. A lot of students want to work on React, and a lot want to work on Mobile. I think we should experiment with both at once.

Always wanted to learn how to work with the cloud so this would be great:

2. Cloud migration preparation. I want to eventually move the entire system to the cloud. Doing the work to containerize all of our microservices has been part 1 of this, but we need to think about what the next steps would be. For example, should we be migrating toward Kubernetes? Or, should we be evolving our backend to fit into a set of managed cloud services? How much will it cost us to do this? How should we fund this project? Students want to get more cloud experience, and this is a perfect way for us to let that happen.

I also wanted to learn Kubernetes

5. Move some of our Microservices to Serverless technologies. This is connected to 2. since the technologies we use here would depend on which cloud we wanted to use. But, we could use something like faasd as a starting point, with containerized functions deployed to k8s or k3s.

One of the things I saw that was cool was creating a podcast! I have worked with a few technologies regarding livestreaming video/audio/chat and might be able to help with this!

[dbelokon]

I am taking OSD700 :D

1. I would like to continue working on the feature regarding aggregation of videos/live streams on Telescope (Feature Request: integrate the Telescope Podcast into the app #1026). It would be cool to see Telescope having this feature.

2. I think we definitely need to improve sign up process because last term, I remember having some weird problem while trying to sign up/sign in.

React Native apps for iOS and Android, shipped to the Apple App Store and Google Play Store. A lot of students want to work on React, and a lot want to work on Mobile. I think we should experiment with both at once.

Recently, I am kind of curious about mobile development, so I would like to try working on something related to React Native apps for Android as well. Just experiment and see how it works.

Deeper integration of GitHub data into our search. We started a bit of this in the UI this term, with new widgets to expose GitHub data for posts. However, I want to go a lot deeper. Every year students hunt for good bugs to fix in open source projects, and we have literally thousands of posts about what was good and what wasn't sitting in our db. We need ways to index and surface this to new students. Which repos have we worked on the most? Which repos tend to merge our PRs? Which ones don't? I'd like Telescope to become a way to discover more opportunities for contribution in the future.

4. Improving search functionality would definitely be important, because it was very sad seeing Dave struggling to find a post on Telescope. I want Telescope to have a better search since it is an essential feature to any website.

Hopefully, we will be able to improve Telescope together 🦾🦾

[tcvan0707]

I am taking OSD700 this semester, and this is what interested me in this term:

6. Improve our Docker containers to make them smaller, easier to debug, faster to build.

I want to have a better sense in Docker, so this is the opportunity for me to learn and have more experiment about this.

4. Expand the Search service and UI. We have a good base, but there's so much more we can do.

10. Make the entire app easier for new people to setup, debug, and develop. There's too much secret knowledge and too many manual steps right now.

1. React Native apps for iOS and Android, shipped to the Apple App Store and Google Play Store. A lot of students want to work on React, and a lot want to work on Mobile. I think we should experiment with both at once.

I always want to go deeper with React, and more importantly, having more experiment in the real project would help me gain more experience.

[Andrewnt219]

we have literally thousands of posts about what was good and what wasn't sitting in our db. We need ways to index and surface this to new students.

Hi @humphd, I want to work on this one. Where should I start?

[humphd]

Probably #2831 is a good starting point.