nearestnabors

RL "Nearest" Nabors

@nearestnabors · Building the web forward for two decades and counting. Formerly OSS, W3C, React via Meta, AWS, Microsoft.
GitHub Profile
Direct and constructive with collaborative undertones
A documentation-focused reviewer who provides extensive, detailed feedback with a strong emphasis on clarity, consistency, and user experience. They offer specific suggestions and aren't afraid to push back on changes that don't meet quality standards, often restructuring content to be more effective.
970
Comments
316
PRs
9
Repos
110
Avg Chars
3
Harshness

Personality

Detail-oriented and thorough Documentation quality advocate Direct communicator User experience focused Standards-driven Collaborative but firm Process-oriented Quality gatekeeper

Greatest Hits

"Let me know when you add these in."
"Don't forget to update sidebar!"
"Make sure you check out the Vale errors."
"Is this ok to be live?"
"We can be convinced otherwise and won't die on this hill"
"In the future, please don't merge something like this without consulting with the team"

Focus Areas

Common Phrases

"```suggestion" "I would recommend" "Let me know" "This is good!" "Don't forget to" "We should" "I like this" "Not blocking" "Can you" "Please mention" "Vale errors" "Make sure you" "In the future" "Feel free to" "What do you think"

Sentiment Breakdown

constructive
321
neutral
318
questioning
42
positive
63
harsh_questioning
6
very_positive
3
critical
1

Review Outcomes

CHANGES_REQUESTED
90
APPROVED
241
COMMENTED
11
DISMISSED
7

Most Reviewed Authors

frankfeng98
139
nearestnabors
108
paveldudka
107
desi003
91
colriot
75
jayfish0
64
saimonkat
46
Zechereh
45
joshkung247
38
TinyGambe
35

Spiciest Comments

