Skip to content

Repository ownership and names#2

Merged
Codzaniac merged 1 commit into
masterfrom
repo-owner
Aug 27, 2020
Merged

Repository ownership and names#2
Codzaniac merged 1 commit into
masterfrom
repo-owner

Conversation

@github-learning-lab
Copy link
Copy Markdown

@github-learning-lab github-learning-lab Bot commented Aug 27, 2020

This pull request is about repository ownership and naming conventions.

Challenge question

Does a repository exist at https://github.com/githubtraining/training-manual?

  • True, there is a repository at the given URL
  • False, no repository exists at the given URL

I'll respond when you check one of the boxes above.

@github-learning-lab github-learning-lab Bot mentioned this pull request Aug 27, 2020
2 tasks
@github-learning-lab
Copy link
Copy Markdown
Author

Answer 🔮

A repository does exist at githubtraining/training-manual, but it is private.

gif of repository, pointing to ownership by githubtraining organization, and to a private visibility

Why can't you see it then? Review the Files Changed tab and see if you can figure it out. Expand this text if you'd like an explanation.

Understanding repository visibility

There are three types of repository visibility: public, internal, and private.

Our repository, githubtraining/training-manual, isn't public. It could be internal, which means only members of the organizations that an account owns will see it. Or, it could be private, which means only teams and individuals that have been granted access to it can see it.

This is an example of why ownership structure is important. Otherwise, it can be difficult for members of your team to find and contribute to projects. Having too many disconnected organizations with restrictive permissions isolates each organization's work.

Here are some recommendations based on some ✨ admirable ✨ use of GitHub that we've seen:

  • Use the internal visibility (currently in beta) if you're working on behalf of an enterprise account.
  • Name your repositories meaningfully. Usually a simple project or application name is best.

⌨️ Activity: Review this pull request

  1. Read the additions in the Files changed tab
  2. Approve this pull request (if needed)
  3. Merge this pull request
  4. Delete the branch

I'll respond after you merge this pull request.

@Codzaniac Codzaniac merged commit 0d9aef2 into master Aug 27, 2020
@github-learning-lab
Copy link
Copy Markdown
Author

You can find your next steps in your next pull request.

@Codzaniac Codzaniac deleted the repo-owner branch August 27, 2020 11:03
@Codzaniac
Copy link
Copy Markdown
Owner

Make it discoverable

@github-learning-lab
Copy link
Copy Markdown
Author

Answer 🔮

This repository is the source code for https://services.github.com.

Did you guess it? Probably not, because it doesn't contain many of the necessary elements to make a repository discoverable.

Some suggestions to ensure your teammates can find your repository are:

  • Use a descriptive repository name
  • Give your repository a description
  • Provide a URL for the deployment of the app, or documentation about this project

Discover more about how to make a repository discoverable by visiting the Files Changed tab. It's OK if you want to do this later, any resources we cover throughout the course will be available at the end.

⌨️ Activity: Discoverability

  1. Review the additions about discoverability in the Files changed tab
  2. Approve this pull request (if needed)
  3. Merge this pull request
  4. Delete the branch

I'll respond when you merge this pull request.

Copy link
Copy Markdown
Owner

@Codzaniac Codzaniac left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

GOod discoverablity

Comment thread repo-ownership/README.md
Comment on lines +1 to +5
## Repository Ownership

Who should own a repository? Sometimes, it makes sense for an individual to own a **repository**. Other times, it makes sense for the repository to be owned by an **organization**.

While repository ownership is absolutely about permissions and control, it's also about visibility and discoverability. You can [manage permissions to a repository](https://help.github.com/en/articles/managing-access-to-your-organizations-repositories) regardless of who owns it, but before creating all of your repositories under your own account, consider the benefits of having a more visible owner.
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

good practise

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants