Skip to content
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

Add notebooks section on website #1495

Merged
merged 17 commits into from
Feb 3, 2024

Conversation

jackgerrits
Copy link
Member

@jackgerrits jackgerrits commented Jan 31, 2024

This PR adds support for rendering notebooks on the website. It automatically includes files from /notebook after they have a small amount of metadata added.

Once there are a sufficient number of notebooks opted in web can enable the Notebooks section in the navbar so users can find it.

To add a notebook to the website it should include a comment at the very top containing two yaml properties:

<!--
tags: ["RAG"]
description: |
    Explore the use of AutoGen's RetrieveChat for tasks like code generation from docstrings, answering complex questions with human feedback, and exploiting features like Update Context, custom prompts, and few-shot learning.
-->
Screenshot 2024-01-31 at 7 08 03 PM Screenshot 2024-01-31 at 7 07 59 PM Screenshot 2024-01-31 at 7 08 48 PM

Related issue number

#1339

@jackgerrits jackgerrits changed the title Add support for rendering notebooks on website Add notebooks section on website Feb 1, 2024
@codecov-commenter
Copy link

codecov-commenter commented Feb 1, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (b9bb0ee) 34.30% compared to head (7ef56c4) 34.30%.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1495   +/-   ##
=======================================
  Coverage   34.30%   34.30%           
=======================================
  Files          42       42           
  Lines        5110     5110           
  Branches     1169     1169           
=======================================
  Hits         1753     1753           
  Misses       3213     3213           
  Partials      144      144           
Flag Coverage Δ
unittests 34.26% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@gagb
Copy link
Collaborator

gagb commented Feb 1, 2024

Fantastic PR Jack-- it preserves the current dev flow for adding new notebooks and improves the website!

Copy link
Collaborator

@ekzhu ekzhu left a comment

Choose a reason for hiding this comment

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

I really like this PR. Great work!

Copy link
Contributor

@sonichi sonichi left a comment

Choose a reason for hiding this comment

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

One minor issue.

notebook/agentchat_function_call_async.ipynb Outdated Show resolved Hide resolved
@sonichi sonichi requested review from skzhang1 and thinkall February 3, 2024 17:00
@sonichi sonichi added this pull request to the merge queue Feb 3, 2024
Merged via the queue into microsoft:main with commit 38d03b0 Feb 3, 2024
19 of 23 checks passed
@BeibinLi BeibinLi mentioned this pull request Mar 31, 2024
3 tasks
whiskyboy pushed a commit to whiskyboy/autogen that referenced this pull request Apr 17, 2024
* Initial infrasctructure for notebooks page

* migrate two notebooks

* add readme notification for notebook dir

* override 'text' prism language to add basic syntactical structure to autogens output

* Rework to retain existing directory and not expose front matter to consumers of the notebook

* improve error handling of process notebooks

* format, ruff and type fixes

* undo changes to navbar

* update readme, CI

* whitespace

* spelling mistakes

* spelling

* Add contributing guide for notebooks

* update notebook

* formatting
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants