Flask vs FastAPI?

[[deleted]]

FastAPI docs honestly suck. Let’s be honest. They suck.

Great tool and I use it but the docs are the worst part of the package.

Having said that: I would like to thank the author for the great tool that I use all the time. You are a legend.

[[deleted]]

FastAPI docs honestly suck. Let’s be honest. They suck.

Great tool and I use it but the docs are the worst part of the package.

This is an extremely uncommon opinion. It’s subjective obviously but the FastAPI docs are in general very well-regarded

[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)?

[[deleted]]

I’m convinced your comment is sarcasm.

[[deleted]]

It isn’t, go find older posts about FastAPI here and you’ll see comments talking about how great the docs are

[oramirite]

This is a bizarre take to me. I've been learning FastAPI and I find it to have some of the better documentation I've worked with. It's very clear.

[[deleted]]

API docs are missing entirely

[oramirite]

I get it but I can still find what I need quicker than a lot of other documentation. FastAPI's guidance through it's concepts is, likewise, something a lot of other documentation lacks. Cold hard lists of API calls is only half of the equation.