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

dseguy, to random French
@dseguy@phpc.social avatar

TIL file_put_contents() accepts an array as second argument, and will do an implode("", $array) on it when writing.

Who is using this feature?

cc /@Girgias

https://php-tips.readthedocs.io/en/latest/tips/file_put_array.html

jaapio,
@jaapio@phpc.social avatar

@dseguy why... 😳

jaapio,
@jaapio@phpc.social avatar

@wyri because the logic of php internals is not what we think of 😋@Girgias @dseguy

shochdoerfer, to random
@shochdoerfer@phpc.social avatar

Never thought I would say it, but constructor property promotion is really a neat feature in PHP.
I really miss it in some other programming languages...

jaapio,
@jaapio@phpc.social avatar

@shochdoerfer same

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

Hi @dgoosens

We do not really have support for this currently, but I think we would have all ingredients in @phpdoc to support this. A recent addition that we added are queries that allow you to query our internal object structure and render those on a page. I would be more than happy to help you implementing this feature in the core of phpDocumentor.

Maybe we should move this dicussion to a github issue and gather all the requirements?

@mvriel

jaapio,
@jaapio@phpc.social avatar

@dgoosens rethinking this, what if you would create a phpdoc config file per context?

We want to support multiple api doc sets in a single config, but that's not supported right now. But might be a bit easier to implement and to configure by users. https://docs.phpdoc.org/guide/references/configuration.html#appendix-a-basic-configuration-example

However I think in a DDD setup it makes more sense to have a combination of documents and api docs. We can generate a list like this, in your documentation page
https://docs.phpdoc.org/guide/internals/templates/index.html

@phpdoc @mvriel

jaapio,
@jaapio@phpc.social avatar

@dgoosens @phpdoc @mvriel

I'm currently very busy with other phpdoc related stuff, but I think I might have time next week to try to hack some POC.

This feature is on my list for a very long time. And since last month pieces are slowly coming together, so I will keep you posted.

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

@jrf_nl I'm searching for a sniff to enforce a file level comment in each file in my repositories. What would be the best way to find such a sniff? Rather than spamming you? 🤪

jaapio,
@jaapio@phpc.social avatar

@jrf_nl a bit, however I just wanted to enforce the full license header in all files. Which both sniffs can't do? Just checking for some styles and tags. Not the contents of the summary and description.

jaapio,
@jaapio@phpc.social avatar

@jrf_nl would that be a sniff you would accept in a pr? To auto fix license headers? Including year increase 😁

wyri, to privacy
@wyri@haxim.us avatar

Just a FYI but if your cookie wall starts with "We value your privacy" and then forces me to go through a list of 1512 partners to turn them off one by one, instead of an easy "Reject all" next to your "Accept all". You don't give a flying fuck about my #privacy.

jaapio,
@jaapio@phpc.social avatar

@wyri I do quite those websites more often, I don't want to be their product, and I don't need their shit if they do not care about the promise they make.
Probably their service is as bad as their website 🤪

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

Spend some time tonight setting up trash collection notifications in home assistant. I will now be notified when I need to move the trash bin outside. Including a confirmation that I did it.

Saves me another useless 3th party app on my phone.

jaapio, to php
@jaapio@phpc.social avatar

When writing documentation about your application I find my self creating lists of classes. Opening up my editor, and search for all implementations of classes that extend a base class.

So why would we not just automate this shit? @phpdoc next release will have the first draft implementation for this feature.

Write your documentation in RsT and query the api docs to create a list:

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

I'm gonna make you feel old... Remember #php 5 was released in 2004.
To me this means that I have been writing php for 20 years now. How about you?

jaapio,
@jaapio@phpc.social avatar

@heiglandreas call me when you found one... I would like to see that happen

jaapio,
@jaapio@phpc.social avatar

@shochdoerfer depends on the php parser being able to read that... I think it goes back to php 5 not before... @heiglandreas

jaapio,
@jaapio@phpc.social avatar

@mwop thanks for being around for so long! I remember the release of zf2 which changed my way of thinking about how to write applications.

wyri, (edited ) to php
@wyri@haxim.us avatar

Rethinking configuration for my #OpenAPI/#OAS #PHP client generator while transforming it into a package generator. Currently using #YAML hydrating into #PHP classes. Mainly looking to support both those wanting to keep it simple and those with complex setups without to much duplication.

jaapio,
@jaapio@phpc.social avatar

@dseguy it should be possible to build this using symfony/config. They support a decoupled config definition in php, you just need to write a parser @wyri

jaapio,
@jaapio@phpc.social avatar

@dseguy @wyri in theory any format could fit. As long as the parser outputs the same AST/DSL.

jaapio,
@jaapio@phpc.social avatar

@wyri @dseguy yeah they see this as advanced usage, so you need to dig in the code. I disagree with that, but I understand that they have to limit their time on docs.

Skoop, to random
@Skoop@phpc.social avatar

Promised myself not to code on 25th and 26th. While it's tempting to do some coding now, I'm going to stop myself right here, and instead start Football Manager again. I just took on the role of manager of FC St. Pauli. That seems to be an important role :)

jaapio,
@jaapio@phpc.social avatar

@Skoop what's wrong with a good coding session during Christmas?

jaapio,
@jaapio@phpc.social avatar

@Skoop ah work, writing code is not just work.

sebastian, to php
@sebastian@phpc.social avatar

Happy Feast of Winter Veil, my dear #PHP community! I wish you and yours a nice and quiet time.

I have resolved not to look at the issue trackers of my open source projects for the next few days. After all, even I have to take a break at some point ...

jaapio,
@jaapio@phpc.social avatar

enjoy your time off @sebastian

ramsey, to random
@ramsey@phpc.social avatar

When you’ve accepted a job at a new company where they use tech you did not have previous experience with, did you have to take a pay cut or a lower (more junior) title? If not, how did you convince the interviewers of your ability to quickly acquire the new skills?

jaapio,
@jaapio@phpc.social avatar

@ramsey if it was up to me I would hire you for any leading software position. You showed that you are able to build a community, and care about people. You can speak for a large audience, those skills are more valuable to me than any technical skill.
What you don't know can be learned on the job. Please don't forget software development is not about the language, it's about people. You know that

Unfortunately, I'm in the wrong position on the other side of the world.

ocramius, to random
@ocramius@mastodon.social avatar

Reminder to use @mozilla Firefox:

it works, it respects your privacy, and you should do your part in stopping the web from becoming a glorified Webkit workspace.

jaapio,
@jaapio@phpc.social avatar

@anthony that's not the fault of @mozilla that's what's happening when WebKit takes over the internet

Cc @ocramius

heiglandreas, to random
@heiglandreas@phpc.social avatar

TIL class-constant handling in PHP is completely bollocks...

I'll use for internal stuff private constants and for everything that is used in more than one class I'll create Enums.

Everything else is a mess.

I'll need some more research for a blogpost though....

jaapio,
@jaapio@phpc.social avatar

@heiglandreas and remove expressions please 🥺 @timwolla

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