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

Initial docs #22

Merged
merged 22 commits into from
Apr 4, 2023
Merged

Initial docs #22

merged 22 commits into from
Apr 4, 2023

Conversation

JasonWeill
Copy link
Collaborator

Fixes #21.

Initial user and contributor documentation suitable for use with ReadTheDocs.

@welcome
Copy link

welcome bot commented Apr 3, 2023

Thanks for submitting your first pull request! You are awesome! 🤗

If you haven't done so already, check out Jupyter's Code of Conduct. Also, please make sure you followed the pull request template, as this will help us review your contribution more quickly.
welcome
You can meet the other Jovyans by joining our Discourse forum. There is also a intro thread there where you can stop by and say Hi! 👋

Welcome to the Jupyter community! 🎉

@JasonWeill JasonWeill added documentation Improvements or additions to documentation enhancement New feature or request labels Apr 3, 2023
@dlqqq
Copy link
Member

dlqqq commented Apr 3, 2023

Kicking CI.

@dlqqq dlqqq closed this Apr 3, 2023
@dlqqq dlqqq reopened this Apr 3, 2023
@dlqqq
Copy link
Member

dlqqq commented Apr 3, 2023

@dlqqq
Copy link
Member

dlqqq commented Apr 3, 2023

This looks great, and goes into more detail than I had expected. Awesome work. 👍 There is more documentation that needs to be added, most notably IPython magics usage, but we can iterate on those in follow-up PRs.

In the "Users" documentation, there are mentions of "plugins", for example:

You can also install a particular plugin by running pip install. For example, to install the ChatGPT plugin ...

Please change the wording to use AI modules instead of plugins. Also, a brief explanation of what AI modules are would also help. Here's an outline of what this section should touch on:

  • AI modules extend Jupyter AI's functionality
  • AI modules are Python packages that may optionally be full JupyterLab extensions
  • AI modules can register new models, insertion modes, and default tasks

@JasonWeill
Copy link
Collaborator Author

@dlqqq Made a few modifications, including to the top level, and I added one of @3coins 's animations to the top level documentation as an indication of what this project can do. Thanks for the feedback!

@dlqqq dlqqq merged commit 1b25bf5 into jupyterlab:main Apr 4, 2023
@welcome
Copy link

welcome bot commented Apr 4, 2023

Congrats on your first merged pull request in this project! 🎉
congrats
Thank you for contributing, we are very proud of you! ❤️


## Prerequisites

To use Jupyter AI, you will need to have JupyterLab ≥ 3.5 (*not* JupyterLab 4) installed.
Copy link
Collaborator

@andrii-i andrii-i Apr 4, 2023

Choose a reason for hiding this comment

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

need to have JupyterLab ≥ 3.5 (*not* JupyterLab 4) installed is somewhat confusing to me. Would something like need to have JupyterLab version 3.5 or above (but below version 4.0.0) or yarn notation need to have JupyterLab ≥3.5.0 <4.0.0 be more clear?

dbelgrod pushed a commit to dbelgrod/jupyter-ai that referenced this pull request Jun 10, 2024
* Initial docs commit

* Change authors

* Updates theming, adds image

* Removes stray whitespace

* Adds basic intro

* Removes indices

* Switches to Markdown; adds user docs file

* Adds user docs

* Adds configuration info

* Makes URLs into links

* Mentions jupyter_ai_chatgpt

* Early contributor docs

* Adds user docs with screen shots

* Adds AI module and task description

* Docs on creating a new AI module

* Notes that modality and insertion mode are extensible

* Adds docs/requirements.txt

* Removes colon_fence from requirements

* Adds definition of Jupyter AI at top level

* Adds image to top level docs

* Plugin -> AI modules

* "new tasks" are most important of the three
Marchlak pushed a commit to Marchlak/jupyter-ai that referenced this pull request Oct 28, 2024
* Initial docs commit

* Change authors

* Updates theming, adds image

* Removes stray whitespace

* Adds basic intro

* Removes indices

* Switches to Markdown; adds user docs file

* Adds user docs

* Adds configuration info

* Makes URLs into links

* Mentions jupyter_ai_chatgpt

* Early contributor docs

* Adds user docs with screen shots

* Adds AI module and task description

* Docs on creating a new AI module

* Notes that modality and insertion mode are extensible

* Adds docs/requirements.txt

* Removes colon_fence from requirements

* Adds definition of Jupyter AI at top level

* Adds image to top level docs

* Plugin -> AI modules

* "new tasks" are most important of the three
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 enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Set up ReadTheDocs documentation
3 participants