#246 D-Bus overview [Fedora]
Closed: published a year ago by rlengland. Opened a year ago by rlengland.

Article Summary:

Overview of the basic concepts of D-Bus that a developer needs to know to create applications that can talk to others via D-Bus.

Article Description:

D-Bus has become the de facto standard system to enable communication and collaboration between different applications in the GNU/Linux world. Either to expose an interface from your app to others, or to communicate with an app that exposes one, using D-Bus is a great idea nowadays.

The article would contain detailed explanation of the basic concepts about D-Bus that a developer needs to know in order to start integrating D-Bus into his/her app. It would cover:

  • What different buses normally exist in a system
  • How applications identify themselves in the bus
  • What are D-Bus objects, interfaces, methods and properties
  • D-Bus type system, basic value types
  • Examples with cli tools
  • Example with Python
  • Useful tools to work or experiment with D-Bus

https://discussion.fedoraproject.org/t/article-proposal-d-bus-overview/99918


Metadata Update from @rlengland:
- Issue assigned to ihuguet
- Issue tagged with: article, needs-image

a year ago

Hi! The article is mostly ready, it would be great to get a review now.

https://fedoramagazine.org/?p=39479&preview=true&preview_id=39479

Some things I would need some help with:
1. Review that the image attributions are OK. 2 of them are from Wikipedia, I have maintained the attribution text on them but I don't know if that's enough to respect the license.
2. I really don't know how to fill the SEO fields. I could put whatever I think it's OK, but I don't know what the best practices are.
3. In some of the sections I've put, at the end, a text in italics which I had conceived it as additional explanations to put as "aside" content or something like that. But I don't find anything in the editor to do it. I think it's interesting content so I wouldn't want to remove it. Any suggestion?
4. Is it possible to have some code highlighting? At least for the Python example would be a very good improvement.

Thanks!

Hi Íñigo:

I just skimmed your article. At a glance, it looks very good. I don't see any significant problems with it.

  1. Review that the image attributions are OK. 2 of them are from Wikipedia, I have maintained the attribution text on them but I don't know if that's enough to respect the license.

The image attributions are good.

  1. I really don't know how to fill the SEO fields. I could put whatever I think it's OK, but I don't know what the best practices are.

An editor will take care of that as part of the publication process. You don't need to worry about it.

  1. In some of the sections I've put, at the end, a text in italics which I had conceived it as additional explanations to put as "aside" content or something like that. But I don't find anything in the editor to do it. I think it's interesting content so I wouldn't want to remove it. Any suggestion?

What you've done looks good to me.

  1. Is it possible to have some code highlighting? At least for the Python example would be a very good improvement.

Someone did that in their article once. IIRC, they used some external tool that converted the code to HTML and then pasted the raw HTML into a HTML block on this site. You should be able to do something similar. But I don't remember what tool they used.

One edit I'd suggest (it is just a suggestion) is to merge these two paragraphs:

Each of these interfaces define some properties and methods. Properties are like variables and methods are like functions.

Remark: D-Bus objects don’t have direct properties and methods. They implement one or more interfaces, and each interface has the properties and methods.

I'd suggest the following instead:

D-Bus objects implement one or more interfaces. Each interface has properties and methods. Properties are like variables and methods are like functions. D-Bus objects do not have direct properties and methods.

Metadata Update from @rlengland:
- Custom field preview-link adjusted to https://fedoramagazine.org/?p=39479&preview=true

a year ago
  1. Is it possible to have some code highlighting? At least for the Python example would be a very good improvement.

I just checked and it looks like this site does have a "CodeColorer" plugin installed. It is powered by GeSHi.

https://kpumuk.info/projects/wordpress-plugins/codecolorer/#faq

I have used a tool for the code syntax highlight and looks much better now.

I have also edited the paragraphs that you mention. Instead, I have merged them and the previous one into only 2 paragraphs. Now they look like this, I hope it is clearer:

Each D-Bus object implements one or more D-Bus interfaces and each interface defines some properties and methods. Properties are like variables and methods are like functions. The names of D-Bus interfaces look like “org.example.AppName.InterfaceName”.

If you already know any programming language that uses the concept of interface, like Java, this will be familiar to you. If you are not, just think that interfaces are like types for the objects and each object can have more than one type at the same time. But remember that, unlike what happens in many of these languages, D-Bus objects never define direct members, only the interfaces do.

... Now they look like this, I hope it is clearer ...

Yes, I think that is much better. 🙂

The dimensions of the cover image may need adjusting, but the editors can probably take care of that. I think your article is good-to-go now. Thanks!

Metadata Update from @rlengland:
- Custom field editor adjusted to rlengland
- Custom field publish adjusted to 2023-12-25
- Issue untagged with: needs-image

a year ago

Issue status updated to: Closed (was: Open)
Issue close_status updated to: published

a year ago

Log in to comment on this ticket.

Metadata
Boards 1
articles Status: published