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

wouterj, to Symfony
@wouterj@phpc.social avatar

Making nice progress on my next PR: Modern select questions for the Symfony Console component 🤩

A terminal running an interactive PHP script asking choice questions using the Symfony Console. Answers can be selected using arrow keys, enter and space, instead of the traditional text input of Symfony.

jaapio,
@jaapio@phpc.social avatar

@wouterj very nice!

ocramius, to random
@ocramius@mastodon.social avatar

I turned on a Windows PC today, just to:

  • install WSL
  • install openssh
  • set up SSH keys
  • enable port forwarding for port 22

I immediately wanted to go back to my linux laptop @_ The Windows UX is horrific.

jaapio,
@jaapio@phpc.social avatar

@ocramius agreed, the promise of wsl sounded great a few months ago. But I switched back to Linux after a lot of struggling with the tooling on windows. A lot of things I was so used to on Linux didn't simply apply on windows.

Windows is great for others, not for me

jaapio,
@jaapio@phpc.social avatar

@pierstoval I think the main difference is that I do not play games on my laptop, which is the only computer I have. I use debian/Ubuntu for so long that I'm partly blind to the missing things.
There are things that do not work, like oddness with vpn and docker.

On windows I had to search on the internet for everything single setting. Because I didn't know the system. I'm pretty sure that it will work for others. It's not a bad system. It's just not my preference.

@ocramius @thomastospace

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

Scary thought... Did you know that a large number of #php infrastructure projects are maintained by 1 single person, some 2 or 3... But the original maintainer has been doing that for more than 20 years+ what would happen if they step down?!
They will retire at some point... Who will take over? Shouldn't we invest in the future and start education on how to maintain a opensource project with millions of users?

jaapio,
@jaapio@phpc.social avatar

@shawnhooper that's about php itself, I was talking about the tools build on top of it. Like phpunit, php_code_sniffer. They are not support by that project are they?

jaapio,
@jaapio@phpc.social avatar

@tvbeek thanks for picking those up! @phpmd @pdepend

jaapio,
@jaapio@phpc.social avatar

@heiglandreas I think @derickr maintains more, we as php developers should be worried about when it's gone... I cannot do my job without datetime, but missing xdebug would also be a pain. I'm not sure what would be the hardest thing to take over.

jaapio,
@jaapio@phpc.social avatar

@ramsey I didn't read the document, but it would be great to have an equal foundation for tools that we cannot miss. There are many unseen but very important projects that would need funding. But I'm not sure money is the answer... My younger colleagues are spending time with their friends, rather then spending time on opensource.
I know I belong to a small group of people doing active contributions. But when I look around most of that group are older. The new generation does not seem to care?

jaapio,
@jaapio@phpc.social avatar

@derickr I'm afraid that I do not have the skills to help, nor the time to help. If I had I would love to get involved in xdebug. I did some c years ago, but that's not on the level you are at it. @heiglandreas

jaapio,
@jaapio@phpc.social avatar

@ramsey ok, I agree with your proposal, but what would we need to make this happen? From my side I'm not looking forward to being in long board meetings talking about the future of php. But if you tend to start something get in touch.

I'm pretty sure I'm next to a group of people that will immediately stand up when I ask them to join. Just for the sake of the language.

jaapio,
@jaapio@phpc.social avatar

@tvbeek yeah, I recognize that. It's very hard to find people that want to maintain the "boring" tools. Very developer tries to contribute once in a while on larger projects, but there are just a few interested in digging into the complexity of tools they use on a daily basis. I doubt if many are even capable of actually doing it.

Being a bit crazy helps😜

jaapio,
@jaapio@phpc.social avatar

@ramsey you mean you don't know what's needed?

jaapio,
@jaapio@phpc.social avatar

@ramsey I understand that, it's quite a job to accomplish, and we are both developers. Not commercial guys.

But your proposal is great, I will think about a way how I could help to make this happen.

jaapio,
@jaapio@phpc.social avatar

@ramsey just remember a man who might be able to help. I send him your document. Keep you posted when I get an answer

jaapio,
@jaapio@phpc.social avatar

@derickr works here without authentication, so might be an browser issue? @ramsey @shawnhooper

jaapio,
@jaapio@phpc.social avatar

@ramsey I have an appointment next week to talk about your document, let's see what happens.

jaapio,
@jaapio@phpc.social avatar

@ramsey just had my meeting, we discussed that most important is that we should make people aware about the pain. So let's start being loud about this. And start talking to people..
Not just here, but also at conferences, meetups and wherever people want to hear us.

jaapio, to php
@jaapio@phpc.social avatar

I really enjoyed building a prototype of a new feature in @phpdoc, in this case it was back on my list because of a question I got.
Not that I would develop just any random feature by request... but this was on my list for a long time.

From now on, phpdoc will have automatically generated uml diagrams based on your project.

For me, this a huge step forward towards a goal, making a thing in

Thanks @dgoosens for your question, that confirmed the need for this!

jaapio,
@jaapio@phpc.social avatar

BTW, I'm looking for feedback, https://github.com/phpDocumentor/phpDocumentor/commit/1ee5b84eb37b82279075f7551740542bb5b62788

Get your feed wet, and give it a try!

shauna, to random
@shauna@social.coop avatar

Hey open source friends! Do you know of any projects that maintain (or help their community maintain) a collection of plugins/extensions/sub-projects/packages/etc that work with the project?

I'm trying to research best practices.

jaapio,
@jaapio@phpc.social avatar

@shauna I think the does a good job on this, they seem to be very active supporting the community in many ways.

https://typo3.org/

dgoosens, to random
@dgoosens@phpc.social avatar

hi @mvriel
have been looking through the documentation, but could not find the answer

I'm wondering if the phpdocumentor diagram component can be used stand-aloone ?

technically, what I'm trying to achieve is to generate a UML diagram for each of my Bounded Contexts in a project...

jaapio,
@jaapio@phpc.social avatar

@dgoosens This is a first draft after a few hours tinkering with @phpdoc, is this what you had in mind?

I need to do more to make it feature complete, but I think this might be a start.

jaapio,
@jaapio@phpc.social avatar

@dgoosens please keep in mind this is in a very early state, it will take some more evenings to bring this in a functional state. I will keep you posted on my progress.

@phpdoc

jaapio,
@jaapio@phpc.social avatar

@dgoosens right now our class diagram shows the class structure of your application. But no relations between classes. So in case your domain has a Car, which as a number of wheels, you do not see a relation.

I think that would be usefull in some cases, does that make sense to you?
@phpdoc

jaapio,
@jaapio@phpc.social avatar

@dgoosens we have information about the api of the classes and property types. But I think we should stop at that level. Unless you document all exceptions that are thrown by methods @phpdoc is not aware of the internals of methods. So we would not be able to visualize that.

Let's first see how useful this will be as is. I will do this in iterations. As on the way I discover many more options.

jaapio,
@jaapio@phpc.social avatar

@dgoosens I pushed my first changes. If you are using docker these changes will be available immediately. When our pipeline is completed.

You can pull the latest tag for this. I'm looking forward to your feedback. :-)

https://github.com/phpDocumentor/phpDocumentor/commit/1ee5b84eb37b82279075f7551740542bb5b62788

@phpdoc

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