voidpointer11 / github-move Goto Github PK
View Code? Open in Web Editor NEWHome Page: https://lab.github.com/courses/moving-your-project-to-github
Home Page: https://lab.github.com/courses/moving-your-project-to-github
Your repository has no description! Let's add one.
In general, there are two types of files: text files and binary files.
Text files, like most code files, are easily tracked with Git 📖 and are very lightweight.
However, binary files like spreadsheets, presentations with slides, and videos don't work well with Git. If your repository already has some of these files, it's best to have a plan in place before you enable Git version control.
You could choose to remove the binary files, or use another tool like git-lfs (Git Large File Storage). We won't get into detail on how to set up git-lfs in this course, but we will talk about .gitignore
files next, which are key to protecting your code from becoming bloated with binaries.
.gitignore
As mentioned above, there are files you won't want to store in Git. In addition to avoiding binaries, you will also want to keep build artifacts out of your version controlled code. As we convert your project to a Git repository, it should only include the source code necessary to build or compile your project.
To do this, you will create a file in your current project named .gitignore
. When you switch over, Git will use the .gitignore
to determine which files and directories should not be tracked under version control.
A .gitignore
file should be committed into your repository in order to share the ignore rules with any other users that interact with the repository.
Since the files to be ignored are dependent on the language you are using, the open source community has contributed some great templates for .gitignore
files in the github/gitignore
repository.
.gitignore
file. Use a template or create your own.When you are finished, close this issue. I will open a new issue with the next steps. 🎉
🤖 I'm waiting for you to close this issue before moving on.
When you add an issue template and pull request template to your repository, project contributors will automatically see the template's contents in the issue or pull request body. Templates customize and standardize the information you'd like included when contributors open issues. This information can guide contributors to include the information that allows enhancement or bug reports to be reviewed quickly and identify the information that a reviewer would need to succintly review a new pull request.
In Open Source projects, these templates make it very easy for a new contributor to your project to create a bug report, suggest a new enhancement, or potentially contribute a change. By identifying what information the new contributor should provide when creating a new issue or pull request, veteran contributors to the project can easily review and move forward with reported bugs, new enhancements, or contributed pull requests.
Access the Community profile pane
On the Issue or pull request template row, select the Add drop down and select Issue template or Pull request template
Edit the new template file to identify how you want issues or pull requests submitted to your project, for suggestions on what should be included in a template file, read this
Afer editing the template file, scroll down and click the Commit new file button
This is committing your template file directly to
master
.
After using the Community profile pane to create a template file, the option to create the other template file isn't displayed. To create the other template file, perform the following steps:
- Issue templates are named: `ISSUE_TEMPLATE.md`
- Pull Request templates are named: `PULL_REQUEST_TEMPLATE.md`
> This is committing your template file directly to `master`.
Your project doesn't have a README.md
file. A README.md
file is useful for telling other people why your project is useful, what they can do with your project, how they can use it, and more importantly, how they can contribute to your project.
A README
is often the first item a visitor will see when visiting your repository. README
files typically include information on:
Access the Community profile pane
Click the Add button on the README row.
Edit the new README file to describe your projects, using the bullet points listed above ☝️
After editing the README file, scroll down and click the Commit new file button.
This is committing your README file directly to
master
. Normally, you would create a pull request when making changes to your projects, but README files are very important on GitHub.
Having a project already stored locally enables you to move it to GitHub rather quickly. The following activity provides instructions to move your local project to GitHub using various tools. Select the tool you are most comfortable with and get importing 😄.
git init
to initialize the directory as a Git repository.git remote add origin https://github.com/Guillatron/github-move.git
git add .
git commit -m "initializing repository"
git push -u origin master
to push the files you have locally to the remote on GitHub. (You may be asked to log in.)File > Add a Local Repository
, and then navigating to your local repository.Repository > Repository Settings...
and pasting the URL from your repository on GitHub into the "Primary remote repository (origin)" field. Click Save.git remote add origin https://github.com/Guillatron/github-move.git
git remote add origin https://github.com/Guillatron/github-move.git
🤖 Once you push your project to GitHub, I'll provide the next steps in your journey.
A contributing guide provides important information to those who may be interested in helping you with your project. Without a contributing guide, they might not know what you need help with, how they can get started, or how you like to communicate.
Providing the baseline expectations for a contribution to your project makes it much easier for a new user to contribute to the growth and development of your project. Identifying the processes that you expect to be followed when creating contributions to your project helps reduce the hesitation a new contributor might feel when adding a new contribution because what you are looking for in a contribution is well laid out. The contributing guide is helpful for veteran contributors as well, as it provides a reference point for their review if they are contribting to an area of the project they hadn't previously worked with.
Access the Community profile pane
Click the Add button on the Contributing row
Modify your new file with contributing guidelines for your project, for ideas on what should be included in a contributing guidelines file, read this stellar documentation
After editing the CONTRIBUTING.md
file, scroll down and click the Commit new file button.
This is committing your
CONTRIBUTING.md
file directly tomaster
.
Public repositories on GitHub have a Community score. This score is based on the documentation, and how easy it would be for new users to help out and contribute to your project.
Your score is currently 0 and can be seen here.
I've opened up issues for each one of the items that you should take action on, and started a milestone to help you keep track of them.
To continue with best practices for moving to GitHub, close this issue. Don't worry, the milestone will remain open so you can return to it later.
🤖 I'm waiting for you to close this issue before moving on.
Your repository has no Code of Conduct.
Having a Code of Conduct is really important, especially for public repositories. Instead of re-writing the wheel, I want to point you to some of the best instructions around.
Access the Community profile pane
Click the Add button on the Code of Conduct row.
Select a Code of Conduct from the left side of the screen and review the Code of Conduct you selected.
Add information to the displayed fields then click the Review and submit button.
With your file displayed, scroll down and click the Commit new file button.
This is adding your new file to a new branch that GitHub created for you.
With the Open a pull request screen displayed, click the Create pull request button.
If you are ready to merge (or apply) your file to the project click the Merge pull request button. If you want to share this change to your repository with someone, share the URL for this pull request or @ mention them in the comment section.
After clicking Merge pull request, click Confirm merge.
Once the merge is complete (it should happen really quickly) delete your branch by clicking Delete branch.
Your repository is public but there's no License. Licenses are vital in public repositories, because they set the rules for how others are allowed to use, change, and contribute to your project.
Access the Community profile pane
Click the Add button on the License row.
Select a license from the left side of the screen and review the license you selected.
Add information to the displayed fields and click the Review and submit button.
With your file displayed, scroll down and click the Propose new file button.
This is adding your new file to a new branch that GitHub created for you.
With the Open a pull request screen displayed, click the Create pull request button.
If you are ready to merge (or apply) your file to the project click the Merge pull request button. If you want to share this change to your repository with someone, share the URL for this pull request or @ mention them in the comment section.
After clicking Merge pull request, click Confirm merge.
Once the merge is complete (it should happen really quickly) delete your branch by clicking Delete branch.
You have a few options when moving your project to GitHub. This course will expose you to these options, help you choose a path, and then guide you down the path you have selected.
I know some people like to get straight to the point while others like more information. For those who like more information, be sure to check out the drop-downs like this one ⬇️
You may be wondering what this GitHub thing is all about and why you should use it. If this sounds like you, here are a few reasons to make GitHub your project's new home:
To give you the best information, I need to know a little about your project. In the next activity, you will apply a label to this issue to help me provide the most applicable information to help you move a project to GitHub.
For this exercise, use the following table to determine which label to apply to this issue.
If your project is ... | Add the label |
---|---|
On your local machine | local |
On a different website that includes version control | migration |
On another website without version control (e.g. CodePen) | other |
For a printable version of the steps in this course, check out the Quick Reference Guide.
After you have added the label, I will add a new comment to this issue with next steps.
Sometimes I respond too fast for the page to update! If you perform an expected action and don't see a response from me, wait a few seconds and refresh the page for your next steps.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.