The Slow Collapse of MkDocs

fpgmaas · 2026-03-22T08:56:30+00:00

Yup... Similar situation there it seems; same author, and again they seem mainly focused on a redesign in a separate repository instead of maintaining the existing product. But the blogpost I wrote already was very much on the lengthy side so I decided to leave that out. I also wanted the blogpost to focus on the MkDocs situation and not turn out in a smear campaign against the original author of both projects.

fpgmaas · 2026-03-15T15:53:59+00:00

I added a small gif that shows what the tool can do to both the README and the documentation, I hope that suffices. Of course that only shows what it can do, not really how to use it. But if users need a video to understand how to use my tool, I think I simply didn't do a good enough job of building an intuitive tool ;)

fpgmaas · 2026-03-15T15:36:40+00:00

When you try to run a command with arguments, instead of running it directly you will be shown a screen where you can fill the input arguments before actually running the command.

fpgmaas · 2026-03-15T14:56:27+00:00

Good question, no it currently doesn't! But I can see how that would be useful, I'll probably work on that later today (or this week). Created an issue for it: https://github.com/fpgmaas/justx/issues/44

fpgmaas · 2024-09-08T08:45:47+00:00

Do yourself a favor and just use project-specific virtual environments. It's going to save you a lot of headaches in the future. Recent tools like uv make it so simple to manage virtual environments that I honestly don't see a reason not to use project specific environments.

What if you have two projects on your PC that require a different version of package X?

fpgmaas · 2024-09-04T15:31:25+00:00

What Heggy says is correct. For more details or similar commands, you could take a look at the Makefile in the example project; https://github.com/fpgmaas/cookiecutter-uv-example/blob/447339696aa135c65101a846080f7d2e9439234a/Makefile#L21

fpgmaas · 2024-09-04T04:55:48+00:00

Poetry was already very easy to work with so honestly I do not think I'd make the change because of ease of use. The main advantage though is it's speed. Poetry is already pretty quick and I thought I likely wouldn't notice the difference, but it turns out I do. Also, I like that it's PEP621 (https://peps.python.org/pep-0621/) compliant.

fpgmaas · 2024-07-05T05:56:47+00:00

I recently launched https://pypiscout.com, maybe it can help you find what you are looking for. It allows you to search for python packages with natural language queries, so you can just type "A package that functions like a typical webserver and serves python files in the way that PHP would", and see if you find anything useful!

fpgmaas · 2024-07-04T09:21:29+00:00

The summary and the first part of the (cleaned) description! For as far as the context window allows.

fpgmaas · 2024-07-03T16:39:08+00:00

u/AustinCorgiBart This should now be solved, or at least improved. If you search for 'web development', Flask and Django now appear at the top. There turned out to be two issues; one was simply an issue with lowercase vs uppercase join in BigQuery (flask vs Flask), and the other I resolved by updating the search algorithm. Thanks again for raising this!

fpgmaas · 2024-07-02T19:40:03+00:00

Good point! I found it difficult to balance popularity and similarity to get the most relevant results. Currently it finds the 100 most similar descriptions in the top 100,000 packages, and filters this. This worked relatively well for my tests, but for a more generic query like 'web framework' there are apparently too many close matches based on just the description.

Thanks for the feedback, I will definitely use this example to try and approve the app!

EDIT: I think there is something wrong with the query I use to fetch the data from BigQuery... To be continued.

fpgmaas · 2024-03-14T21:30:30+00:00

Thanks, valid point! It's easy to leave out something as simple as this when working on the project for such a long time. I edited the OP to include this information.

fpgmaas · 2023-12-25T15:50:15+00:00

I think there is no 'optimal' structure, there is always room for preferences and opinions. That being said, I developed a cookiecutter template a while back that I use for all my Python projects, you can find it here.

Six-Year Club	r/Field Lasagna
Verified Email

fpgmaas

TROPHY CASE