Giter VIP home page Giter VIP logo

skills-connect-the-dots's Introduction

Connect the dots in a GitHub repository

Useful tips when navigating through your repository.

Step 3: Fix a broken sidebar

Great job finding that commit ❤️

Thanks for finding that commit! We now know that the sidebar was indeed added, and it was done in that commit. Let's see if we can dig a little deeper to find out if any planning or conversation, using comments, occurred around this change.

As we've already seen, conversations in issues and pull requests can reference other work, but the amount of context goes much further than crosslinks. Remember, Git is version control! For example, the commit that you found in the last step is connected with much more information such as:

  • Who made the commit.
  • What other changes were included.
  • When the commit was made.
  • Which pull request the commit was a part of.

The pull request is important because it goes beyond knowing when a commit happened. You can know why a commit happened. Finding history is not about blaming anyone, but about seeing the bigger picture. Why were decisions made? Who was involved? What were the build outputs and test results for each commit? Who requested changes, and who approved them?

Finding a pull request from a commit

When you're looking at a commit on GitHub, you can see a lot of information. From this view, you can also find a link to the pull request in which the commit was created. We'll use this in the next step.

screenshot of a view of a commit on GitHub, highlighting the link to the pull request

⌨️ Activity: Fix a broken sidebar

  1. In the main branch Edit the docs/_sidebar.md file.
  2. Correct the spelling of the reference (doc-references__.md) on line 4 by changing it into (doc-references.md).
  3. Select or create a new branch fix-sidebar for this commit and start a pull request.
  4. Make sure that main is selected for base: and fix-sidebar for compare:.
  5. Using the Assignees section on the right side, assign yourself to the pull request.
  6. In the PR comment add 'Closes #2' and autolink issue #2.
  7. Click Create pull request and wait about 20 seconds.
  8. Merge this pull request.
  9. Delete the branch 'fix-sidebar'.
  10. Wait about 20 seconds then refresh this page (the one you're following instructions from). GitHub Actions will automatically update to the next step.

Get help: Post in our discussion boardReview the GitHub status page

© 2023 GitHub • Code of ConductMIT License

skills-connect-the-dots's People

Contributors

11hammad22 avatar

Stargazers

 avatar

Watchers

 avatar

skills-connect-the-dots's Issues

Welcome

GIVEN:

  • User opens _sidebar.md file

WHEN:

  • User navigates by clicking on [Documentation references] link

THEN (EXPECTED):

  • [Documentation references] page must be open successfully

OBSERVED:

  • File not found error OR GitHub reports HTTP 404 error (file not found)

Fix the sidebar

GIVEN:

  • User opens _sidebar.md file

WHEN:

  • User navigates by clicking on [Documentation references] link

THEN (EXPECTED):

  • [Documentation references] page must be open successfully

OBSERVED:

  • File not found error OR GitHub reports HTTP 404 error (file not found)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.