Enhancement: provide API overview in docs
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 32.7k
- Forks
- 1.4k
- Avg merge
- 1d 14h
- Merged PRs (30d)
- 5
Description
## Feature request
First of all, thank you for creating Sharp! It's proven very useful for a number of my projects and is what I reach to first when needing any sort of image transformations or conversion. 😄
I'd be open to writing a PR for the following if it's something that is wanted on the Sharp docs.
### What are you trying to achieve?
- Currently to start using Sharp, you need to visit the Installation page and install, and then scroll through the Constructor page to find out how to construct Sharp (and import sharp - is it a default import? Named import? Docs don't really say), and then search through the docs on Resizing Images or other API doc pages for common use-cases.
- It would be nice to have a "quickstart" or "getting started" guide on the docs, similar to many other open-source documentation sites.
- A getting started guide is useful to help the user in getting Sharp installed and used as fast as possible.
- It doesn't need to be comprehensive or very long, that's what the rest of the docs are for, but a simple "visit the Installation page to install, then import sharp like this, construct sharp like this, here are some common use-cases, see docs for the rest" might be useful.
### When you searched for similar feature requests, what did you find that might be related?
- No related issues or feature requests.
### What would you expect the API to look like?
- N/A, docs change only.
### What alternatives have you considered?
- A section on importing Sharp within the existing Installation section. This would allow easier onboarding but would still require the user to look through the rest of the docs for common use-cases.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the existing Installation, Constructor, and Resizing Images documentation to understand the current onboarding path and import guidance. Done means adding a concise getting-started or quickstart guide that covers installation, importing Sharp, constructing it, and a few common use cases without duplicating the full API documentation.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, nodejs
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100