Skip to content

docs: improve examples README and fix grammar in intro notebook#1540

Open
mitre88 wants to merge 1 commit intoairweave-ai:mainfrom
mitre88:docs/improve-intro-notebook-and-examples
Open

docs: improve examples README and fix grammar in intro notebook#1540
mitre88 wants to merge 1 commit intoairweave-ai:mainfrom
mitre88:docs/improve-intro-notebook-and-examples

Conversation

@mitre88
Copy link

@mitre88 mitre88 commented Mar 4, 2026

Summary

This PR improves the developer enablement materials in the examples/ directory:

Examples README (examples/README.md)

The README previously only documented quickstart_tutorial.py, but the directory also contains two Jupyter notebooks and a webhook demo subdirectory. This PR adds documentation for:

  • intro_to_airweave.ipynb — Description and overview of what new users will learn
  • search_concepts.ipynb — Summary of all 14 search examples covered in the notebook
  • webhook-demo/ — Cross-reference to the webhook demo subdirectory

Intro Notebook (examples/intro_to_airweave.ipynb)

Fixed several grammar and formatting issues:

  • is an open-source platform enablesis an open-source platform that enables
  • as many or as little sourcesas many or as few sources (countable noun)
  • Once source connection is establishedOnce the source connection is established
  • Improved formatting of the setup instructions cell (added markdown link and blockquote for the local deployment note)

Changes

  • Modified examples/README.md
  • Modified examples/intro_to_airweave.ipynb

No code changes.


Summary by cubic

Improves the examples README to document the intro and search notebooks plus the webhook demo, and cleans up grammar/formatting in the intro notebook. No code changes.

  • Docs
    • Update examples/README.md to include intro_to_airweave.ipynb, search_concepts.ipynb (14 search examples), and webhook-demo/.
    • Fix phrasing in intro_to_airweave.ipynb (“…that enables”, “as many or as few…”, “Once the source connection…”), and tidy setup/output formatting for clarity.

Written for commit d11ea7a. Summary will update on new commits.

- Add missing documentation for intro_to_airweave.ipynb, search_concepts.ipynb,
  and webhook-demo/ to the examples README
- Fix grammar: 'is an open-source platform enables' → 'is an open-source platform that enables'
- Fix grammar: 'as many or as little sources' → 'as many or as few sources'
- Fix grammar: 'Once source connection' → 'Once the source connection'
- Improve formatting of setup instructions in the intro notebook
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 2 files

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