jaapio

jaapio, 9 days ago to markdown Dutch

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, 12 days ago to php Dutch

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, 1 month ago to random Dutch

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!

jaapio, 1 month ago to delhi Dutch

On May 30, I will talk about dead #documentation, and how to bring your docs alive. Are you joining me and become Dr Frankenstein?

#meetup, #LivingDocumentation

https://www.meetup.com/brabantphp/events/300465423/

jaapio, 2 months ago to php Dutch

I'm in the process of creating a new version of @phpdoc ReflectionDocblock component. Internally quite some things have been improved, and a lot of stuff has been added. But it feels so scary to release a new version of a project which was downloaded 7 million times last month.

#php #onmyown

jaapio, 2 months ago to foss Dutch

I contributed to two new projects today. I'm using both for a client. One was a typo in a variable preventing the object from being serialized properly. The other was a wrong example in the documentation of a package that cost me a few hours to figure out what I was doing wrong.
How did you improve your #foss today?

jaapio, 2 months ago to foss

In the past 5 years that I have been working for @ingewikkeld I was able to spend almost every Friday on my open source work. Which sums up to about 20% of my time with @Skoop and @mvriel. A full year of development!

Curious what #foss can do for you or your company? Talk to @Skoop he is able to explain this very well!

jaapio, 2 months ago to opensource Dutch

Years ago I started planning my #opensource work to ensure I spent some time on it every week. By that time Tuesday evening was the most suitable evening. And I still do this every week. Yes, sometimes I skip a week, but it helps to plan things you like. Who is with me? #php #foss

jaapio, 3 months ago to php Dutch

Spend 6 hours squize out 4 minutes more minutes of the rendering process of #typo3 changelog rendering. By now the rendering process without cache takes 2.15 min on my laptop.
This does not only save time but also a lot of computing power. How much CO2 reduction would this be in the long term?
#php #documentation

jaapio, 3 months ago to random

I announce the immediate availability of phpDocumentor/guides 1.0.0.

Read my full story on Linkedin or the image attached to this message.
https://www.linkedin.com/feed/update/urn:li:activity:7170173363275943936/

jaapio, 3 months ago to random Dutch

It's almost the end of valentine's day, and as much as I hate the commercial shit around it.
So much I do love working with @Skoop and @mvriel. thanks guys for being my heroes in the past year.

Talk to them if you see them at a conference, they won't bite I promise, but be aware! You will never forget them! 🫂

#phpc #dpc24 #WebCampVenlo

jaapio, 4 months ago to php Dutch

I learned about an idea that lives in our community to start a foundation to help the community.
Yes I know we have the @thephpf, that's mainly focused on core development of php. #php is much larger than just the language, we have user groups, conferences, meetups, speakers, opensource projects and their maintainers.
Most of them operate for free, but they have expenses. speakers at php conferences do not get paid, part of their expenses are covered but not all.

Let's talk!

jaapio, 4 months ago to php Dutch

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, 4 months ago to php

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 #LivingDocumentation a thing in #php

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

jaapio, 4 months ago to random Dutch

@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, 5 months ago to random Dutch

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, 5 months ago to php

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:

#php #LivingDocumentation

jaapio, 5 months ago to php Dutch

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, 6 months ago to php Dutch

I was remembered today that opensource is much more than just writing code together. It's about knowledge sharing, teach other developers how to deal with certain issues. This is even more rewarding than writing a piece of code. #oss #php

jaapio, 7 months ago to php Dutch

What if your class api docs, generated by @phpdoc would be available via an api?

I'm trying to find a way to create inter project references, that allow your api to consume the docs of your dependencies.

For example, if you base a project on classes from your framework, extend the base classes, implement interfaces. I think it would be nice to have that in your docs. With links to the original source.

What do you think?
#docs #api #php

jaapio, 8 months ago to random Dutch

Thank you @getsentry for sponsoring my work on @phpdoc

Do you want to help me as well to spend more time on phpDocumentor, have a look at our GitHub page for the options!

jaapio, 8 months ago to ai Dutch

Dear internet, I would like to make it easier to searching and interact with my documentation. Introducing ChatGPT would be an option. But I do not want any other company to access my project internals. What options do I have?
I prefer open source tools, as I might want to build this into an open source project
#ai #llm #documention #chatbot

jaapio, 9 months ago to wordpress

I have been working on the new @phpdoc extensions feature today... A first impression of what you could do with extensions.

A new extension that allows you do add #wordpress hooks to you docs!

jaapio, 9 months ago to wordpress Dutch

He #wordpress devs how are you documenting your custom plugin hooks?
Do you have some examples for me to look at?

Cc @milana @jrf_nl
#php

jaapio, 10 months ago to random Dutch

At the camping, and for some reason I got a feeling that I want to write documentation for @phpdoc. But I didn't bring my laptop... With reasons...