Skip to content

MAINT simplify Getting Started docs#1727

Open
behnam-o wants to merge 3 commits into
microsoft:mainfrom
behnam-o:dev/getting-started
Open

MAINT simplify Getting Started docs#1727
behnam-o wants to merge 3 commits into
microsoft:mainfrom
behnam-o:dev/getting-started

Conversation

@behnam-o
Copy link
Copy Markdown
Contributor

@behnam-o behnam-o commented May 13, 2026

Updating the Getting Stated section with more minimal content that lets a new user get started faster (I think?)

screenshot:
image

Copy link
Copy Markdown
Contributor Author

@behnam-o behnam-o left a comment

Choose a reason for hiding this comment

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

insert scanner terminal screenshot before merging

Comment thread doc/index.md Outdated
Copy link
Copy Markdown
Contributor

@rlundeen2 rlundeen2 left a comment

Choose a reason for hiding this comment

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

I like this! Let's as @romanlutz to take a look also.

Then I think the top portion could use an update once we have videos

@behnam-o behnam-o marked this pull request as ready for review May 13, 2026 17:39
Comment thread doc/index.md
1. Install PyRIT and verify installation.\
For more details and alternative installation methods, see the [Install PyRIT](getting_started/install) page\
```bash
# note: for local installation, python version 3.13 is recommended: https://www.python.org/downloads/latest/python3.13
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Why 3.13? We support 3.10-14

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Hmm, looks like 3.14 support was added 2 weeks ago here, so pyrit v0.13 (latest on pypi) does not support that.

If we publish the doc saying python 3.14 , it only works for people cloning the repo, not those who just want the pypi package

Comment thread doc/copyrit-demo.gif
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

imo this doesn't really add more than a few images and if we're going to have a gif / video, i think it makes more sense to show sequentially how to get from one page to another like more of a walkthrough

Comment thread doc/framework-demo.png
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

just noting that we don't usually remove the user name from our notebooks at least and its obviously fine to remove but i'm wondering if we could just replace it with like roakey or make the block a little cleaner (like ask copilot to generate an image with it blocked out)

Comment thread doc/index.md

## Getting Started
1. Install PyRIT and verify installation.\
For more details and alternative installation methods, see the [Install PyRIT](getting_started/install) page\
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

i think you need a space here:

Image

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.

4 participants