Skip to content

Conversation

paytonison
Copy link

@paytonison paytonison commented Sep 16, 2025

This pull request introduces a new beginner-friendly guide to large language models (LLMs), updates the article registry and author list to include the new content and author, and removes an older introductory article on working with LLMs. The new guide provides a practical, code-first introduction, including hands-on examples in Python and JavaScript, and covers core concepts, best practices, and common pitfalls for developers.

Resolves issue #2119.

Content updates:

  • Added a new article, openai-cookbook-llms-101.md, which provides a concise, practical introduction to LLMs with code examples, explanations of key concepts (tokenization, embeddings, transformer layers), and actionable advice for developers.
  • Removed the older article how_to_work_with_large_language_models.md, which previously covered similar introductory material, to avoid redundancy.

Metadata and registry updates:

  • Added a new author, paytonison, to authors.yaml for attribution of the new article.
  • Registered the new article in registry.yaml under the appropriate tags and with author attribution.

Motivation

The introduction for the Cookbook is outdated and references old models. It needs to be revised to include GPT-5 and highlight the more advanced capabilities of LLMs, beyond just basic text generation, word prediction, and semantic analysis, especially with GPT-5.

Additionally, the original introduction sounded like it was written by a seasoned expert as an afterthought and isn't very accessible for newcomers who are interested in using the API for AI.


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.

@Copilot Copilot AI review requested due to automatic review settings September 16, 2025 04:37
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 pull request replaces an outdated introductory article about large language models with a new, more accessible beginner-friendly guide. The update aims to modernize the content with references to current models and provide a more practical, code-first approach for developers.

  • Introduces a new beginner-friendly LLM guide with hands-on Python and JavaScript examples
  • Removes the older introductory article to avoid content redundancy
  • Updates metadata files to register the new content and author

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

File Description
registry.yaml Registers the new LLM 101 article with metadata and tags
authors.yaml Adds new author "paytonison" with profile information
articles/openai-cookbook-llms-101.md New practical introduction to LLMs with code examples and explanations
articles/how_to_work_with_large_language_models.md Removes the older introductory article

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

paytonison and others added 2 commits September 15, 2025 22:38
Number dyslexia as an american is hard

Co-authored-by: Copilot <[email protected]>
@paytonison paytonison force-pushed the paytonison/introduction-rewrite branch from 316a51e to 0699988 Compare September 17, 2025 03:18
Copy link

@SoCal909 SoCal909 left a comment

Choose a reason for hiding this comment

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

🧲🔒💻

@paytonison paytonison closed this Sep 17, 2025
@paytonison paytonison deleted the paytonison/introduction-rewrite branch September 17, 2025 03:59
@paytonison paytonison restored the paytonison/introduction-rewrite branch September 17, 2025 04:03
@paytonison paytonison reopened this Sep 17, 2025
@paytonison
Copy link
Author

i panicked and thought i leaked something. sorry.

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.

2 participants