Skip to content

Replace LLM article with concise introduction #2070

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 3 commits into from

Conversation

paytonison
Copy link

Deleted 'how_to_work_with_large_language_models.md' and added 'llms 101.md' with a shorter, more focused overview of large language models. The new article provides a high-level introduction to LLMs, their capabilities, and basic concepts for users.

Summary

This pull request removes the detailed introductory guide to large language models from articles/how_to_work_with_large_language_models.md and replaces it with a new, more concise overview in articles/llms 101.md. The new article provides a streamlined explanation of LLMs, focusing on their core concepts and practical usage, while omitting the previous in-depth prompt engineering examples and advice.

Documentation updates:

  • Replaced the comprehensive guide in articles/how_to_work_with_large_language_models.md with a new, shorter introduction in articles/llms 101.md, focusing on what LLMs are, how they work, and what they can do, with less emphasis on prompt styles and practical examples. [1] [2]

Motivation

The Cookbook introduction was over a year old and felt like it was thrown together as an afterthought by someone who’s been in the game for a long time, offering no practical advice for how LLMs work before dropping a first-time user into the lion’s den.

Furthermore, it’s a more friendly tone, rather than the condescending camp counselor vibes of the old version.


For new content

When contributing new content, read through our contribution guidelines, and mark the following action items as completed:

  • I have added a new entry in registry.yaml (and, optionally, in authors.yaml) so that my content renders on the cookbook website.
  • I have conducted a self-review of my content based on the contribution guidelines:
    • Relevance: This content is related to building with OpenAI technologies and is useful to others.
    • Uniqueness: I have searched for related examples in the OpenAI Cookbook, and verified that my content offers new insights or unique information compared to existing documentation.
    • Spelling and Grammar: I have checked for spelling or grammatical mistakes.
    • Clarity: I have done a final read-through and verified that my submission is well-organized and easy to understand.
    • Correctness: The information I include is correct and all of my code executes successfully.
    • Completeness: I have explained everything fully, including all necessary references and citations.

We will rate each of these areas on a scale from 1 to 4, and will only accept contributions that score 3 or higher on all areas. Refer to our contribution guidelines for more details.

Deleted 'how_to_work_with_large_language_models.md' and added 'llms 101.md' with a shorter, more focused overview of large language models. The new article provides a high-level introduction to LLMs, their capabilities, and basic concepts for users.
@Copilot Copilot AI review requested due to automatic review settings August 17, 2025 22:58
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR replaces a comprehensive LLM guide with a more accessible introduction to large language models. The change removes detailed prompt engineering examples and technical depth in favor of a concise, beginner-friendly overview.

  • Deleted the existing detailed guide (how_to_work_with_large_language_models.md) containing extensive prompt engineering strategies and examples
  • Added a new streamlined introduction (llms 101.md) focusing on basic concepts and high-level understanding
  • Simplified the tone and approach to be more welcoming for newcomers to LLMs

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
articles/how_to_work_with_large_language_models.md Complete removal of the existing comprehensive LLM guide
articles/llms 101.md New concise introduction covering LLM basics, capabilities, and core concepts
Comments suppressed due to low confidence (1)

articles/llms 101.md:7

  • This statement is factually incorrect. ChatGPT is built on GPT-3.5 and GPT-4, not GPT-3. GPT-3 was the base model that came before ChatGPT was released.
OpenAI’s ChatGPT, built on GPT-3, brought this architecture into the spotlight and kicked off today’s wave of AI applications.

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

@@ -0,0 +1,36 @@
# LLMs 101: What Even Is It?
Copy link
Preview

Copilot AI Aug 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The title contains grammatically incorrect phrasing. 'What Even Is It?' should be 'What Are They?' or 'What Is an LLM?' for proper grammar and clarity.

Suggested change
# LLMs 101: What Even Is It?
# LLMs 101: What Are They?

Copilot uses AI. Check for mistakes.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stylistic to make it more friendly.

@paytonison paytonison closed this Aug 24, 2025
@paytonison paytonison deleted the payton branch August 24, 2025 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant