@jaapio@phpc.social avatar

jaapio

@jaapio@phpc.social

https://phpc.social/@phpdoc maintainer,
developer at Tilaa,
Opensource lover

With more than 10 years of professional software development I like to help teams and projects improve their documentation. Because I do belief that we should generate documentation. Not write it.

I'm building tools and libraries to help you with just that, so you don't have to. And can focus on what matters... your product.

I prefer #php as my main language, but when needed I can write other languages as well.

This profile is from a federated server and may be incomplete. Browse more on the original instance.

ramsey, to Symfony
@ramsey@phpc.social avatar

Why does define what appears to be a “real” value for APP_SECRET in the .env file that’s committed to your repository, and then, right above it, there’s a comment that says (in all caps):

“DO NOT DEFINE PRODUCTION SECRETS IN THIS FILE NOR IN ANY OTHER COMMITTED FILES.”

Where’s the documentation that explains what APP_SECRET is used for? Why doesn't it put this value in .env.local (ignored by .gitignore)?

jaapio,
@jaapio@phpc.social avatar

@ramsey downside... It's not a glue between symfony and existing middleware, which kinda defeats the purpose of psr?

jaapio,
@jaapio@phpc.social avatar

@ramsey @Crell it's used for some hashing and random generation. Yes it's odd that they add a default value.

The env files and the way they are loaded can be a beast. But many other frameworks are doing it this way.

jaapio,
@jaapio@phpc.social avatar

@ramsey oh, that's interesting! I didn't get at my first look. I was wrong. Sorry about that.

ramsey, (edited ) to random
@ramsey@phpc.social avatar

I managed to avoid for 10 years, but it’s finally caught up to me, so I hope I’m a Kubernetes god after going through all this required (by job) Kubernetes training.

When do I start honking like a duck goose?

jaapio,
@jaapio@phpc.social avatar

@ramsey fun fact is, you can replace concepts of k8s with concepts you know for years. An ingress... Just a vhost. Service just a dns rec with ports.

It's not entirely correct, but it helped other devs around me to understand more of the terms.

ramsey, to php
@ramsey@phpc.social avatar

Is there anything like symfony/asset-mapper (and symfony/asset) that folks can recommend using with a non-Symfony app?

I can probably figure out how to use these by themselves, but I'd prefer a general, stand-alone library/tool, rather than attempting to shoehorn a package into a non-Symfony app.

That is, unless someone can point me to a tutorial that shows how someone else has already done this? 😁

jaapio,
@jaapio@phpc.social avatar

@ramsey I remember I did try to use it in an non symfony application, but I do not remember where and if I did push it to a repo. When I find it I will send you a message

heiglandreas, to random
@heiglandreas@phpc.social avatar

I hate VPN!

It never worked out of the box for me. There are soooooo many moving parts.

Debugging is difficult.

And it's always the clients fault...

jaapio,
@jaapio@phpc.social avatar

@heiglandreas I feel your pain, currently using a vpn that blocks some of the connections. Although it should only be used for certain ip ranges. Which aren't visible in my routing table.

It just works for everyone...

jaapio,
@jaapio@phpc.social avatar

@heiglandreas yes of course... And I'm the only linux user😔

jaapio,
@jaapio@phpc.social avatar

@heiglandreas yes of course... And I'm the only linux user😔

awoodsnet, to random
@awoodsnet@phpc.social avatar

@ramsey what did you use to make thai site? Looks fantastic! https://uuid.ramsey.dev/en/stable/index.html

jaapio,
@jaapio@phpc.social avatar

@heiglandreas thanks Andreas, I think @ramsey is aware of phpDocumentor. But maybe not of the ability to render markdown and restructured text. Sphinx does a great job. But phpDocumentor is faster, and written in #php 😊

@awoodsnet

jaapio,
@jaapio@phpc.social avatar

@ramsey it was, about 8 years ago we changed our goal. phpDocumentor will be a documentation framework. That's what we are working on right now. since 1 year we have had full support for RST. Markdown is still experimental, but also ready to be tested by end users.

I will keep building on this until we have the ultimate documentation tool for php. That can generate uml diagrams out of code, and fully integrates api docs with developer docs.

See our docs for examples

@heiglandreas @awoodsnet

jaapio,
@jaapio@phpc.social avatar

@ramsey it's production ready. The RST parser is a collaboration with the documentation team. They recently switch to our parser completely.
phpDocumentor itself doesn't contain the latest version yet. I expect a new release somewhere this month. Since 3.3 it's really usable.

We do have a GitHub action so it's easy to integrate in your pipelines. No hosted solution right now. But maybe that will follow in the future. Might be a nice idea. However GitHub pages also works.

jaapio,
@jaapio@phpc.social avatar

@awoodsnet that would require another parser. In theory it's just that, but I never tried to build a second one.
We do a lot of reflection in php. Trying different type resolution strategies. Not sure a complex tool like phpDocumentor would be the best fit for bash

@ramsey @heiglandreas

asgrim, to random
@asgrim@phpc.social avatar

I wonder if the Bri'ish "bo'u'o'ua'ah" is the longest English string of vowels in a word? 🤔

jaapio,
@jaapio@phpc.social avatar

