diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md index b696c3a2aeac..747a57a792c2 100644 --- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/creating-gists.md @@ -16,7 +16,30 @@ versions: --- ## About gists -Gists provide a simple way to share code snippets with others. Every gist is a Git repository, which means that it can be forked and cloned. If you are signed in to {% data variables.product.github %} when you create a gist, the gist will be associated with your account and you will see it in your list of gists when you navigate to your {% data variables.gists.gist_homepage %}. +Gists provide a simple way to share code snippets, small scripts, notes, or even full files — but in a very lightweight way with others. Every gist is like a mini Git repository, which means that it can be forked and cloned. If you are signed in to {% data variables.product.github %} when you create a gist, the gist will be associated with your account and you will see it in your list of gists when you navigate to your {% data variables.gists.gist_homepage %}. + +**In simple words:** +> *Think of Gists as small, shareable Git repositories that are great for tiny projects, code snippets, or notes.* + + +## Key Points + +- **Quick sharing**: You can share small code snippets or files easily. +- **Version control**: Every time you update a gist, it keeps a version history (like Git commits). +- **Forkable & clonable**: Others can fork your gist, and you can clone gists using Git like normal repos. +- **Supports multiple files**: A gist can contain more than one file. + +--- + +## Use Cases + +- Sharing config files +- Sharing interview coding questions +- Sharing quick code solutions +- Maintaining small personal notes or documentation +- Embedding code snippets in blogs or websites + +--- Gists can be public or secret. Public gists show up in {% data variables.gists.discover_url %}, where people can browse new gists as they're created. They're also searchable, so you can use them if you'd like other people to find and see your work.