An all-in-one VSCode extension for searching multiple documentation sources, without leaving your editor.
As a Software Engineer, searching documentation is a part of the daily routine, but finding that documentation site, in the middle of your open tabs or bookmarks is not always easy.
I built this extension, to simplify the process and be able to do it directly from VSCode.
- Search in dozens of documentation sites, whose search is powered by Algolia Docsearch, Mkdocs or available at DevDocs. These will probably cover 80% of documentation sites out there.
- Open a search result in your default browser, to see the documnetation in full glory.
This extension uses the public available endpoints of each documentation provider to do the search, so the results should be exactly the same when searching on the documentation sites directly.
There is no scrapping or indexing. It´s simply an HTTP request, to existing search engines.
By default, this extension includes the following documnetation:
- Apollo GraphQL
- Astro
- Babel
- Backstage
- Bootstrap
- Cloudflare
- Cypress
- Directus
- Echo
- ESLint
- FluxCD
- Gatsby
- GitLab
- Gorm
- Grafana
- GraphQL
- Gridsome
- Helm
- Jest
- Laravel
- NextJS
- NestJS
- Netlify
- Nuxt
- Parcel
- Pinia
- Prettier
- Prisma
- Prometheus
- React
- Scala
- Strapi
- Supabase
- Symfony
- Tailwind
- Terraform
- TRPC
- Typescript
- Vercel
- Vite
- VitePress
- Vue Router
- CSS documentation — DevDocs
- Git documentation — DevDocs
- Go documentation — DevDocs
- HTML documentation — DevDocs
- JavaScript documentation — DevDocs
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
ext install brpaz.vscode-docsearchTo activate the extension, toggle your command palette and search for Documentation.
After that, you will be prompted to select the documentation site your want to search, following by a prompt to input your search query.
If you want to disable a default documnetation site, provided by the extension:
- Open command pallete and select: `Preferences: Open user settings (JSON).
- create a new json object like the following:
"docsearch.defaultDocsets": {
"react": false,
}This example will disable React documnetation. Press CTRL+Space insde the object, to get autocomplete for the available documentations.
TODO
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This can happen, if there is any change in the documentation site, like changing the search provider or URL.
This is more frequent with sites provided by Algolia Docsearch, as it´s common for the website maintanters to change API Keys or other configurations of DocSearch. If you find a broken documnetation, please open an issue.
These API keys are required to be able to authenticate on Algolia Docsearch. They are read only and are already public as they are included in the various documnetation site sources, that implements Algolia DocSearch. You can see them in all the requests sent to Algolia. (just check the "Network" tab in your browser console).
👤 Bruno Paz
- Website: brunopaz.dev
- Github: @brpaz
If this project was useful to you in some form, I would be glad to have your support. It will help to keep the project alive and to have more time to work on Open Source.
The sinplest form of support is to give a ⭐️ to this repo.
You can also contribute with GitHub Sponsors.
Or if you prefer a one time donation to the project, you can simple:
This extension doesn´t scrape or index any documentation on their own. It simply uses public available endpoints provided by the different documentation sites.
This project wouldn´t be possible without Algolia Docsearch, DevDocs, MkDocs and all the websites building their docs portals using these technologies.
Copyright © 2023 Bruno Paz.
This project is MIT licensed.