agentql-client/#1062 · docs-next/.vale.ini [view]
Huh, this was shown as "added" when I went through. WTF?
agentql-client/#1062 · docs-next/content/docs/scraping/scraping-data-api.md [view]
I split these into two guides—one for scraping live sites, one for extracting data from HTML. The idea was to have a single guide for each usecase to help folks who weren't reading through the API references find what they're looking for. I was torn on this, but have come to prefer the conciseness of splitting the usecases and only including the params necessary for the guide's usecases. I can be convinced otherwise and won't die on this hill, but wanted to share my thinking and get your opinion
agentql-client/#1029 · docs-next/content/docs/release-notes.md [view]
Please mention that in the API reference. It's not clear what the experimental query elements does from there.
agentql-client/#572 · docs-next/src/components/shared/content/cards/card/card.tsx [view]
Why would I take this approach instead of my own for `istExternalUrl`? This one would miss https as well as full links passed in that are local ("https://docs.agentql.com/blah"). `noreferrer` seems like it would be harmful too: > Use the rel=”noreferrer” attribute on outgoing links when you don’t want other sites to know that you are linking to them. Can’t think of any valid reason why you might want to do this, but that’s the case. > One of the ways to get the attention of other webma
agentql-client/#514 [view]
I like this a lot. This is very helpful. I wish it could also say what the language is... for those who might not realize .py = python or .ts = typescript. We have crossover programmers. But not blocking
agentql-website/#67 [view]
I'm happy to help! In the future, please don't merge something like this without consulting with the team or and filing a follow up ticket. Thank you!
agentql/#34 [view]
> @colriot After seeing your comment on `login.py` example, I'm wondering do we actually need this example as well. Technically, it's also just interacting with the page to close the popup window. I think this is awesome. I had an ah-ha moment and retooled the script to reject cookies for me. (We should have a sample script for that, too, as I bet people will search on it... I'm going to make one!)

AI Persona Prompt

You are @nearestnabors, a meticulous documentation reviewer who cares deeply about user experience and content quality. Your reviews are thorough and constructive, often including specific ```suggestion blocks with exact rewording. You have a keen eye for documentation standards and frequently mention Vale errors that need addressing. You're collaborative ('Let me know your thoughts!') but firm about quality standards ('Don't push it to Docs if not live'). You often catch things others miss, like asking 'Don't forget to update sidebar!' or questioning if experimental features should be documented yet. Your tone is direct but supportive - you'll say 'This is good!' when you like something and 'I would recommend' when suggesting changes. You care about consistency, proper linking, and ensuring documentation matches actual functionality. You're not afraid to ask for significant restructuring if it serves users better, and you often think about the broader user journey. You frequently remind people about process ('Make sure you check out the Vale errors') and aren't hesitant to request changes when quality standards aren't met. Always be specific in your feedback and offer concrete suggestions rather than vague complaints.

Recent Comments (754 total)

friday/#223 updating readme with extra advice · pyt/README.md [view]
Then include the eval instructions instead of `poetry env activate`
agentql-client/#717 Doc: Browser fingerprinting with “stealth mode” · docs-next/content/docs/avoiding-bot-detection.md [view]
```suggestion ## Documentation <Cards> <Card title='Enable "Stealth Mode" for Headless Browser' description="Learn what stealthmode is and how to enable it." icon="docs" href="stealth-mode-for-headless-browser" /> </Cards> ## Sample code <Cards> <Card title="Run script in a stealth mode" description="Script showing how to apply different techniques to lower the risk of being d
agentql-client/#717 Doc: Browser fingerprinting with “stealth mode” · docs-next/content/docs/avoiding-bot-detection/stealth-mode-for-headless-browser.md [view]
```suggestion ## Overview This section explains what Stealth Mode is, why you might need it, and how to enable it with AgentQL. ```
agentql-client/#717 Doc: Browser fingerprinting with “stealth mode” · docs-next/content/docs/avoiding-bot-detection/stealth-mode-for-headless-browser.md [view]
```suggestion ## Related Content ```
agentql-client/#717 Doc: Browser fingerprinting with “stealth mode” · docs-next/content/docs/avoiding-bot-detection/stealth-mode-for-headless-browser.md [view]
```suggestion You can enable Stealth Mode in AgentQL by calling the [`enable_stealth_mode`](/api-references/agentql-page#enablestealthmode) method and passing it a page object. ```
agentql-client/#1116 Card descriptions based on frontmatter descriptions · docs-next/content/docs/agentql-query/best-practices.md [view]
```suggestion description: Learn to write AgentQL queries with our comprehensive best practices guide. Learn syntax requirements, naming conventions, and techniques for improving query accuracy. ```
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
```suggestion title: Scraping data from PDFs and image files with AgentQL's Playground ```
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
```suggestion description: Learn how to use AgentQL's Playground to extract structured data from PDFs and image files ```
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
```suggestion You can use <a href="https://playground.agentql.com/?input=document" target="_blank">AgentQL's Playground</a> to extract structured data such as product details, user reviews, or other information from PDFs and images. ```
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
```suggestion This beta feature is exclusive to AgentQL's Playground and not yet available in our SDKs. <a href="mailto:support@agentql.com">Email us</a> or reach out <a href="https://discord.gg/agentql" target="_blank">on our Discord</a> to get access! ```
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
```suggestion 1. Go to <a href="https://playground.agentql.com/?input=document" target="_blank">AgentQL's Playground</a>. ```
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
```suggestion 2. Click the "Documented (Experimental)" toggle. 3. Either click "Choose file" to upload your PDF, JPG, or PNG file _or_ drag and drop your file into the target preview area. 4. Add an [AgentQL query](/agentql-query) to the query box (or use the "Suggest a Query" button to have AgentQL craft a query for you). 5. Click the "Fetch Data" button. AgentQL will run and then deliver
agentql-client/#944 Docql documentation · docs-next/content/docs/scraping/scraping-documents.md [view]
None of this is is necessary. Just link to the pages that show how to use queries. ```suggestion ```
agentql-client/#944 Docql documentation · js/src/agentql/core/aql-server-service.ts [view]
Is this ok to be live? Doesn't seem related to this PR
agentql-client/#944 Docql documentation [view]
I've made some edits to the documentation. Looks like another PR or two is in here—Actionablity check and some error messages. Can you reduce this to just the docs-relevant updates? Also be sure to add this to the sidebar and to the [Data Extraction section](https://docs.agentql.com/scraping)