From the course: Practical GitHub Project Management and Collaboration
Starting your first project - GitHub Tutorial
From the course: Practical GitHub Project Management and Collaboration
Starting your first project
- [Instructor] Let's create our first project and look at some of the options available. I really want to encourage you to do this on your own and follow along with your own GitHub account. Now, projects live in a special section right here on this Projects tab. They can also be associated with a specific repo. Well, let's go to Projects and create a new project. Now, once you hit this New project button you'll get a modal with a few options. Let's go over these main categories. Tables are the classic way to work with projects. It's a little bit like a spreadsheet view with rows and columns. Boards are created in the style of kanban boards, a popular agile methodology structure that is really helpful for getting an overview of a project. Roadmaps are a more traditional project management view, where the timeline is visualized clearly. Now you can easily move between these different views, so don't worry about which one you pick. I'm going to go with the classic table to start with. Now I'll give this thing a name. I'm just going to call it Github Projects, but you can call it whatever you want. I'll hit the Create button, and we'll get a new project with our view set to the table style view. So I'm going to rename this by clicking right here, and I'm just going to identify it as the table view. You may want to call it overview or whatever you want on your project. Now the interface is pretty subdued, but very powerful. At the top, you can edit the name of the project. So you can still click right here, and this will take you to the project settings. To get back, you can hit this arrow right here. Here you can type though a short description of your project, and let's just go ahead and type something in here. Or you can type in an additional README with a lot more details. This is a much better place to put complex things. Notice that you can use Markdown, or you can use the little icons right here. And you can also drag and drop files. So you can add a video or an image to this right here. Here's also where you can make a copy of the current project. If you already have created a project, sometimes it's good to start from something you already started previously, or maybe make yourself, like, a little template project, and make a copy whenever you need a new one. Of course, you can also set the visibility. Usually projects are private, but you may want to create a project that is public, especially on an open-source product. This is where you can also close this project. This will disable the workflows and remove it from the list of projects. And then of course, you can delete the project, which will completely delete the project. So make sure you don't do that unless you really mean to. One thing about working with GitHub is that there's usually no Save button. So as soon as you type something in, you've made a modification to the element that you were working with. Let's go back in the project's settings, and there's just a few little icons here at the top. One of them is to look at the insights, which is sort of like analytics for projects. Before you really enter any data you won't be able to see anything in here, but there's also an additional side panel, so you can open the quick access to the description, as well as the README right here, without having to go to the project settings. There's also a little hamburger menu right here, and you can go to different places within projects. Here's also another way of making a copy. Go to your settings, or maybe take a look at some of the archived items. Whenever you create an item, you can also archive them so you don't see them anymore on this list. And this is a way of looking at whatever has been archived. And you can also get some additional links to documentation, feedback, and what else is new. Now you can create as many views as you need to for a project. We'll get into that in just a bit. Notice that there is a little triangle right here. This is for some additional sort of modifications to the current view. So you can even switch to a different layout by clicking on these different tabs. And you can also see the different configuration settings. So you can choose to group items together. We'll do that whenever we create more items. And then you can also choose to sort things in whatever way you want. From here you can also generate charts, and duplicate this view if you want to make a copy of an existing view. Once you start modifying the views you can actually save them, so that you can see the same data in different ways. There's also a place here to filter the available list. Right now there's nothing in here, so if you start typing you wouldn't see anything. But if you had a bunch of items, this is a quick way of finding things. Once you have filtered items, you can also save that as the current view. So if you want to look, for example, for, maybe items that begin "pull request" or anything else, then that view can be saved, and the current view will only show those items. That's quite useful, and you'll see how, when we create multiple views, we can create views showing only the information that we want. Now here you can see the place where you can add additional items. Now items can be tied to a specific repo, but it can also be draft items. That's a place where you can brainstorm ideas for your project. Let's add a task to create a repository for this project. Now you can hit Control + Space, but on a Mac that's usually tied to something else, so you may have a little bit of problem hitting that, but you can just also click on the item and start typing. So we'll add a Create a Repository task for this project. And I'm just going to hit Tab. That creates the repository. Notice that it automatically moved to the next column. And from here I'm going to click right there, and assign myself to this task. And I can even add a status. So my status can be Todo, In Progress, and Done. And I can add additional statuses if I want to. So I'm going to click Todo for right now. So that means that we have created our first draft, we assigned it to ourselves, and we also looked at the general interface. Let's keep going.
Contents
-
-
-
Projects vs. classic projects2m 54s
-
Starting your first project6m 27s
-
Project settings and fields5m 36s
-
Using view categories5m 51s
-
Converting drafts to issues6m 7s
-
Assigning items to collaborators6m 18s
-
Starting a project with an issue5m 56s
-
Project items with pull requests5m 28s
-
Using saved replies1m 51s
-
-
-