Update the repository documentation to integrate the Diátaxis framework

.gitignore

@@ -1,3 +1,6 @@
 **.graphql**
 
 test/
+
+# IDEs and editors
+.idea/

README.md

@@ -26,8 +26,9 @@ This document contains **le-git** `(legit)` that means "Let's Explain Git and Gi
 
 ## Tools
 
-- [Table Generator (Markdown)](https://www.tablesgenerator.com/markdown_tables#)
+- [Tables Generator](https://www.tablesgenerator.com/markdown_tables#)
 - [Readme.so](https://readme.so/)
+- [Gitignore.io](https://www.toptal.com/developers/gitignore)
 
 ## Usage
 

github-actions/github_actions_self_hosted_runner.md → github/actions/github_actions_self_hosted_runner.md

@@ -10,7 +10,7 @@ Read more: [Github Docs](https://docs.github.com/en/actions/hosting-your-own-run
 
 #### Set up pre- and post-job scripts
 
-Search for the `.env` file in the self-hosted executor application directory `$HOME/actions-runner`, 
+Search for the `.env` file in the self-hosted executor application directory `$HOME/actions-runner`,
 
 ```shell
 ACTIONS_RUNNER_HOOK_JOB_COMPLETED=/path/to/script.sh

github/ai/mcp/README.md

@@ -0,0 +1,9 @@
+# GitHub MCP
+
+## Resources
+
+- https://github.com/github/github-mcp-server
+
+## Related links
+
+- https://github.blog/changelog/2025-10-29-github-mcp-server-now-comes-with-server-instructions-better-tools-and-more/

github-api/graphql-api/scripts/poc/sign-commit/sign-commit-delete.sh → github/api/graphql-api/scripts/poc/sign-commit/sign-commit-delete.sh

@@ -13,7 +13,7 @@ file_paths=()
 while getopts ":r:d:" flag
 do
     case "${flag}" in
-      r) 
+      r)
         repo=${OPTARG}
         ;;
       d)
@@ -45,7 +45,7 @@ if [ "$input_path" != "null" ]; then
   for path in "${paths[@]}"; do
     evalute_input_path "$path"
   done
-  
+
   changed_files_json=""
   for path in "${file_paths[@]}"; do
     if [[ -f "$path" ]]; then

github-api/graphql-api/scripts/poc/sign-commit/sign-commit-upload.sh → github/api/graphql-api/scripts/poc/sign-commit/sign-commit-upload.sh

@@ -14,7 +14,7 @@ file_paths=()
 while getopts ":r:u:" flag
 do
     case "${flag}" in
-      r) 
+      r)
         repo=${OPTARG}
         ;;
       u)
@@ -50,7 +50,7 @@ if [ "$input_path" != "null" ]; then
   for path in "${paths[@]}"; do
     check_input_path "$path"
   done
-  
+
   changed_files_json=""
   for path in "${file_paths[@]}"; do
     if [[ -f "$path" ]]; then

github-api/graphql-api/scripts/poc/sign-commit/sign-commit-v1.sh → github/api/graphql-api/scripts/poc/sign-commit/sign-commit-v1.sh

@@ -11,7 +11,7 @@ GITHUB_URL="https://github.com"
 while getopts ":r:f:" flag
 do
     case "${flag}" in
-      r) 
+      r)
         repo=${OPTARG}
         ;;
       f)
@@ -42,7 +42,7 @@ if [ "$input_path" != "null" ]; then
   for path in "${paths[@]}"; do
     evalute_input_path "$path"
   done
-  
+
   changed_files_json=""
   for path in "${file_paths[@]}"; do
     if [[ -f "$path" ]]; then

github-api/rest-api/scripts/gh-rest-list-branch-rule.sh → github/api/rest-api/scripts/gh-rest-list-branch-rule.sh

@@ -21,9 +21,9 @@ function gh_api_get_branch_protection() {
     "/repos/$GITHUB_OWNER/$repo/branches")
 
   branches=$(echo "$fetch" | jq -r '.[] | "\(.name)/\(.protected)"' | sort -r)
-  
+
   readarray -t _branches <<< "$branches"
-  
+
   found_branch_protection=false
 
   for b in "${_branches[@]}"; do

github-auth/github_ssh_key.md → github/auth/github_ssh_key.md

@@ -44,13 +44,13 @@ Once the new SSH keys are generated, you can add them to your Github account in
 Go to [SSH and GPG keys](https://github.com/settings/keys) in Github Settings panel:
 
 
-![new-ssh-key](./docs/images/new-ssh-key.jpg)
+![new-ssh-key](docsmages/new-ssh-key.jpg)
 
 
 Within the Keys panel, click in [New SSH key](https://github.com/settings/ssh/new) to create a new key:
 
 
-![add-new-ssh-key-authentication-key](./docs/images/add-new-ssh-key-auth-key.jpg)
+![add-new-ssh-key-authentication-key](docsmages/add-new-ssh-key-auth-key.jpg)
 
 
 - In the `Title` field add a name for your SSH key, I recommend something similar to this:

github-auth/github_ssh_signing_key.md → github/auth/github_ssh_signing_key.md

@@ -53,13 +53,13 @@ Once the new SSH keys are generated, you can add them to your Github account in
 Go to [SSH and GPG keys](https://github.com/settings/keys) in Github Settings panel:
 
 
-![new-ssh-key](./docs/images/new-ssh-key.jpg)
+![new-ssh-key](docsmages/new-ssh-key.jpg)
 
 
 Within the Keys panel, click in [New SSH key](https://github.com/settings/ssh/new) to create a new key:
 
 
-![add-new-ssh-key-signing-key](./docs/images/add-new-ssh-key-sign-key.jpg)
+![add-new-ssh-key-signing-key](docsmages/add-new-ssh-key-sign-key.jpg)
 
 
 - In the `Title` field add a name for your SSH key, I recommend something similar to this:
@@ -115,10 +115,10 @@ git config --global user.signingkey ~/.ssh/id_ed25519.pub
 ```
 **NOTE:** Take this into account.
 
-![git-ssh-sign-verify-warn](./docs/images/git-ssh-sign-verify-warn.jpg)
+![git-ssh-sign-verify-warn](docsmages/git-ssh-sign-verify-warn.jpg)
 
 >
->     If you currently have a git version less than 2.34 this 
+>     If you currently have a git version less than 2.34 this
 >     type of commit signature verify (SSH) will not work, you
 >     must upgrade to version 2.34 or later.
 >
@@ -154,11 +154,11 @@ git commit -a -S -m "YOUR_COMMIT_MESSAGE"
 
 You should see the following tag in your web browser commit history:
 
-![sign-commit-verified-tag](./docs/images/sign-commit-verified-tag.jpg)
+![sign-commit-verified-tag](docsmages/sign-commit-verified-tag.jpg)
 
 **NOTE:** It is important that your `user.name` and `user.email` are correctly configured, otherwise you will see the following tag when signing a commit:
 
-![sign-commit-unverified-tag](./docs/images/sign-commit-unverified-tag.jpg)
+![sign-commit-unverified-tag](docsmages/sign-commit-unverified-tag.jpg)
 
 GitHub full guides:
 

github-docs/README.md → github/docs/README.md

@@ -2,9 +2,14 @@
 
 - [Duplicating a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/duplicating-a-repository)
 - [Deleting a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/deleting-a-repository)
-- [Documentation done right: A developer’s guide](https://github.blog/developer-skills/documentation-done-right-a-developers-guide/)
 - [Creating a pull request template for your repository](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository)
 
-### Related links
+## Diataxis Framework Resources
 
 - [Diátaxis](https://diataxis.fr/)
+- [Documentation done right: A developer’s guide](https://github.blog/developer-skills/documentation-done-right-a-developers-guide/)
+- [Internal Documentation Example](https://github.com/github/internal-documentation-example)
+
+## Resources
+
+- [GitHub Pricing Calculator](https://github.com/pricing/calculator)