News for hackers. Stuff that matters.
Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by Twisell on Wednesday October 09, 2024 @05:08AM (#41785890)
It's minimalist until you read the installation part...

As a backend SQL guy I always feel overwhelmed by "minimalist" software that actually depend on me knowing ho to deploy safely on docker or mastering N dependencies before actually having something to try. Long are gone the lamp days... they had their own set of problems (wrong versions!) but it was a simpler time where you felt a little bit more in control.

Old man yell at the clouds I guess...

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by al_borland on Wednesday October 09, 2024 @08:11AM (#41787000)
I often feel the same way. I had someone ask me to make a microservice on some platform she built. I was told it would take 10 minutes. In reality, it took a couple weeks, and then every week for a year I was getting told something was changing and I had to mess with this or that, and also attend daily meetings about the project. 10 minutes turned into 30% of my whole year. The whole platform she built lasted maybe 2 years before it was decided we needed to move on from it. It was a total waste of time.

Meanwhile, I have a little LAMP project that is used significantly more than the micro service, that I’ve run for 15 years that I only have to touch when it needs feature updates. The platform itself just works. Occasionally I’ll need to move to a newer OS, which takes a few hours to get the new server built, run the job to configure it (doing it manually doesn’t take too much longer), then submit a request to change the load balancer to point to the new servers.

Granted, some of this comes down to experience. However, needing to know all the tools involved for the microservice was much more annoying and they broke half the time.

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by klaussilveira on Wednesday October 09, 2024 @11:51AM (#41789261)
Boring technology just works. That's why it is boring and not appealing to younger developers.

https://boringtechnology.club/

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by 1oooqooq on Thursday October 10, 2024 @01:00AM (#41795677)
people forget that you need a huge ranch, and several farm hands etc to handle cattle.

while everyone can care for pets with little effort.

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by Twisell on Saturday October 12, 2024 @07:32AM (#41818357)
That's another subject altogether. Huge ranch tools makers don't advertise their solutions as "simple".

They usually don't advertise at all to the general public because they are b2b oriented.

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by castlec on Wednesday October 09, 2024 @08:01AM (#41786933)
Its comprehensive. It is not complex. They just show all of the typical ways one would want to deploy.
Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by rcarmo on Wednesday October 09, 2024 @08:31AM (#41787183)
I can't see any issue with what's in the installation part. It all looks very straightforward for _each_ installation method.
Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by SansGuidon on Wednesday October 09, 2024 @08:49AM (#41787356)
come on, you just need to teach a bit of git/k8s/docker/tls/proxies/storage/vault/markdown/linux/apt and then your family will be autonomous at managing this wiki IF you are allowed to take vacations.
Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by simonw on Wednesday October 09, 2024 @09:58AM (#41788077)
I got it running locally like this, using uv to manage dependencies:

    git clone https://github.com/redimp/otterwiki.git
    cd otterwiki

    mkdir -p app-data/repository
    git init app-data/repository

    echo "REPOSITORY='${PWD}/app-data/repository'" >> settings.cfg
    echo "SQLALCHEMY_DATABASE_URI='sqlite:///${PWD}/app-data/db.sqlite'" >> settings.cfg
    echo "SECRET_KEY='$(echo $RANDOM | md5sum | head -c 16)'" >> settings.cfg

    export OTTERWIKI_SETTINGS=$PWD/settings.cfg
    uv run --with gunicorn gunicorn --bind 127.0.0.1:8080 otterwiki.server:app
I filed an issue here suggesting that for the docs https://github.com/redimp/otterwiki/issues/146 - and also that it would be great if getting started could be as simple as this:

    pip install otterwiki
    otterwiki \
      --repository app-data/repository \
      --sqlite app-data/db.sqlite \
      --secret-key secret1 \
      --port 8080
Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by oarsinsync on Wednesday October 09, 2024 @10:47AM (#41788482)
And to think people used to think

  ./configure —-prefix=/home/user/appname
  make
  make install
was too complicated
Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by emj on Friday October 11, 2024 @08:55AM (#41809062)
The problems was mainly that even "apt-get build-dep" is not enough to handle all the problems that arise from that. Even if configure was standardized, there was always problems with diversity in systems.

The NIH syndrome is still big in software build tools, everything is complicated unless you have written it yourself in your environment. Admitted I seldom run those commands manually anymore, but things have gotten way worse when I do try. Specific versions of tools, libraries and kernels, or just kernels. Nix build scripts are actually one of the worst offenders here often ignoring every other standard available. Not saying it is bad, just an example of why what you write above is more complicated than it sounds.

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by rcarmo on Wednesday October 09, 2024 @04:07PM (#41792081)
I got it to work under Piku (https://piku.github.io) in much the same way (since I support uwsgi, that bit was trivial).

I did have to hardcode the data path, and I think having some form of export/snapshot would help as well, but submitting a patch might be a fun weekend project.

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by mock-possum on Wednesday October 09, 2024 @02:21PM (#41791031)
Yeah I’m with you. I cannot stand having to jump through hoop after hoop just to get started - things to download, command line utils to install, line after line after line to copy into the terminal, layers and layers of dependencies, possibly with version incompatibilities that the “getting started” page was never updated to reflect… it’s a nightmare.

Sometimes you just want to sit down and write code and see it working.

Re:Otter Wiki: A minimalistic wiki powered by Python, Markdo... by nine_k on Wednesday October 09, 2024 @02:22PM (#41791044)
But deploying on Docker is simpler than LAMP! All dependencies included. All binaries included. You can even just tell systemd run it (also usually included).