@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

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

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!

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