@derickr sorry the "new" rules changed that. Since 1996 it's "koeienuier". The way you pronounce it hasn't changed.

@asgrim

sean, to php
@sean@scoat.es avatar

Remember when software publishers made an effort to make their documentation available for use offline? That was cool.

(About to get on a flight and wanted to download the docs for an open source library that’s pretty new to me. I don’t see a way of doing that short of crawling a few dozen (hundred?) HTML pages, or maybe building the docs from the source, myself. Situations like this always remind me how proud I was—and should be—about the work we did on the manual, way back.)

jaapio,
@jaapio@phpc.social avatar

@sean interesting 🤔 maybe I should build this into @phpdoc. A single page html template could do something, because it can be turned into a pdf. But building an artifact of all documentation formats could also be an option.

jaapio, to random Dutch
@jaapio@phpc.social avatar

I felt a bit down because I had to abort my vacation with a mobile home to Denmark, we actually never reached the border. Due to a defect accu. Luckily I have friends like @Skoop and @DadaProvider to send me a replacement. Thanks guys!

Skoop, to random
@Skoop@phpc.social avatar

When I did that keynoting thing first. 9 years ago in the same city I'm in now: Mannheim.

Oh how flies time.

jaapio,
@jaapio@phpc.social avatar

@Skoop you are explaining for 9 years that developers are like humans? 😳

jaapio, to delhi Dutch
@jaapio@phpc.social avatar

On May 30, I will talk about dead , and how to bring your docs alive. Are you joining me and become Dr Frankenstein?

,

https://www.meetup.com/brabantphp/events/300465423/

ramsey, to random
@ramsey@phpc.social avatar

vimeo/psalm version 5 requires nikic/php-parser ^4.16

phpunit/phpunit version 11 requires phpunit/php-code-coverage ^11.0

phpunit/php-code-coverage version 11 requires sebastian/lines-of-code ^3.0

sebastian/lines-of-code version 3 requires nikic/php-parser ^5.0

End result: can’t upgrade to PHPUnit 11 if using Psalm.

😭🐼

jaapio,
@jaapio@phpc.social avatar

@ramsey psalm also has a composer package that installs a phar. "psalm/phar" that will help you to avoid these issues

jrf_nl, (edited ) to opensource
@jrf_nl@phpc.social avatar

Oops.. guess who's doing the opening keynote at WordCamp Europe together with the incredible @joost ?

Our talk is called "Sustainable open source is the future".

https://europe.wordcamp.org/2024/schedule/

#WCEU #opensource

jaapio,
@jaapio@phpc.social avatar

@jrf_nl @joost congratulations, but I do not think this is by accident 😁

packagist, to php
@packagist@phpc.social avatar

👋 We're hiring a Senior Software Engineer in Berlin or remote! 💻 Build high-quality supply chain tools for thousands of devs in the PHP ecosystem 🐘 with the makers of Composer.

We're a small experienced remote team, deeply caring about our customers and the quality of our product. 🧑‍🤝‍🧑 Help us maintain and improve key infrastructure for hundreds of businesses! 🎉

https://packagist.com/about/careers/senior-software-engineer-1

jaapio,
@jaapio@phpc.social avatar

@derickr until nedix happens...
I truly hope it will never happen, but it's a thing

@MarkBaker @Skoop

jaapio,
@jaapio@phpc.social avatar

@derickr that means that I have to trust him on his words... Anything can happen in the next years.

jaapio,
@jaapio@phpc.social avatar

@derickr we can just vote for another party right? That's how this works 🤓

Cc @Skoop @MarkBaker

jaapio,
@jaapio@phpc.social avatar

@derickr from my point of view, I cannot argue against stupidity. Problem is many people are just angry, they are not reasonable. And if they get disappointed they will become more angry. Which will make them vote more extreme.
They only way to get a more sustainable systeem is to accomplish something that makes them less angry. So we can start talking again.

@Skoop @MarkBaker

heiglandreas, to random
@heiglandreas@phpc.social avatar

Another case of Symfony suffering from NIH-syndrome unfolding... 😕

💔

jaapio,
@jaapio@phpc.social avatar

@wouterj @heiglandreas no worries, I'm already in contact with them

jaapio,
@jaapio@phpc.social avatar

@mwop in this can it wasn't an adoptation but just a new build project. However when I read the code it's very likely that the authors had a look at my project. Class names are equal, and also the structure of the code looks much like the original project.

I would have been open to help them out, which I did before. If I just got a question. It's not that phpDocumentor is a new project. And with more that 7M downloads a month it's not that you can not trust it.

cc @heiglandreas @wouterj

  • All
  • Subscribed
  • Moderated
  • Favorites
  • •
  • Leos
  • rosin
  • InstantRegret
  • ethstaker
  • DreamBathrooms
  • mdbf
  • magazineikmin
  • thenastyranch
  • Youngstown
  • tacticalgear
  • slotface
  • Durango
  • khanakhh
  • kavyap
  • megavids
  • everett
  • vwfavf
  • normalnudes
  • osvaldo12
  • cubers
  • GTA5RPClips
  • cisconetworking
  • ngwrru68w68
  • anitta
  • provamag3
  • tester
  • modclub
  • JUstTest
  • All magazines
    •