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

thomastospace, to random
@thomastospace@phpc.social avatar

I just started a plain typescript project, and was too lazy for a docker setup so I just installed Node with apt and went on my way.

I installed Typescript, that went fine, but when trying to use it it gave a vague error.

Quick search fixed it, but... I'm amazed by the cause: Typescript didn't support the version of Node I had installed, which sure.. That's okay. But why didn't NPM tell me this? NPM does not have node version constraints?!?

🤯

jaapio,
@jaapio@phpc.social avatar

@thomastospace every time I try another language, I feel blessed that I'm able to work with the most powerful and reliable package manager of the world. Nothing beats #composer

#php

jaapio,
@jaapio@phpc.social avatar

@syntaxseed yes that's my strategy as well, I rarely use composer update. I use composer require to bump versions because that will give me the latest possible version.

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

I'm investigating options that are available to create a table of contents in #markdown, really wondering what people are using to create that when writing markdown based docs.

Please boost for reach.

#documentation

jaapio,
@jaapio@phpc.social avatar

@dantleech that means that you do not have any influence on the order of the chapters? And all headers are included? Or can you specify the maximum level?

I do completely understand that you prefer RST as it is much more powerful and easier to extend with custom syntax. The reason why I'm looking for a way to build a TOC is because @phpdoc users do request for it.

ocramius, to random
@ocramius@mastodon.social avatar

Send invalid Authorization headers to Atlassian Confluence: get 200 responses back, with empty results.

I despise Atlassian: they're so bad at writing software.

jaapio,
@jaapio@phpc.social avatar

@asgrim @herndlm @ocramius @ciaran interesting tool, will definitely look at this when improving @phpdoc

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

jaapio,
@jaapio@phpc.social avatar

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

ramsey, to php
@ramsey@phpc.social avatar

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

I know #Symfony is a #monorepo. 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 #Twig with #PHP and #Xdebug. 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 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

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