Add content to git hook and readme sections (#6603)
parent
f30772d330
commit
a3682f3d37
10 changed files with 79 additions and 10 deletions
@ -1 +1,7 @@ |
||||
# post-checkout |
||||
|
||||
Git post-checkout hooks are scripts that run automatically after a successful `git checkout` operation. These hooks provide a way to customize Git's behavior and perform specific actions when switching branches or updating the working directory. Post-checkout hooks can be used for tasks such as updating dependencies, regenerating files, or adjusting project settings based on the newly checked-out branch. They offer developers a powerful tool to automate workflows and maintain consistency across different branches in a Git repository. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@Post-checkout hooks](https://git-scm.com/docs/githooks#_post_checkout) |
@ -1 +1,7 @@ |
||||
# post-update |
||||
|
||||
Git post-update hooks are scripts that run automatically after a successful push to a repository. These hooks are executed on the remote repository and are typically used for server-side tasks such as updating other services, triggering continuous integration processes, or notifying team members about changes. Post-update hooks provide a powerful mechanism for automating workflows and maintaining consistency across different parts of a project's infrastructure, making them an essential tool for streamlining development processes and enhancing collaboration in Git-based projects. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@Post-update hooks](https://git-scm.com/docs/githooks#post-update) |
@ -1 +1,8 @@ |
||||
# PR from a Fork |
||||
|
||||
Creating a pull request from a fork on GitHub is a common workflow for contributing to open-source projects or collaborating on repositories you don't have direct write access to. After forking the original repository to your GitHub account, you can make changes in your fork, commit them, and then create a pull request to propose these changes to the original repository. This process allows project maintainers to review your contributions, discuss any necessary modifications, and ultimately merge your changes into the main project if they're approved. It's an essential feature that facilitates collaboration and code review in distributed development environments. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@Creating a pull request from a fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) |
||||
- [@video@How to Create a Pull Request from a Fork on GitHub](https://www.youtube.com/watch?v=a_FLqX3vGR4) |
||||
|
@ -1 +1,8 @@ |
||||
# PR Guidelines |
||||
|
||||
Pull Request (PR) guidelines are essential for maintaining a smooth and efficient code review process in collaborative development environments. These guidelines typically outline best practices for creating, formatting, and submitting PRs, ensuring that changes are well-documented, easy to review, and align with the project's standards. They may cover aspects such as PR size, commit message formatting, documentation requirements, and testing expectations. By establishing clear PR guidelines, teams can streamline their workflow, improve code quality, and facilitate effective communication among contributors. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@Best practices for pull requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/getting-started/best-practices-for-pull-requests) |
||||
- [@article@Pull Request Guidelines](https://opensource.creativecommons.org/contributing-code/pr-guidelines/) |
@ -1 +1,8 @@ |
||||
# pre-commit |
||||
|
||||
Git pre-commit hooks are scripts that run automatically before a commit is created, allowing developers to enforce code quality standards and catch issues early in the development process. These hooks can perform tasks such as linting, formatting, running tests, or checking for sensitive information, ensuring that only clean and compliant code is committed to the repository. By intercepting the commit process, pre-commit hooks help maintain code consistency, reduce errors, and streamline the overall development workflow, making them a valuable tool for enforcing best practices and improving code quality across a project. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@opensource@pre-commit/pre-commit](https://github.com/pre-commit/pre-commit) |
||||
- [@official@Git Hooks](https://www.atlassian.com/git/tutorials/git-hooks) |
@ -1 +1,9 @@ |
||||
# pre-push |
||||
|
||||
Git pre-push hooks are scripts that run automatically before a push operation is executed, providing a final checkpoint to validate changes before they are shared with a remote repository. These hooks allow developers to perform last-minute checks, such as running tests, linting code, or verifying commit messages, to ensure that only high-quality and compliant code is pushed. By intercepting the push process, pre-push hooks help maintain code integrity, prevent accidental pushes of incomplete or broken code, and enforce project-specific rules, making them a valuable tool for maintaining code quality and consistency across distributed development teams. |
||||
|
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@article@pre-push hooks](https://dev.to/jameson/pre-push-hooks-42g5) |
||||
- [@video@Detect secrets with a pre-commit git hook](https://www.youtube.com/watch?v=8bDKn3y7Br4) |
@ -1 +1,7 @@ |
||||
# Private vs Public |
||||
|
||||
GitHub offers both private and public repositories, each serving different purposes in software development. Public repositories are visible to everyone on the internet, making them ideal for open-source projects, collaboration, and showcasing work to a wider audience. They encourage community contributions and can help developers build their portfolios. Private repositories, on the other hand, are only accessible to the repository owner and designated collaborators. These are suitable for proprietary code, sensitive projects, or work that's not ready for public consumption. Private repositories offer greater control over access and visibility, making them essential for businesses and individuals who need to keep their code confidential. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@About project visibility](https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility) |
@ -1 +1,9 @@ |
||||
# Profile Readme |
||||
|
||||
A GitHub Profile README is a special repository that allows users to showcase their skills, projects, and personality directly on their GitHub profile. To create one, you need to make a new repository with the same name as your GitHub username. This repository should contain a README.md file, which GitHub will automatically display on your profile page. The README can be customized with Markdown formatting, allowing you to add text, images, links, and even dynamic content like GitHub stats or recent blog posts. This feature provides a unique opportunity to make your GitHub profile more engaging and informative for visitors, effectively serving as a personalized landing page for your GitHub presence. |
||||
|
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@Managing your profile README](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme) |
||||
- [@video@GitHub Profile README](https://www.youtube.com/watch?v=KhGWbt1dAKQ) |
@ -1 +1,8 @@ |
||||
# Project Planning |
||||
|
||||
Project planning on GitHub is a comprehensive process that leverages the platform's built-in tools to organize, track, and manage software development projects efficiently. It typically involves using features such as Issues for task tracking, Projects for kanban-style boards, Milestones for grouping related issues and pull requests, and Labels for categorization. These tools, combined with GitHub's collaborative features like pull requests and code reviews, enable teams to create structured workflows, set priorities, assign tasks, and monitor progress throughout the development lifecycle. By centralizing project management within the same platform used for version control, GitHub streamlines communication and enhances productivity for development teams of all sizes. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@Project planning for developers](https://github.com/features/issues) |
||||
- [@video@GitHub Project Management](https://www.youtube.com/watch?v=oPQgFxHcjAw) |
@ -1 +1,8 @@ |
||||
# Project Readme |
||||
|
||||
A GitHub project README is a crucial document that serves as the front page of a repository, providing essential information about the project. It typically includes a brief description of the project's purpose, installation instructions, usage guidelines, and contribution procedures. A well-crafted README helps visitors quickly understand the project's goals, how to get started, and how they can participate. It often contains badges indicating build status, code coverage, and other metrics, as well as links to documentation, issue trackers, and community channels. By effectively communicating the project's value and guiding new users and potential contributors, a good README significantly enhances a project's visibility, adoption, and collaboration potential on GitHub. |
||||
|
||||
Visit the following resources to learn more: |
||||
|
||||
- [@official@About READMEs](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes) |
||||
- [@article@How to write a good README](https://bulldogjob.com/readme/how-to-write-a-good-readme-for-your-github-project) |
Loading…
Reference in new issue