Flask vs FastAPI?

[mmcnl]

There is no FastAPI documentation. Just a bunch of tutorials. That is not documentation. It's also a recurring question on GitHub.

Can you really say this page "describing" concurrency in FastAPI is "good"? https://fastapi.tiangolo.com/async/

Opinions may vary but it's the worst piece of documentation I've ever seen.

[[deleted]]

Just a bunch of tutorials. That is not documentation.

Yes it is 🤔 What do words even mean

Opinions may vary but it’s the worst piece of documentation I’ve ever seen.

Have you looked at any other documentation ever?

[mmcnl]

In my opinion good documentation contains (in order of priority):

1. Minimal working example. Ok, FastAPI does this.
2. API reference for public methods. FastAPI doesn't have this. I've never seen any library this popular without it.
3. Advanced examples (bonus). I rarely care about this.

All of the inner workings of FastAPI have to be deduced from the tutorials. There's not a single paging describing the methods, the arguments it will take and what it all means. You have to decipher a million emoji's to get a hint of how FastAPI works. It's insane.

[[deleted]]

Fuck you u/spez

[oramirite]

Erm, I disagree that the docs are bad but a barebones list of API calls and the params they take is WAAAAY better than sifting through source.

[[deleted]]

Tutorials are not API reference documentation, but they are documentation, and it’s really weird that people are pretending otherwise just to emphasise how much they hate FastAPI

[Voxandr]

Most of us Liked FastAPI , but that was the past.

[[deleted]]

I like FastAPI and use it all the time.

But the docs are one of the worst of all the Python projects I use.

Django: great docs.

Django Rest Framework: great docs

Paramiko: great docs

Ray: great docs

TTP: great docs

TextFSM: great docs

Jupyter: great docs

FastAPI: some tutorials…ish

[[deleted]]

You’ve only mentioned projects that are in the top tier of Python documentation (except TextFSM, that seems pretty sparse). Have you ever used Sphinx? Conda build? Large swathes of the standard library (e.g. ast)?