@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.

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

discovered livetechhelper.com, while the initiative could be positive explained, the execution is horrible! I found https://livetechhelper.com/repos/jaapio/phpunit
I can help with #phpunit but obviously any income should go to the original maintainers not to me because I created a fork!

Same applies to other projects, should we stop this?! #php #foss?

jaapio,
@jaapio@phpc.social avatar

@thomastospace I didn't even think of that...

ramsey, to php
@ramsey@phpc.social avatar

Opinions/thoughts/advice on monorepos with . Is anyone working within this problem space? What tools do you use?

I know is a . Are the tools they use specific to them, or can others use them?

jaapio,
@jaapio@phpc.social avatar

@ramsey I'm using it in https://github.com/phpDocumentor/guides

Using splitsh in a GitHub action by @frankdejonge. I know he is also using it on his projects.

Issues I mostly faced were about composer not fully installing my packages when working in the monorepo. But we covered that, check the repo.

ramsey, to php
@ramsey@phpc.social avatar

This is a pretty cool package, if you use with and . https://github.com/ajgarlag/AjglBreakpointTwigExtension

jaapio,
@jaapio@phpc.social avatar

@ramsey if you enable template cache and configure that directory in phpstorm you can step debug your templates. https://blog.jetbrains.com/phpstorm/2019/05/twig-and-blade-templates-debugging-2/

wyri, to github
@wyri@haxim.us avatar

My plan for this afternoon was to finish my centralized reusable #GitHub Actions workflows for releasing projects. But some outage is keeping me waiting 😅. (Can even see the self hosted runners spin up but not getting any jobs.)

jaapio,
@jaapio@phpc.social avatar

@wyri are those reusable of other projects as well?

ramsey, to Symfony
@ramsey@phpc.social avatar

Why does #Symfony 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)?

#PHP

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 #PHP 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 #Symfony 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 #Typo3 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 #PHP 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

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 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

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