{"meta":{"title":"Viewing and understanding files","intro":"Explore file content and trace changes over time to understand a new codebase and its evolution.","product":"Repositories","breadcrumbs":[{"href":"/en/repositories","title":"Repositories"},{"href":"/en/repositories/working-with-files","title":"Work with files"},{"href":"/en/repositories/working-with-files/using-files","title":"Using files"},{"href":"/en/repositories/working-with-files/using-files/viewing-and-understanding-files","title":"View and understand files"}],"documentType":"article"},"body":"# Viewing and understanding files\n\nExplore file content and trace changes over time to understand a new codebase and its evolution.\n\nGitHub provides tools to view raw content, trace changes to specific lines, and explore how a file’s content has evolved over time. These insights reveal how code was developed, its current purpose, and its structure, helping you contribute effectively.\n\n## Viewing or copying the raw file content\n\nWith the raw view, you can view or copy the raw content of a file without any styling.\n\n1. On GitHub, navigate to the main page of the repository.\n\n2. Click the file that you want to view.\n\n3. In the upper-right corner of the file view, click **Raw**.\n\n \n\n4. Optionally, to copy the raw file content, in the upper-right corner of the file view, click ****. To download the raw file, click ****.\n\n## Viewing the line-by-line revision history for a file\n\nWithin the blame view, you can view the line-by-line revision history for an entire file.\n\n> \\[!TIP]\n> On the command line, you can also use `git blame` to view the revision history of lines within a file. For more information, see [Git's `git blame` documentation](https://git-scm.com/docs/git-blame).\n\n1. On GitHub, navigate to the main page of the repository.\n\n2. Click to open the file whose line history you want to view.\n\n3. Above the file content, click **Blame**. This view gives you a line-by-line revision history, with the code in a file separated by commit. Each commit lists the author, commit description, and commit date.\n\n4. To see versions of a file before a particular commit, click . Alternatively, to see more detail about a particular commit, click the commit message.\n\n \n\n5. To return to the raw code view, above the file content, click **Code**.\n * If you are viewing a Markdown file, above the file content, you can also click **Preview** to return to the view with Markdown formatting applied.\n\n## Ignore commits in the blame view\n\nAll revisions specified in the `.git-blame-ignore-revs` file, which must be in the root directory of your repository, are hidden from the blame view using Git's `git blame --ignore-revs-file` configuration setting. For more information, see [`git blame --ignore-revs-file`](https://git-scm.com/docs/git-blame#Documentation/git-blame.txt---ignore-revs-fileltfilegt) in the Git documentation.\n\n1. In the root directory of your repository, create a file named `.git-blame-ignore-revs`.\n\n2. Add the commit hashes you want to exclude from the blame view to that file. We recommend the file to be structured as follows, including comments:\n\n ```shell\n # .git-blame-ignore-revs\n # Removed semi-colons from the entire codebase\n a8940f7fbddf7fad9d7d50014d4e8d46baf30592\n # Converted all JavaScript to TypeScript\n 69d029cec8337c616552756310748c4a507bd75a\n ```\n\n3. Commit and push the changes.\n\nIn the blame view, revisions are excluded if the commit **introduced new lines** or modified existing lines. If the commit was the last to **modify** a line, it will still appear in blame. You'll see an \"Ignoring revisions in .git-blame-ignore-revs\" banner indicating that some commits may be hidden:\n\n\n\n\n\nThis can be useful when a few commits make extensive changes to your code. You can use the file when running `git blame` locally as well:\n\n```shell\ngit blame --ignore-revs-file .git-blame-ignore-revs\n```\n\nYou can also configure your local git so it always ignores the revs in that file:\n\n```shell\ngit config blame.ignoreRevsFile .git-blame-ignore-revs\n```\n\n## Bypassing `.git-blame-ignore-revs` in the blame view\n\nIf the blame view for a file shows **Ignoring revisions in .git-blame-ignore-revs**, you can still bypass `.git-blame-ignore-revs` and see the normal blame view. In the URL, append a `~` to the SHA and the **Ignoring revisions in .git-blame-ignore-revs** banner will disappear.\n\n## Understanding files with Copilot\n\n> \\[!NOTE] You'll need access to GitHub Copilot. For more information, see [What is GitHub Copilot?](/en/copilot/get-started/what-is-github-copilot#get-access).\n\nYou can also use Copilot to ask about specific lines of code in a file, helping you understand how the code works and reducing the risk of introducing new problems.\n\n1. On GitHub, navigate to a repository and open a file.\n\n2. Do one of the following:\n * To ask a question about the **entire file**, click the Copilot icon () at the top right of the file view.\n\n \n\n * To ask a question about **specific lines** within the file:\n\n 1. Click the line number for the first line you want to ask about, hold down Shift, then click the line number for the last line you want to select.\n 2. To ask your own question about the selected lines, click the Copilot icon () to the right of your selection, then type your question in the GitHub Copilot Chat panel.\n 3. To ask a predefined question, click the drop-down menu beside the Copilot icon, then choose one of the options.\n\n \n\n3. If you clicked the Copilot icon, type a question in the \"Ask Copilot\" box at the bottom of the chat panel and press Enter.\n\n For example, if you are asking about the entire file, you could enter:\n\n * `Explain this file.`\n * `How could I improve this code?`\n * `How can I test this script?`\n\n If you are asking about specific lines, you could enter:\n\n * `Explain the function at the selected lines.`\n * `How could I improve this class?`\n * `Add error handling to this code.`\n * `Write a unit test for this method.`\n\n Copilot responds to your request in the panel.\n\n4. Optionally, after submitting a question, you can click in the text box to stop the response.\n\n5. You can continue the conversation by asking a follow-up question. For example, you could type \"tell me more\" to get Copilot to expand on its last comment."}